OpenClaw 原版和汉化版windows 和Linux 下的部署实践

简介

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是多少