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

OpenClaw 汉化版部署指南：npm/Docker/脚本三种安装方式详解

OpenClaw 是一款开源个人 AI 助手平台，支持多聊天软件交互。介绍其汉化中文版的部署方案，涵盖 npm、Docker 及一键脚本三种安装方式。重点讲解 Ubuntu 环境下的 Node.js 版本要求、远程访问的 Token 认证配置以及常见报错处理。通过本地或服务器部署，可实现私有化 AI 对话体验，界面全中文且支持自动同步更新。

奶糖兔发布于 2026/3/27更新于 2026/6/1230 浏览
OpenClaw 汉化版部署指南：npm/Docker/脚本三种安装方式详解

OpenClaw 是什么

OpenClaw（曾用名 Clawdbot / Moltbot）是一个开源的个人 AI 助手平台，GitHub 上已有超过 12 万星。它的核心逻辑很简单：在你自己的机器上运行一个 AI 助手，通过 WhatsApp、Telegram、Discord 等常用聊天软件跟它对话。

原版是全英文的，社区伙伴专门做了一个中文发行版，解决了语言障碍和配置繁琐的问题。这个版本支持 npm 一键安装或 Docker 一键部署，不需要手动打补丁，而且每小时自动从官方仓库拉取最新代码构建。

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

项目地址：GitHub - OpenClawChinese

环境准备

在动手之前，先检查一下你的环境是否达标。

项目要求
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：一键脚本（推荐新手）

最简单的方式，下载执行脚本自动完成安装。脚本会自动检查 Node.js 版本、安装中文版 npm 包并尝试运行初始化配置。

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
方式 B：npm 手动安装

如果脚本有问题，可以手动安装。这里有两个版本可选：稳定版适合日常使用，nightly 版每小时同步上游最新代码。

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

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

验证安装是否成功，看 --help 输出是否为中文：

openclaw --version
openclaw --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

踩坑记录

分享几个实际部署中容易遇到的坑，提前避坑能省不少时间。

坑 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

如果遇到拉取镜像失败，可能是镜像地址变更或网络问题。建议检查镜像源是否可访问。

常见问题

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. Linux/macOS
  4. Windows 用户可用 nvm-windows
  5. 安装方式
  6. 方式 A：一键脚本（推荐新手）
  7. 方式 B：npm 手动安装
  8. 稳定版（推荐）
  9. 或者 nightly 版（每小时同步上游最新代码）
  10. 方式 C：Docker 部署（服务器推荐）
  11. 1. 初始化配置
  12. 2. 启动
  13. 首次配置
  14. 运行初始化向导
  15. 安装守护进程（可选）
  16. 常用命令速查
  17. Docker 服务器部署详解
  18. 本地访问 vs 远程访问
  19. 方式 1：一键部署脚本（推荐）
  20. 自动生成 Token
  21. 或者指定 Token
  22. 仅本地访问（不配置远程）
  23. 方式 2：手动配置步骤
  24. 1. 创建数据卷
  25. 2. 初始化
  26. 3. 配置网关模式
  27. 4. 配置远程访问（允许局域网访问）
  28. 5. 设置访问令牌（重要！远程访问必须）
  29. 6. 启动容器
  30. 方式 3：Docker Compose
  31. 启动容器（首次会自动创建卷）
  32. 初始化配置
  33. 远程访问配置（可选）
  34. 重启生效
  35. 踩坑记录
  36. 坑 1：挂载路径错误
  37. 错误（配置不会持久化）
  38. 正确
  39. 坑 2：必须先初始化再启动
  40. 坑 3：远程访问报 1008 错误
  41. 容器已运行的情况下
  42. 坑 4：allowInsecureAuth 配置不生效
  43. 坑 5：package: 拉取 Docker 镜像…Error response
  44. 常见问题
  45. npm 安装
  46. Docker
  47. 重新启动（配置保留在数据卷中）
  48. 卸载 npm 包
  49. 删除配置文件（可选，会删除所有数据）
  50. Docker 方式
  51. 其他远程访问方案
  52. 常用 Docker 命令
  53. 查看日志
  54. 重启服务
  55. 停止服务
  56. 进入容器
  57. 查看当前配置
  58. 版本说明
  59. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • TRAE 平台 MCP Server 使用指南：常见问题与解决方案
  • Python 自动化 PPT 制作：python-pptx 库入门与实战
  • VS Code 配置 GitHub Copilot 使用第三方模型 API
  • Python IGRF 库本地环境配置与使用指南
  • iTerm2 Snazzy 主题安装与自定义配色指南
  • 前端高频面试题：TypeScript 篇
  • CSS 基础语法与选择器实战指南
  • Spring Boot 实战：从零设计短链系统（附代码与数据库设计）
  • AI 写作辅助平台评测：炼字工坊与蛙蛙写作深度解析
  • Stack-Chan 机器人快速入门指南
  • 大模型什么时候应该进行微调
  • VS Code 中 GitHub Copilot 使用与代理功能指南
  • C++11 列表初始化、新式声明、范围 for 与 STL 变化
  • ComfyUI 整合包部署实战：模型管理与工作流配置
  • Instagram 自动化工具常见问题解决：从依赖安装到运行错误排查
  • SeaweedFS 轻量分布式存储：中小规模 LoRA 训练部署方案
  • C++ string 类模拟实现
  • OpenClaw 开源 AI 助手中文发行版部署指南：一键脚本/Docker/npm 安装
  • 大模型 LLM 合成训练样本的数据分布问题
  • 使用 CopilotKit 快速为前端集成 AI 助手实战指南

相关免费在线工具

  • 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