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

OpenClaw 中文发行版部署指南：npm/Docker/脚本三种方式

OpenClaw 是一款支持多平台的开源个人 AI 助手，提供全中文汉化的第三方发行版。本文详细讲解了在 Ubuntu 环境下通过一键脚本、npm 手动安装及 Docker 容器化三种方式进行部署的步骤。重点涵盖了初始化配置、远程访问 Token 认证设置、常见错误排查及版本更新维护，帮助用户快速搭建本地 AI 交互服务并实现 Dashboard 中文界面管理。

涅槃凤凰发布于 2026/2/27更新于 2026/9/1060 浏览
OpenClaw 中文发行版部署指南：npm/Docker/脚本三种方式

OpenClaw 是什么？

OpenClaw（曾用名 Clawdbot / Moltbot）是一个开源的个人 AI 助手平台，GitHub Stars 超过 12 万。它允许你在自己的机器上运行一个 AI 助手，通过 WhatsApp、Telegram、Discord 等常用聊天软件与 AI 交互。

Dashboard 界面预览

项目仓库：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

安装方式

提供三种方式，根据实际场景选择。

方式 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

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

  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

如果遇到镜像拉取失败，请检查网络是否能访问 GitHub Container Registry。

维护与卸载

如何更新到最新版

# 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 证书生产环境

版本说明

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

版本npm 标签Docker 标签更新频率
稳定版@latest:latest手动发布，经过测试
最新版@nightly:nightly每小时自动同步上游

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

总结

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

项目地址：GitHub - OpenClawChinese

目录

  1. OpenClaw 是什么？
  2. 汉化效果预览
  3. 环境要求
  4. Linux/macOS
  5. Windows 用户可使用 nvm-windows
  6. 安装方式
  7. 方式 A：一键脚本（推荐新手）
  8. 方式 B：npm 手动安装
  9. 稳定版（推荐）
  10. 或者 nightly 版（每小时同步上游最新代码）
  11. 方式 C：Docker 部署（服务器推荐）
  12. 1. 初始化配置
  13. 2. 启动
  14. 首次配置
  15. 运行初始化向导
  16. 安装守护进程（可选）
  17. 常用命令速查
  18. Docker 服务器部署详解
  19. 本地访问 vs 远程访问
  20. 方式 1：一键部署脚本（推荐）
  21. 自动生成 Token
  22. 或者指定 Token
  23. 仅本地访问（不配置远程）
  24. 方式 2：手动配置步骤
  25. 1. 创建数据卷
  26. 2. 初始化
  27. 3. 配置网关模式
  28. 4. 配置远程访问（允许局域网访问）
  29. 5. 设置访问令牌（重要！远程访问必须）
  30. 6. 启动容器
  31. 方式 3：Docker Compose
  32. 启动容器（首次会自动创建卷）
  33. 初始化配置
  34. 远程访问配置（可选）
  35. 重启生效
  36. 常见问题与排查
  37. 挂载路径错误
  38. 错误（配置不会持久化）
  39. 正确
  40. 必须先初始化再启动
  41. 远程访问报 1008 错误
  42. 容器已运行的情况下
  43. allowInsecureAuth 配置不生效
  44. package: 拉取 Docker 镜像…Error response
  45. 维护与卸载
  46. 如何更新到最新版
  47. npm 安装
  48. Docker
  49. 重新启动（配置保留在数据卷中）
  50. 如何彻底卸载
  51. 卸载 npm 包
  52. 删除配置文件（可选，会删除所有数据）
  53. Docker 方式
  54. 其他远程访问方案
  55. 版本说明
  56. 总结

更多推荐文章

查看全部
  • Windows 系统下 Neo4j 与 JDK 安装配置实战
  • Docker 安装部署全流程使用指南（Linux 通用版）
  • CTFHub Git 泄露漏洞利用与 Flag 获取实战
  • 深入理解 Claude Code:架构、上下文与工具系统
  • WebApi 项目集成企业微信和公众号
  • LLaMaFactory 基于魔搭社区免费 GPU 微调大模型实战
  • Ollama Windows 安装与使用指南：本地运行 Llama、DeepSeek 大模型
  • llama.cpp 多环境部署指南：从 CPU 到 CUDA/Metal 的高效推理实践
  • OpenCode 接入 Kimi K2.5 配置与实战指南
  • VL-JEPA：视觉语言联合嵌入预测架构解析
  • ESP32 无人机合规识别实战：ArduRemoteID 开源方案解析
  • GitHub 代码文件抓取与数据可视化实践（Python 实现）
  • MCP 插件配置指南：browser-tools-mcp 示例
  • Python 利用 wxpy 分析微信好友地区与性别分布
  • BK7258 与 LiveKit WebRTC 端侧适配实战
  • 一种光伏产品缺陷检测 AI 深度学习算法
  • 推荐系统 10 大必读经典论文：构建完整知识体系
  • 使用 LLaMA-Factory 微调大语言模型实战指南
  • 力扣 1749 题：任意子数组和的绝对值的最大值（DP 与前缀和）
  • MCP 协议详解：与 Function Call 区别及使用方式

相关免费在线工具

  • 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