简介
OpenClaw（曾用名：Clawdbot、Moltbot），一款可以部署在个人电脑上的AI代理，采用“龙虾”图标设计，slogan是“The AI that actually does things”，由程序员彼得·斯坦伯格开发。 核心开发语言为TypeScript，
是一个采用“龙虾”图标设计的开源AI智能体项目。该项目定位为个人AI代理，具备操作软件与长期记忆功能。2026年1月，特斯拉前AI主管Karpathy曾公开提及此项目。
- 官方版本:https://github.com/openclaw/openclaw
- 官方文档：https://docs.openclaw.ai/zh-CN
- 汉化版：https://github.com/jiulingyun/openclaw-cn
- 汉化版官网:https://clawd.org.cn/
一.nodejs 安装
1.1 windows 下安装nodejs
- 下载node-v24.13.0-win-x64.zip，下载地址：https://nodejs.org/en/download
- 解压到"D:\tools"下,完整路径:"D:\tools\node-v24.13.0-win-x64"
- 设置环境变量：此电脑-->右击-->属性-->高级系统设置-->系统变量，新建，变量名：NODE_HOME，变量值：D:\tools\node-v24.13.0-win-x64。系统变量里找到Path,然后进行编辑：新建，然后输入：D:\tools\node-v24.13.0-win-x64
- 打开powershell，执行
node -v和npm -v有出现版本表示安装成功. - 设置镜像源：
npm config set registry https://registry.npmmirror.com/ - 设置nodejs的缓存地址和安装包目录:
npm config set prefix "D:\tools\node_global"
npm config set cache "D:\tools\node_cache"
- 系统变量里找到Path,然后进行编辑：新建，然后输入：
D:\tools\node_global - 在powershell 中执行命令升级npm，
npm install -g npm@latest
1.2 ubuntu下安装 nodejs
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
npm -v
npm install -g npm@latest
二. 安装openclaw
2.1 安装原版openclaw
# 安装
npm install -g openclaw@latest #安装完成后参考openclaw配置 向导
# 运行安装向导
openclaw onboard --install-daemon
# 启动网关
openclaw gateway --port 18789 --verbose
2.2 安装汉化版openclaw-cn
# 安装
npm install -g openclaw-cn@latest #安装完成后参考openclaw配置 向导
# 运行安装向导
openclaw-cn onboard --install-daemon
# 启动网关
openclaw-cn gateway --port 18789 --verbose
三. openclaw配置向导
执行命令：openclaw-cn onboard --install-daemon 开始配置向导,设置向导的过程中通过：上下左右方向键：进行选择，空格键：表示勾选，回车键：表示确定。此处向导以汉化版为例，原版英文的格式和选择基本相同。
1.通过左右方向键选择yes，然后回车
2.通过上下箭头，选择快速启动
3.选择使用的模型厂商，此处我选择了阿里云百炼【需要提前在阿里云申请apikey】，建议选择Qwen,选择Qwen后会提示在浏览器打开URL进行登录验证，验证通过即可。
4.输入百炼的apiKey，选择Qwen后会提示在浏览器打开URL进行登录验证，登录验证通过即可。
5.模型选择，保持默认即可
6.通道选择：暂时跳过
7.技能配置：YES
8.技能安装管理器：npm
- 通过空格键 勾选“暂时跳过”，然后回车
10.这是安装完的提示，图中的127.0.0.1的URL复制出来，然后查看windows 当前登录用户目录下的".openclaw\openclaw.json" 中的token，token在json中的gateway.auth.token位置。将该token复制出来替换掉http://127.0.0.1:18789/?token=后边的值，然后在浏览器打开
四.浏览器访问
4.1 浏览器打开界面
在浏览器打开网址：
http://127.0.0.1:18789/?token=b6b6921ce061e056dd5c7f779ed05e4a6fcd3b95e4cfaecd，如果显示已连接表示正常，否则就检测token是否对得上
4.2 测试创建一个文件
输入一个问题进行测试：创建一个readme.txt
4.3 验证创建的文件
输入测试，测试上一个步骤创建的文件
五. 常见问题
5.1 配置nginx 反向代理到openclaw
nginx配置:
server { listen 80; server_name your-domain.com; location / { proxy_pass http://127.0.0.1:18789; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_read_timeout 86400; } }- 配置 Openclaw
编辑 ~/.openclaw/openclaw.json，然后增加一行：
"trustedProxies": ["127.0.0.1"],
{
gateway: {
// 绑定到本地，由 Nginx 代理
bind: "loopback",
port: 18789,
// 配置信任的代理地址
trustedProxies: ["127.0.0.1"],
// 启用认证（推荐）
auth: {
mode: "token",
token: "your-secure-token-here"
}
}
}
- 重新启动：
openclaw-cn gateway
5.2 Web UI 显示 "disconnected (1008): pairing required" 错误
解决方法：
原版执行：
openclaw config set gateway.controlUi.allowInsecureAuth true
openclaw gateway restart
汉化版执行：
openclaw-cn config set gateway.controlUi.allowInsecureAuth true
openclaw-cn gateway restart
5.3 disconnected (1008): control ui requires HTTPS or localhost (secure context)
解决方法：需要给nginx 配置https证书
5.4 disconnected (1008): unauthorized: gateway token mismatch (open a tokenized dashboard URL or paste token in Control UI settings)
解决方法：重新打开 ~/.openclaw/openclaw.json 配置查看token是多少
