目录

​编辑

前言：为什么你需要 OpenClaw？

一、准备工作：工欲善其事

1.1 环境要求

1.2 心理建设

二、安装步骤：手把手教学

2.1 全局安装 OpenClaw

2.2 创建工作区

2.3 配置模型

2.4 启动网关

2.5 连接消息平台（可选但推荐）

三、验证与调试

3.1 检查状态

3.2 常见问题排查

四、进阶玩法

结语

---

前言：为什么你需要 OpenClaw？

嘿，各位技术圈的新朋友们！我是攀哥，一个在代码世界里摸爬滚打多年的老兵。今天咱们不聊高深的架构，不谈复杂的算法，就来聊聊怎么让你的AI助手从"云端神仙"变成"贴身管家"。

OpenClaw 是什么？简单说，它就是一个AI代理运行框架。你可以把它理解成一个"中间人"——一边连着各种大模型（比如Qwen、Claude），一边连着你的聊天工具（微信、Telegram、Discord等）。有了它，你的AI助手就能真正融入你的日常工作流，而不是只能待在网页里跟你有一搭没一搭地聊天。

一、准备工作：工欲善其事

1.1 环境要求

在开始之前，咱们得确保你的电脑准备好了：

• Node.js：这是JavaScript的运行时环境。你可以把它想象成"让JS代码能跑的发动机"。访问 https://nodejs.org 下载LTS版本（推荐v20以上）。安装完后，打开命令行输入 node -v，能看到版本号就说明OK了。

• npm：这是Node.js的包管理器，随Node.js一起安装。它的作用类似于手机的"应用商店"，帮你安装各种开源库。

• API密钥：这是你访问大模型的"门票"。如果你用Qwen，去阿里云百炼平台申请；如果用Claude，去Anthropic官网。没有这个，AI助手就是个没脑子的空壳。

1.2 心理建设

部署过程可能会遇到各种报错，这太正常了！攀哥当年第一次部署时，光是环境配置就折腾了一下午。记住：报错不是你的错，是电脑在跟你沟通。耐心看错误信息，大概率能自己解决。

二、安装步骤：手把手教学

2.1 全局安装 OpenClaw

打开你的命令行工具（Windows用PowerShell或CMD，Mac/Linux用Terminal），输入：

npm install -g openclaw

这里的 -g 参数意思是"全局安装"，装完后你可以在任何目录下使用 openclaw 命令。安装过程可能需要几分钟，取决于你的网络速度。如果卡住了，试试切换npm镜像源：

npm config set registry https://registry.npmmirror.com

2.2 创建工作区

找一个你喜欢的目录，比如 D:\projects\my-claw，然后执行：

mkdir my-claw-workspace
cd my-claw-workspace
openclaw init

openclaw init 会初始化一个工作区，生成一些配置文件。这个工作区就是你的AI助手的"家"，它的记忆、技能、配置都存放在这里。

2.3 配置模型

OpenClaw 支持多种模型，你需要告诉它用哪个。有两种方式：

方式一：环境变量（推荐）

# Windows PowerShell
$env:OPENCLAW_MODEL="qwen-portal/coder-model"
$env:OPENCLAW_API_KEY="你的API密钥"

# Mac/Linux
export OPENCLAW_MODEL="qwen-portal/coder-model"
export OPENCLAW_API_KEY="你的API密钥"

方式二：配置文件

在工作区根目录创建 .env 文件，写入：

OPENCLAW_MODEL=qwen-portal/coder-model
OPENCLAW_API_KEY=你的API密钥

2.4 启动网关

网关是OpenClaw的核心服务，负责处理消息路由、会话管理等。启动它：

openclaw gateway start

如果看到类似 "Gateway started on port XXXX" 的提示，说明成功了！按 Ctrl+C 可以停止。

2.5 连接消息平台（可选但推荐）

只用网页聊天多没意思啊！让AI助手进驻你的常用聊天工具：

• WhatsApp：执行 openclaw connect whatsapp，会显示一个二维码，用手机WhatsApp扫码即可绑定。
• Telegram：先在BotFather创建bot，获取token，然后执行 openclaw connect telegram。
• Discord：需要创建Discord应用，配置bot权限后填入token。

三、验证与调试

3.1 检查状态

openclaw status

这个命令会显示当前运行状态、模型信息、token使用情况等。养成定期检查的习惯。

3.2 常见问题排查

问题	可能原因	解决方案
命令找不到	Node.js未安装或PATH未配置	重新安装Node.js，重启终端
API密钥错误	密钥填写错误或过期	检查密钥，重新申请
端口被占用	其他程序占用了默认端口	修改config中的端口配置
中文乱码	终端编码问题	设置终端为UTF-8编码

四、进阶玩法

部署只是第一步，接下来你可以：

1. 定制人格：编辑 SOUL.md 文件，定义你的AI助手的性格和语气
2. 开发技能：创建自定义技能，让AI能执行特定任务
3. 多会话管理：同时运行多个AI助手，各司其职

结语

好了，今天的教程就到这里！如果遇到问题，欢迎在评论区留言，攀哥会尽量解答。记住，技术没有捷径，但有方法——多动手、多踩坑、多总结，你也能成为部署高手！

下一篇咱们聊聊《如何给你的AI助手定制独特人格》，敬请期待！🦞