简介

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

1. 下载node-v24.13.0-win-x64.zip，下载地址：https://nodejs.org/en/download
2. 解压到"D:\tools"下,完整路径:“D:\tools\node-v24.13.0-win-x64”
3. 设置环境变量：此电脑–>右击–>属性–>高级系统设置–>系统变量，新建，变量名：NODE_HOME，变量值：D:\tools\node-v24.13.0-win-x64。系统变量里找到Path,然后进行编辑：新建，然后输入：D:\tools\node-v24.13.0-win-x64
4. 打开powershell，执行node -v和npm -v 有出现版本表示安装成功.
5. 设置镜像源：npm config set registry https://registry.npmmirror.com/
6. 设置nodejs的缓存地址和安装包目录:

npm config set prefix "D:\tools\node_global"
npm config set cache "D:\tools\node_cache"

7. 系统变量里找到Path,然后进行编辑：新建，然后输入：D:\tools\node_global
8. 在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

9. 通过空格键 勾选“暂时跳过”，然后回车

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

1. 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;
    }
}

2. 配置 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"
    }
  }
}

3. 重新启动：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是多少