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

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

（一）汉化版核心亮点

特点	详细说明
全中文适配	CLI命令行14个模块、Dashboard31个配置分区、300+配置项完整汉化，操作无语言障碍
实时同步上游	每小时自动从OpenClaw官方仓库拉取最新代码构建，功能与官方保持一致，最快1小时同步新特性
双版本可选	stable稳定版（手动发布，经过严格测试）、nightly最新版（实时同步，适合尝鲜）
多部署模式	支持一键脚本（新手推荐）、NPM手动安装、Docker容器部署（服务器首选），适配不同使用场景
多模型支持	兼容OpenAI GPT、Claude、本地模型（通过Ollama运行Llama/Mistral等），有API Key即可快速接入
多渠道交互	支持WhatsApp、Telegram、Discord、Signal、iMessage等主流聊天软件接入，灵活触发AI任务

（二）环境前置要求

操作系统：Ubuntu 22.04/24.04 LTS（推荐）、Linux/macOS（支持命令行部署）、Windows（需PowerShell环境）；
核心依赖：Node.js ≥22.12.0（必须，运行OpenClaw核心服务）；
可选依赖：Docker ≥20.10.0（容器部署推荐）、Docker Compose ≥2.25.0（集群部署使用）；
网络环境：需能访问AI模型API（如OpenAI/Claude接口），服务器部署需开放18789端口；
硬件配置：本地部署推荐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
# 重启终端或执行以下命令加载nvm
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
# 安装并切换到Node.js 22
nvm 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
阿里云轻量应用服务器部署OpenClaw1.png
阿里云轻量应用服务器部署OpenClaw2.png
选购阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

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

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

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼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

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

选择AI提供商（如OpenAI、Claude、本地模型等）；
输入对应API Key（本地模型无需填写）；
设置聊天通道（可选绑定WhatsApp、Telegram等）；
自定义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. 访问Dashboard
echo "访问地址：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：进阶安全方案（生产环境）

方案	配置命令/步骤	适用场景	安全等级
SSH端口转发	本地终端执行： `ssh -L 18789:127.0.0.1:18789 用户@服务器IP`	个人使用/小团队	高
Tailscale Serve	1. 服务器与本地设备安装Tailscale； 2. 加入同一Tailnet网络； 3. 启用HTTPS访问	跨网络安全访问	极高
Nginx反向代理+HTTPS	1. 安装Nginx； 2. 配置SSL证书； 3. 反向代理18789端口	企业级生产环境	极高

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 true
openclaw 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

（六）其他常见问题

安装后运行仍是英文：误装了原版，卸载后重新安装中文版：
```
npm uninstall -g openclaw
npm install -g @qingchencloud/openclaw-zh@latest
```
Dashboard打不开：
- 检查容器是否运行：docker ps | grep openclaw；
- 检查端口是否占用：netstat -tlnp | grep 18789；
- 查看日志定位错误：docker logs openclaw。
如何彻底卸载：
```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

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

个人本地使用：选择「一键脚本部署」+「稳定版」，简单高效，无需复杂配置；
小团队协作：选择「Docker部署」+「Token远程访问」，配置统一管理，支持多成员共享；
企业生产环境：选择「Docker Compose」+「Nginx反向代理+HTTPS」，保障安全性与高可用性；
功能尝鲜需求：切换至「nightly最新版」，第一时间体验官方新功能，但不建议用于核心业务；
技能扩展建议：优先安装email（邮件管理）、summarize（文档摘要）、agent-browser（网页自动化）等高频技能，覆盖80%日常场景。

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

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

2026年OpenClaw（Clawdbot）汉化中文版全场景部署指南：一键脚本+Docker+npm三模式适配

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

（一）汉化版核心亮点

（二）环境前置要求

（三）Node.js环境预处理

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

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

1. Linux/macOS系统

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

3. 脚本自动执行流程

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

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

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

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

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

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

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

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

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

（一）核心配置命令

（二）Docker常用命令

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

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

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

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

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

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

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

（六）其他常见问题

NPM安装方式卸载

Docker安装方式卸载

拉取最新镜像

停止并删除旧容器

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

七、总结与最佳实践

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

2026年OpenClaw（Clawdbot）汉化中文版全场景部署指南：一键脚本+Docker+npm三模式适配

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

（一）汉化版核心亮点

（二）环境前置要求

（三）Node.js环境预处理

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

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

1. Linux/macOS系统

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

3. 脚本自动执行流程

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

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

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

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

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

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

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

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

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

（一）核心配置命令

（二）Docker常用命令

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

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

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

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

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

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

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

（六）其他常见问题

NPM安装方式卸载

Docker安装方式卸载

拉取最新镜像

停止并删除旧容器

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

七、总结与最佳实践

热门文章

最新文章

相关电子书