OpenClaw（曾用名Clawdbot/Moltbot）作为GitHub星标120k+的开源个人AI助手平台，凭借“本地运行+多渠道交互+任务执行”的核心优势，成为AI工具领域的热门选择。其支持通过WhatsApp、Telegram、Discord等聊天软件触发邮件管理、日历规划、网页操作等实际任务，真正实现“聊天即操作”。但原版全英文界面给中文用户带来了使用门槛，开源社区推出的第三方汉化中文版完美解决这一问题——CLI命令行与Dashboard网页控制台深度汉化，每小时自动同步官方最新代码，提供稳定版与开发版双选择，开箱即用无需手动打补丁。本文将详细拆解Ubuntu环境配置、一键脚本/NPM/Docker三种部署方式、远程访问配置、常见问题排查等全流程，包含完整代码命令与实操技巧，新手也能零失误完成部署。

一、汉化中文版核心优势与环境要求

（一）汉化版核心亮点

（二）环境前置要求

1. 操作系统：Ubuntu 22.04/24.04 LTS（推荐）、Linux/macOS（支持命令行部署）、Windows（需PowerShell环境）；

2. 核心依赖：Node.js ≥22.12.0（必须，运行OpenClaw核心服务）；

3. 可选依赖：Docker ≥20.10.0（容器部署推荐）、Docker Compose ≥2.25.0（集群部署使用）；

4. 网络环境：需能访问AI模型API（如OpenAI/Claude接口），服务器部署需开放18789端口；

5. 硬件配置：本地部署推荐2核4G以上，服务器部署推荐4核8G（支持多技能同时运行）。

（三）Node.js环境预处理

无论选择哪种部署方式，均需先确保Node.js版本符合要求：

# 检查当前Node.js版本node -v# 输出需为v22.x.x及以上，否则执行以下步骤升级# Linux/macOS通过nvm安装Node.js 22（推荐，不污染系统环境）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash# 重启终端或执行以下命令加载nvmexport NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"# 安装并切换到Node.js 22nvm install 22
nvm use 22# Windows系统安装nvm-windows（参考链接：https://github.com/coreybutler/nvm-windows）# 安装完成后执行：nvm install 22
nvm use 22

注意：同学们若觉得这个OpenClaw部署的流程有点复杂，阿里云上线了OpenClaw一键部署功能，怕麻烦的同学可以 访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】，开箱即用！

阿里云OpenClaw一键部署专题教程页面：https://www.aliyun.com/activity/ecs/clawdbot


选购阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）

• 实例：内存必须2GiB及以上。

• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。

• 时长：根据自己的需求及预算选择。
  

访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。

• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。

• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。

• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

二、三种部署方式详细教程（从易到难）

（一）方式A：一键脚本部署（新手首选）

无需手动配置依赖，脚本自动完成环境检测、安装、初始化全流程，支持Linux/macOS/Windows三大系统：

1. Linux/macOS系统

# 下载并执行一键安装脚本curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.sh && bash install.sh

2. Windows PowerShell系统（以管理员身份运行）

# 下载并执行安装脚本Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.ps1" -OutFile "install.ps1"; .\install.ps1

3. 脚本自动执行流程

• 检测Node.js版本，低于22.x.x则提示升级；

• 自动安装中文版NPM包（默认stable稳定版）；

• 运行初始化配置向导，引导选择AI模型与API Key；

• 启动OpenClaw服务，输出Dashboard访问地址与默认Token。

（二）方式B：NPM手动安装（灵活可控）

适合熟悉命令行操作的用户，可自主选择版本，便于后续自定义配置：

# 安装稳定版（推荐日常使用）npm install -g @qingchencloud/openclaw-zh@latest# 或安装nightly最新版（每小时同步上游，含最新功能）npm install -g @qingchencloud/openclaw-zh@nightly# 验证安装结果（输出中文说明即为成功）openclaw --version
openclaw --help# 运行初始化向导（中文交互式配置）openclaw onboard

初始化向导将引导完成以下关键配置：

1. 选择AI提供商（如OpenAI、Claude、本地模型等）；

2. 输入对应API Key（本地模型无需填写）；

3. 设置聊天通道（可选绑定WhatsApp、Telegram等）；

4. 自定义AI助手人格（名称、性格、响应风格）。

（三）方式C：Docker部署（服务器推荐）

容器化部署隔离系统环境，支持开机自启，配置持久化，是服务器生产环境的最优选择：

1. 快速启动（本地访问）

# 1. 初始化配置（创建数据卷存储配置文件）docker run --rm -v openclaw-data:/root/.openclaw \
  ghcr.io/1186258278/openclaw-zh:nightly openclaw setup# 2. 配置网关模式为本地访问docker run --rm -v openclaw-data:/root/.openclaw \
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode local# 3. 启动容器（映射18789端口，后台运行）docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/root/.openclaw \
  --restart unless-stopped \
  ghcr.io/1186258278/openclaw-zh:nightly \
  openclaw gateway run# 4. 访问Dashboardecho "访问地址：http://localhost:18789"

2. Docker Compose集群部署（多服务协同）

# 1. 下载Docker Compose配置文件curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-compose.yml -o docker-compose.yml# 2. 启动容器（首次启动自动创建数据卷）docker-compose up -d# 3. 初始化配置（进入容器执行）docker-compose exec openclaw openclaw setup
docker-compose exec openclaw openclaw config set gateway.mode local# 4. 重启容器使配置生效docker-compose restart

Docker Compose配置文件核心内容解析：

version: '3.8'services:
  openclaw:
    image: ghcr.io/1186258278/openclaw-zh:nightly # 汉化版镜像
    container_name: openclaw # 容器名称
    ports:
      - "18789:18789" # 端口映射（主机:容器）
    volumes:
      - openclaw-data:/root/.openclaw # 配置持久化数据卷
    environment:
      - OPENCLAW_GATEWAY_TOKEN=${
   OPENCLAW_GATEWAY_TOKEN:-} # 环境变量传参
    restart: unless-stopped # 异常自动重启
    command: openclaw gateway run --allow-unconfigured # 启动命令volumes:
  openclaw-data:
    name: openclaw-data # 命名数据卷（便于管理）

三、服务器远程访问配置（重点难点）

本地部署可直接通过http://localhost:18789访问，但服务器部署需解决远程访问认证问题——OpenClaw Dashboard使用Web Crypto API进行设备身份验证，非HTTPS环境下仅支持localhost访问，需通过以下方案配置：

（一）方案1：一键部署脚本（推荐，自动配置）

# 方式1：自动生成访问Token（随机密码）curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash# 方式2：指定自定义Token（便于记忆）curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash -s -- --token 你的自定义密码# 方式3：仅本地访问（不配置远程）curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash -s -- --local-only

脚本执行完成后，将输出类似以下信息，复制即可远程访问：

部署成功！
远程访问地址：http://服务器公网IP:18789网关令牌：你的自定义密码
请在Dashboard登录页输入令牌连接

（二）方案2：手动配置远程访问

# 1. 若已启动容器，先停止并删除旧容器docker stop openclaw && docker rm openclaw# 2. 配置允许局域网访问docker run --rm -v openclaw-data:/root/.openclaw \
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan# 3. 设置访问Token（必填，避免1008错误）docker run --rm -v openclaw-data:/root/.openclaw \
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token 你的安全密码# 4. 重新启动容器docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/root/.openclaw \
  --restart unless-stopped \
  ghcr.io/1186258278/openclaw-zh:nightly \
  openclaw gateway run

（三）方案3：进阶安全方案（生产环境）

Nginx反向代理配置示例（HTTPS）：

server {   
    listen 443 ssl;    server_name 你的域名;    # SSL证书配置
    ssl_certificate /etc/nginx/ssl/你的证书.crt;    ssl_certificate_key /etc/nginx/ssl/你的私钥.key;    ssl_protocols TLSv1.2 TLSv1.3;    # 反向代理OpenClaw
    location / {   
        proxy_pass http://localhost:18789;        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;
    }
}

四、关键配置与常用命令速查

（一）核心配置命令

# 查看当前所有配置openclaw config# 修改配置（示例：设置默认AI模型）openclaw config set agents.defaults.model.primary "openai/gpt-4o"# 重置配置（恢复默认值）openclaw config reset# 管理技能插件（查看/安装/卸载）openclaw skills list # 查看已安装技能openclaw skills install email # 安装邮件技能openclaw skills uninstall weather # 卸载天气技能# 查看服务运行状态openclaw status# 启动/停止/重启网关服务openclaw gateway run # 启动openclaw gateway stop # 停止openclaw gateway restart # 重启

（二）Docker常用命令

# 查看容器运行状态docker ps | grep openclaw# 查看实时日志docker logs -f openclaw# 进入容器内部docker exec -it openclaw sh# 查看当前配置文件docker exec openclaw cat /root/.openclaw/openclaw.json# 备份配置数据docker run --rm -v openclaw-data:/source -v $(pwd):/backup alpine tar -zcvf /backup/openclaw-backup.tar.gz -C /source .# 更新Docker镜像（保留配置）docker pull ghcr.io/1186258278/openclaw-zh:nightly
docker stop openclaw && docker rm openclaw
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run

（三）守护进程安装（后台持续运行）

# 安装系统守护进程（支持开机自启）openclaw onboard --install-daemon# 查看守护进程状态（Linux）systemctl status openclaw# 启动/停止/重启守护进程systemctl start openclaw
systemctl stop openclaw
systemctl restart openclaw

五、避坑指南：五大常见问题解决方案

（一）坑1：挂载路径错误导致配置丢失

问题现象：Docker重启后，之前的配置全部失效。
原因：容器以root用户运行，配置文件默认存储在/root/.openclaw，而非/home/node/.openclaw。
解决方案：

# 错误挂载方式（配置不持久化）-v openclaw-data:/home/node/.openclaw# 正确挂载方式（必须使用/root/.openclaw）-v openclaw-data:/root/.openclaw

（二）坑2：未初始化直接启动导致报错

错误提示：Missing config. Run openclaw setup
原因：容器启动前未执行初始化配置，缺少核心配置文件。
解决方案：先执行初始化命令，再启动容器：

docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup

（三）坑3：远程访问报1008错误

错误提示：disconnected (1008): control ui requires HTTPS or localhost
原因：非HTTPS环境下未配置访问Token，浏览器安全策略阻止认证。
解决方案：设置网关Token并重启服务：

# 容器已运行时配置docker exec openclaw openclaw config set gateway.auth.token 你的安全密码
docker restart openclaw

访问时在Dashboard「网关令牌」输入框填入设置的密码即可连接。

（四）坑4：allowInsecureAuth配置不生效

问题现象：单独设置gateway.controlUi.allowInsecureAuth: true后，远程访问仍失败。
原因：该配置存在上游Bug，需配合Token认证一起使用。
解决方案：

# 同时配置两个参数openclaw config set gateway.controlUi.allowInsecureAuth trueopenclaw config set gateway.auth.token 你的安全密码
openclaw gateway restart

（五）坑5：拉取Docker镜像提示权限拒绝

错误提示：Error response from daemon: error from registry: denied
原因：nightly镜像未设置公开可见性。
解决方案：使用公开镜像地址，或更新部署脚本：

# 替换为公开镜像docker pull ghcr.io/1186258278/openclaw-zh:nightly

（六）其他常见问题

1. 安装后运行仍是英文：误装了原版，卸载后重新安装中文版：

   npm uninstall -g openclaw
   npm install -g @qingchencloud/openclaw-zh@latest

2. Dashboard打不开：

• 检查容器是否运行：docker ps | grep openclaw；

• 检查端口是否占用：netstat -tlnp | grep 18789；

• 查看日志定位错误：docker logs openclaw。

3. 如何彻底卸载：
   ```bash

   NPM安装方式卸载

   npm uninstall -g @qingchencloud/openclaw-zh
   rm -rf ~/.openclaw

Docker安装方式卸载

docker stop openclaw && docker rm openclaw
docker volume rm openclaw-data

## 六、版本选择与升级建议### （一）版本对比与选择| 版本类型 | NPM标签 | Docker标签 | 更新频率 | 适用场景 |
|----------|---------|------------|----------|----------|
| 稳定版 | @latest | :latest | 手动发布（1-2周/次） | 日常使用、生产环境 |
| 最新版 | @nightly | :nightly | 每小时自动同步 | 功能尝鲜、开发测试 |### （二）升级方法1. **NPM安装方式升级**：
```bash# 稳定版升级npm update -g @qingchencloud/openclaw-zh# 切换到nightly版npm install -g @qingchencloud/openclaw-zh@nightly

1. Docker安装方式升级：
   ```bash

   拉取最新镜像

   docker pull ghcr.io/1186258278/openclaw-zh:nightly

停止并删除旧容器

docker stop openclaw && docker rm openclaw

启动新容器（配置保留在数据卷中）

docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run
```

七、总结与最佳实践

OpenClaw汉化中文版通过全中文界面、多部署模式、实时同步上游三大核心优势，彻底降低了中文用户的使用门槛。无论是新手用户快速上手，还是企业级服务器部署，都能找到适配的方案。结合实际使用场景，推荐以下最佳实践：

1. 个人本地使用：选择「一键脚本部署」+「稳定版」，简单高效，无需复杂配置；

2. 小团队协作：选择「Docker部署」+「Token远程访问」，配置统一管理，支持多成员共享；

3. 企业生产环境：选择「Docker Compose」+「Nginx反向代理+HTTPS」，保障安全性与高可用性；

4. 功能尝鲜需求：切换至「nightly最新版」，第一时间体验官方新功能，但不建议用于核心业务；

5. 技能扩展建议：优先安装email（邮件管理）、summarize（文档摘要）、agent-browser（网页自动化）等高频技能，覆盖80%日常场景。

汉化项目开源仓库：https ://github.com/MaoTouHU/OpenClawChinese，使用过程中遇到问题可提交Issue反馈，也可参与社区贡献。随着OpenClaw官方功能的持续迭代，汉化版将保持实时同步，为中文用户提供更流畅的AI助手使用体验。

如果需要进一步定制配置（如多模型切换、聊天渠道绑定、技能组合优化），可以提供具体需求，获取针对性指导。