跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 中文发行版部署指南：npm/Docker 多模式安装与配置

OpenClaw 是一款开源个人 AI 助手平台，支持通过聊天软件与 AI 交互。介绍其汉化中文发行版的部署方法，涵盖 Node.js 环境配置、npm 及 Docker 三种安装模式，重点解决远程访问认证问题及常见故障排查，实现本地或服务器上的全中文界面使用。

微码行者发布于 2026/3/22更新于 2026/8/2346 浏览
OpenClaw 中文发行版部署指南：npm/Docker 多模式安装与配置

什么是 OpenClaw

OpenClaw（曾用名 Clawdbot / Moltbot）是一个开源的个人 AI 助手平台，支持通过 WhatsApp、Telegram、Discord 等聊天软件与 AI 交互。简单来说，就是在你自己的机器上运行一个 AI 助手，通过常用聊天软件跟它对话。

汉化中文版 OpenClaw 界面预览

原版是全英文的，社区伙伴做了一个中文发行版，主要特点如下：

特点说明
开箱即用npm 一键安装 / Docker 一键部署，不需要手动打补丁
实时同步每小时自动从官方仓库拉取最新代码并构建
双版本stable（稳定版）和 nightly（最新版）可选
深度汉化CLI + Dashboard 全中文界面

项目地址：GitHub - OpenClawChinese

汉化效果预览

Dashboard 界面已全中文，概览仪表板、对话界面、渠道管理、配置中心等模块均已完成本地化适配。

概览仪表板

对话界面

渠道管理

配置中心

节点配置

技能插件

环境要求

项目要求
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

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

手动安装：npm

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

# 稳定版（推荐）
npm install -g @qingchencloud/openclaw-zh@latest

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

验证安装：

openclaw --version
openclaw --help

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

服务器推荐：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

这是一个交互式向导，会引导你完成：

  1. 选择 AI 模型：支持 Claude、GPT、本地模型等
  2. 配置 API Key：根据选择的模型输入对应的 API Key
  3. 设置聊天通道：可以连接 WhatsApp、Telegram 等
  4. 创建助手人格：给你的 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 远程访问
场景访问地址配置复杂度
本机运行，本机访问http://localhost:18789简单
服务器运行，远程访问http://服务器 IP:18789需要额外配置

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

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：

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

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

远程访问报 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 连接。

allowInsecureAuth 配置不生效

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

package: 拉取 Docker 镜像…Error response

如果遇到拉取镜像失败，可能是镜像地址变更或网络问题。建议检查镜像源是否可用，或尝试更换国内镜像加速。

常见问题

Q：安装后运行还是英文？

可能安装了原版。先卸载再安装中文版：

npm uninstall -g openclaw
npm install -g @qingchencloud/openclaw-zh@latest
Q：Dashboard 打不开？
  1. 确认容器在运行：docker ps
  2. 确认端口没被占用：netstat -tlnp | grep 18789
  3. 查看容器日志：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 认证，还有其他方案：

方案说明适用场景
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。官方发布新功能后，中文版最快 1 小时内可用。

总结

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

项目地址：GitHub - OpenClawChinese

目录

  1. 什么是 OpenClaw
  2. 汉化效果预览
  3. 环境要求
  4. Linux/macOS
  5. Windows 用 nvm-windows
  6. https://github.com/coreybutler/nvm-windows
  7. 安装方式
  8. 新手推荐：一键脚本
  9. 手动安装：npm
  10. 稳定版（推荐）
  11. 或者 nightly 版（每小时同步上游最新代码）
  12. 服务器推荐：Docker 部署
  13. 1. 初始化配置
  14. 2. 启动
  15. 首次配置
  16. 运行初始化向导
  17. 安装守护进程（可选）
  18. 常用命令速查
  19. Docker 服务器部署详解
  20. 本地访问 vs 远程访问
  21. 方式 1：一键部署脚本（推荐）
  22. 自动生成 Token
  23. 或者指定 Token
  24. 仅本地访问（不配置远程）
  25. 方式 2：手动配置步骤
  26. 1. 创建数据卷
  27. 2. 初始化
  28. 3. 配置网关模式
  29. 4. 配置远程访问（允许局域网访问）
  30. 5. 设置访问令牌（重要！远程访问必须）
  31. 6. 启动容器
  32. 方式 3：Docker Compose
  33. 启动容器（首次会自动创建卷）
  34. 初始化配置
  35. 远程访问配置（可选）
  36. 重启生效
  37. 踩坑记录
  38. 挂载路径错误
  39. 错误（配置不会持久化）
  40. 正确
  41. 必须先初始化再启动
  42. 远程访问报 1008 错误
  43. 容器已运行的情况下
  44. allowInsecureAuth 配置不生效
  45. package: 拉取 Docker 镜像…Error response
  46. 常见问题
  47. Q：安装后运行还是英文？
  48. Q：Dashboard 打不开？
  49. Q：Docker 重启后配置丢失？
  50. Q：如何更新到最新版？
  51. npm 安装
  52. Docker
  53. 重新启动（配置保留在数据卷中）
  54. Q：如何彻底卸载？
  55. 卸载 npm 包
  56. 删除配置文件（可选，会删除所有数据）
  57. Docker 方式
  58. 其他远程访问方案
  59. 常用 Docker 命令
  60. 查看日志
  61. 重启服务
  62. 停止服务
  63. 进入容器
  64. 查看当前配置
  65. 版本说明
  66. 总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • VR + 具身智能 + 人形机器人：通往现实世界的智能接口
  • DataX-web 安装与使用指南
  • VSCode Copilot 在 Win10 WSL2 环境下连接失败排查
  • eNSP 基础网络配置命令速查指南
  • GitHub Copilot 安装配置与核心功能详解
  • 网络安全专业就业前景与职业发展深度解析
  • 昇腾 Ascend C 算子开发：从语法基础到全链路编程实践
  • OpenClaw 开源 AI 智能体部署指南：Discord 与微信接入配置
  • C/C++ 算法入门：一维动态规划基础实战
  • 205. 同构字符串 - Java 解法与优化
  • 2026 年 3 月大模型全景解析：国产登顶、百万上下文落地与 Agent 工业化
  • 系统接收多种报文时，如何避免 if-else 地狱？策略与工厂模式实战
  • MC.JS WEBMC1.8 与传统 JavaScript 开发效率对比
  • 基于 DeepSeek 与 Cursor 构建智能代码审查系统实战
  • Ubuntu 下安装 OpenClaw 并配置安全访问
  • C++ STL 详解：从零实现 vector 容器
  • Git 常用操作详解：从安装到分支管理
  • Linux kill 命令用法及常用信号解析
  • AI 工具快速生成 PPT 与动漫风格漫画
  • WAN2.2 极速视频 AI 重塑 AIGC 视频生产流程

相关免费在线工具

  • 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