跳到主要内容
OpenClaw 开源个人 AI 助手部署指南:一键脚本 Docker npm 安装与中文配置 | 极客日志
JavaScript Node.js AI
OpenClaw 开源个人 AI 助手部署指南:一键脚本 Docker npm 安装与中文配置 OpenClaw 是一款支持多聊天平台的开源个人 AI 助手平台。介绍其汉化中文版的部署方法,涵盖 Node.js 环境配置、三种安装方式(一键脚本、npm 手动安装、Docker 部署)。重点讲解服务器远程访问的 Token 认证配置及 Web Crypto API 限制解决方案。包含初始化向导流程、常用命令速查、常见故障排查(如挂载路径错误、镜像拉取失败)及版本更新卸载说明。适合希望在本地或服务器运行私有化 AI 助手的开发者参考。
星辰大海 发布于 2026/3/15 更新于 2026/4/25 4 浏览技能插件 - 1Password、Apple Notes 等丰富扩展:
环境要求 项目 要求 Node.js >= 22.12.0(必须) Docker 可选,服务器部署推荐 网络 需要能访问 AI 模型 API
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
安装方式
方式 A:一键脚本(推荐新手) curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.sh && bash install.sh
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
npm install -g @qingchencloud/openclaw-zh@nightly
openclaw --version
openclaw --help
方式 C:Docker 部署(服务器推荐) 在服务器上运行,或者不想污染本地环境,用 Docker。
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
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。
首次配置
运行初始化向导
选择 AI 模型 :支持 Claude、GPT、本地模型等
配置 API Key :根据选择的模型输入对应的 API Key
设置聊天通道 :可以连接 WhatsApp、Telegram 等
创建助手人格 :给你的 AI 起个名字,设置性格
安装守护进程(可选) openclaw onboard --install-daemon
常用命令速查 openclaw
openclaw onboard
openclaw config
openclaw config set key val
openclaw skills
openclaw status
openclaw gateway run
Docker 服务器部署详解 这部分重点讲一下在服务器上部署并远程访问的配置,因为这里坑比较多。
本地访问 vs 远程访问 场景 访问地址 配置复杂度 本机运行,本机访问 http://localhost:18789简单 服务器运行,远程访问 http://服务器 IP:18789需要额外配置
OpenClaw 的 Dashboard 使用 Web Crypto API 进行设备身份验证,这个 API 在非 HTTPS 环境下只能在 localhost 使用。简单说就是:通过 HTTP 远程访问时,浏览器安全策略会阻止认证 。
方式 1:一键部署脚本(推荐) 项目提供了一键部署脚本,自动完成环境检测、初始化、配置远程访问:
curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash
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 认证)
启动容器
方式 2:手动配置步骤
docker volume create openclaw-data
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
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token 你的密码
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
常见问题
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 update -g @qingchencloud/openclaw-zh
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 uninstall -g @qingchencloud/openclaw-zh
rm -rf ~/.openclaw
docker stop openclaw && docker rm openclaw
docker volume rm openclaw-data
其他远程访问方案 方案 说明 适用场景 Token 认证 设置 gateway.auth.token,Dashboard 输入连接 内网,最简单 SSH 端口转发 ssh -L 18789:127.0.0.1:18789 user@server更安全 Tailscale Serve 自动提供 HTTPS 跨网络访问 Nginx 反向代理 + HTTPS 配置 SSL 证书 生产环境
常用 Docker 命令
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。
总结 这个中文发行版会每小时自动同步上游更新,功能和官方保持一致,界面是中文的,开箱即用。
如果使用过程中遇到问题,可以在 GitHub 仓库提 Issue。也欢迎有兴趣的开发者参与贡献。
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
随机西班牙地址生成器 随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online
Keycode 信息 查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
Escape 与 Native 编解码 JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
JavaScript / HTML 格式化 使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online