综述由AI生成OpenClaw 是一款支持多聊天平台的开源个人 AI 助手，提供中文汉化版本。了该版本的三种部署方式：一键脚本、npm 手动安装及 Docker 容器化部署。涵盖 Node.js 环境配置、初始化向导流程、远程访问 Token 认证设置以及常见故障排查。重点解决了非 HTTPS 环境下 Dashboard 无法连接、挂载路径错误及配置丢失等问题，帮助用户快速在本地或服务器搭建私有 AI 助手。
OpenClaw（曾用名 Clawdbot / Moltbot）是一个开源的个人 AI 助手平台（GitHub 120k+ Stars），可以通过 WhatsApp、Telegram、Discord 等聊天软件与 AI 交互。简单说就是：在你自己的机器上运行一个 AI 助手，通过常用聊天软件跟它对话。
forks 项目仓库：https://github.com/MaoTouHU/OpenClawChinese
原版是全英文的，开源社区伙伴做了一个中文发行版：
| 特点 | 说明 |
|---|---|
| 开箱即用 | npm 一键安装 / Docker 一键部署，不需要手动打补丁 |
| 实时同步 | 每小时自动从官方仓库拉取最新代码并构建 |
| 双版本 | stable（稳定版）和 nightly（最新版）可选 |
| 深度汉化 | CLI + Dashboard 全中文界面 |
先看看效果，Dashboard 界面全中文：
概览仪表板 - 网关状态、实例监控、快捷操作一目了然：
对话界面 - 与 AI 助手实时交互：
渠道管理 - WhatsApp、Telegram、Discord 等多平台支持：
配置中心 - 30+ 配置项完整汉化：
节点配置 - 执行审批、安全策略管理：
技能插件 - 1Password、Apple Notes 等丰富扩展：
| 项目 | 要求 |
|---|---|
| Node.js | >= 22.12.0（必须） |
| Docker | 可选，服务器部署推荐 |
| 网络 | 需要能访问 AI 模型 API |
检查 Node.js 版本：
node -v # 输出应该是 v22.x.x 或更高
如果版本不够，去 Node.js 官网 下载最新 LTS 版本，或者用 nvm 管理：
# Linux/macOS
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
# Windows 用 nvm-windows
# https://github.com/coreybutler/nvm-windows
提供三种方式，根据自己情况选择。
最简单的方式，下载执行脚本自动完成安装。
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
脚本会自动：
如果脚本有问题，可以手动安装：
# 稳定版（推荐）
npm install -g @qingchencloud/openclaw-zh@latest
# 或者 nightly 版（每小时同步上游最新代码）
npm install -g @qingchencloud/openclaw-zh@nightly
验证安装：
openclaw --version
openclaw --help
如果 --help 输出是中文，说明安装成功。
在服务器上运行，或者不想污染本地环境，用 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
这是一个交互式向导，会引导你完成：
整个过程都是中文界面，跟着提示走就行。
如果希望 OpenClaw 在后台持续运行：
openclaw onboard --install-daemon
openclaw # 启动（交互模式）
openclaw onboard # 初始化向导
openclaw config # 查看配置
openclaw config set key val # 修改配置
openclaw skills # 管理技能插件
openclaw status # 查看运行状态
openclaw gateway run # 启动网关（Dashboard）
这部分重点讲一下在服务器上部署并远程访问的配置，因为这里坑比较多。
| 场景 | 访问地址 | 配置复杂度 |
|---|---|---|
| 本机运行，本机访问 | http://localhost:18789 | 简单 |
| 服务器运行，远程访问 | http://服务器 IP:18789 | 需要额外配置 |
为什么远程访问需要额外配置？
OpenClaw 的 Dashboard 使用 Web Crypto API 进行设备身份验证，这个 API 在非 HTTPS 环境下只能在 localhost 使用。简单说就是：通过 HTTP 远程访问时，浏览器安全策略会阻止认证。
项目提供了一键部署脚本，自动完成环境检测、初始化、配置远程访问：
# 自动生成 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
脚本会自动：
部署完成后会显示访问地址和 Token。
如果想手动控制每一步：
# 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，点击连接即可。
项目提供了 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
分享几个实际踩过的坑：
OpenClaw 容器以 root 用户运行，配置文件在 /root/.openclaw，不是 /home/node/.openclaw。
# 错误（配置不会持久化）
-v openclaw-data:/home/node/.openclaw
# 正确
-v openclaw-data:/root/.openclaw
容器启动前必须先运行 openclaw setup，否则会报错：
Missing config. Run openclaw setup
使用一键脚本或按照上面的步骤顺序执行就不会遇到这个问题。
如果看到这样的错误：
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 连接。
官方文档提到的 gateway.controlUi.allowInsecureAuth: true 配置存在上游 Bug，单独使用不起作用。必须配合 gateway.auth.token 使用。
:package: 拉取 Docker 镜像… Error response from daemon: error from registry: denied
可能安装了原版。先卸载再安装中文版：
npm uninstall -g openclaw
npm install -g @qingchencloud/openclaw-zh@latest
docker psnetstat -tlnp | grep 18789docker logs openclaw检查挂载路径是否正确（应该是 /root/.openclaw），以及是否使用了命名卷而不是匿名卷。
# 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
# 卸载 npm 包
npm uninstall -g @qingchencloud/openclaw-zh
# 删除配置文件（可选，会删除所有数据）
rm -rf ~/.openclaw
# Docker 方式
docker stop openclaw && docker rm openclaw
docker volume rm openclaw-data
除了 Token 认证，还有其他方案：
| 方案 | 说明 | 适用场景 |
|---|---|---|
| Token 认证 | 设置 gateway.auth.token，Dashboard 输入连接 | 内网，最简单 |
| SSH 端口转发 | ssh -L 18789:127.0.0.1:18789 user@server | 更安全 |
| Tailscale Serve | 自动提供 HTTPS | 跨网络访问 |
| Nginx 反向代理 + HTTPS | 配置 SSL 证书 | 生产环境 |
# 查看日志
docker logs -f openclaw
# 重启服务
docker restart openclaw
# 停止服务
docker stop openclaw
# 进入容器
docker exec -it openclaw sh
# 查看当前配置
docker exec openclaw cat /root/.openclaw/openclaw.json
中文发行版提供两个版本：
| 版本 | npm 标签 | Docker 标签 | 更新频率 |
|---|---|---|---|
| 稳定版 | @latest | :latest | 手动发布，经过测试 |
| 最新版 | @nightly | :nightly | 每小时自动同步上游 |
推荐日常使用稳定版，想体验最新功能用 nightly。
官方发布新功能后，中文版最快 1 小时内可用。
这个中文发行版会每小时自动同步上游更新，功能和官方保持一致，界面是中文的，开箱即用。
如果使用过程中遇到问题，可以在 GitHub 仓库提 Issue。也欢迎有兴趣的佬友参与贡献。
微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online