OpenClaw第三方开源汉化中文发行版部署指南与常见问题完全解决方案

个人AI助手正在从云端走向本地，OpenClaw是其中很值得关注的一个开源项目。它最初叫Clawdbot或Moltbot，后来改名OpenClaw，在GitHub上已经收获了120k+星标。最吸引人的一点是：你可以在自己的机器上运行一个AI助手，然后通过平时常用的聊天软件——比如WhatsApp、Telegram、Discord——直接跟它对话。

原版是全英文的，开源社区的朋友们给它做了一个中文发行版，界面全部汉化，开箱即用。

先看看效果——Dashboard界面全中文：

概览仪表板：网关状态、实例监控、快捷操作一目了然。

对话界面：与AI助手实时交互。

渠道管理：WhatsApp、Telegram、Discord等多平台支持。

配置中心：30+配置项完整汉化。

节点配置：执行审批、安全策略管理。

技能插件：1Password、Apple Notes等丰富扩展。

安装方式

提供三种安装方式，根据自己情况选择就好。

方式 A：一键脚本（推荐新手）

最简单的方式，下载执行脚本自动完成安装。

Linux / macOS：

curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.sh && bash install.sh

Windows PowerShell：

Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.ps1" -OutFile "install.ps1"; .install.ps1

脚本会自动：检查Node.js版本、安装中文版npm包、尝试运行初始化配置。

方式 B：npm 手动安装

如果脚本有问题，可以手动安装：

# 稳定版（推荐）
npm install -g @qingchencloud/openclaw-zh@latest
# 或者 nightly 版（每小时同步上游最新代码）
npm install -g @qingchencloud/openclaw-zh@nightly

验证安装：

openclaw --version
openclaw --help

如果 --help 输出是中文，说明安装成功。

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

在服务器上运行，或者不想污染本地环境，用Docker最省心。

快速启动（本地访问）：

# 1. 初始化配置
docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode local
# 2. 启动
docker run -d 
  --name openclaw 
  -p 18789:18789 
  -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly 
  openclaw gateway run

启动后访问 http://localhost:18789 打开Dashboard。

首次配置

安装完成后，需要进行初始化配置。

运行初始化向导：

openclaw onboard

这是一个交互式向导，会引导你完成：选择AI模型（支持Claude、GPT、本地模型等）、配置API Key、设置聊天通道（可以连接WhatsApp、Telegram等）、创建助手人格（给AI起个名字，设置性格）。整个过程都是中文界面，跟着提示走就行。

安装守护进程（可选）：如果希望OpenClaw在后台持续运行，可以加参数：

openclaw onboard --install-daemon

常用命令速查：

openclaw                    # 启动（交互模式）
openclaw onboard            # 初始化向导
openclaw config             # 查看配置
openclaw config set key val # 修改配置
openclaw skills             # 管理技能插件
openclaw status             # 查看运行状态
openclaw gateway run        # 启动网关（Dashboard）

Docker 服务器部署详解

这部分重点讲一下在服务器上部署并远程访问的配置，因为这里坑比较多。

本地访问 vs 远程访问：

为什么远程访问需要额外配置？

OpenClaw的Dashboard使用Web Crypto API进行设备身份验证，这个API在非HTTPS环境下只能在localhost使用。说白了就是：通过HTTP远程访问时，浏览器安全策略会阻止认证。

方式 1：一键部署脚本（推荐）

项目提供了一键部署脚本，自动完成环境检测、初始化、配置远程访问：

# 自动生成 Token
curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash
# 或者指定 Token
curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash -s -- --token 你的密码
# 仅本地访问（不配置远程）
curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash -s -- --local-only

脚本会自动：检查Docker环境、拉取镜像、创建数据卷、初始化配置、配置远程访问（Token认证）、启动容器。部署完成后会显示访问地址和Token。

方式 2：手动配置步骤

如果想手动控制每一步：

# 1. 创建数据卷
docker volume create openclaw-data
# 2. 初始化
docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw setup
# 3. 配置网关模式
docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode local
# 4. 配置远程访问（允许局域网访问）
docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan
# 5. 设置访问令牌（重要！远程访问必须）
docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token 你的密码
# 6. 启动容器
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

访问 http://服务器IP:18789，在「网关令牌」输入框填入你设置的Token，点击连接即可。

方式 3：Docker Compose

项目提供了 docker-compose.yml：

# 下载配置文件
curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-compose.yml -o docker-compose.yml

配置文件内容：

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

首次需要初始化配置：

# 启动容器（首次会自动创建卷）
docker-compose up -d
# 初始化配置
docker-compose exec openclaw openclaw setup
docker-compose exec openclaw openclaw config set gateway.mode local
# 远程访问配置（可选）
docker-compose exec openclaw openclaw config set gateway.bind lan
docker-compose exec openclaw openclaw config set gateway.auth.token 你的密码
# 重启生效
docker-compose restart

踩坑记录

分享几个实际踩过的坑：

坑 1：挂载路径错误

OpenClaw容器以root用户运行，配置文件在 /root/.openclaw，不是 /home/node/.openclaw。

# 错误（配置不会持久化）
-v openclaw-data:/home/node/.openclaw
# 正确
-v openclaw-data:/root/.openclaw

坑 2：必须先初始化再启动

容器启动前必须先运行 openclaw setup，否则会报错：

Missing config. Run openclaw setup

使用一键脚本或按照上面的步骤顺序执行就不会遇到这个问题。

坑 3：远程访问报 1008 错误

如果看到这样的错误：

disconnected (1008): control ui requires HTTPS or localhost
disconnected (1008): device identity required

这是因为没有配置Token。浏览器安全策略阻止了非HTTPS环境下的设备认证。解决方法：设置 gateway.auth.token

# 容器已运行的情况下
docker exec openclaw openclaw config set gateway.auth.token 你的密码
docker restart openclaw

然后在Dashboard的「网关令牌」输入框填入Token连接。

坑 4：allowInsecureAuth 配置不生效

官方文档提到的 gateway.controlUi.allowInsecureAuth: true 配置存在上游Bug，单独使用不起作用。必须配合 gateway.auth.token 使用。

坑 5：package: 拉取 Docker 镜像…Error response

:package: 拉取 Docker 镜像…
Error response from daemon: error from registry: denied
denied
root@racknerd-bbcd572:~# curl -sL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | grep "IMAGE="
IMAGE="ghcr.io/qingchencloud/openclaw-zh:latest"
root@racknerd-bbcd572:~#

常见问题

Q：安装后运行还是英文？
可能安装了原版。先卸载再安装中文版：

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

Q：Dashboard 打不开？
确认容器在运行：docker ps
确认端口没被占用：netstat -tlnp | grep 18789
查看容器日志：docker logs openclaw

Q：Docker 重启后配置丢失？
检查挂载路径是否正确（应该是 /root/.openclaw），以及是否使用了命名卷而不是匿名卷。

Q：如何更新到最新版？

# npm 安装
npm update -g @qingchencloud/openclaw-zh
# 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

Q：如何彻底卸载？

# 卸载 npm 包
npm uninstall -g @qingchencloud/openclaw-zh
# 删除配置文件（可选，会删除所有数据）
rm -rf ~/.openclaw
# Docker 方式
docker stop openclaw && docker rm openclaw
docker volume rm openclaw-data

其他远程访问方案
除了Token认证，还有其他方案：

常用 Docker 命令

# 查看日志
docker logs -f openclaw
# 重启服务
docker restart openclaw
# 停止服务
docker stop openclaw
# 进入容器
docker exec -it openclaw sh
# 查看当前配置
docker exec openclaw cat /root/.openclaw/openclaw.json

版本说明

中文发行版提供两个版本：

推荐日常使用稳定版，想体验最新功能用nightly。官方发布新功能后，中文版最快1小时内可用。

总结

这个中文发行版会每小时自动同步上游更新，功能和官方保持一致，界面是中文的，开箱即用。如果使用过程中遇到问题，可以在GitHub仓库提Issue。也欢迎有兴趣的朋友参与贡献。

来源：互联网