火爆全网的OpenClaw 有汉化发行版了

🦞 什么是 OpenClaw？

OpenClaw^[1] 是由 Peter Steinberger (@steipete^[2]) 创建的开源个人 AI 助手平台，在 GitHub 上拥有超过 100,000+ Stars。

核心特性

它能做什么？

"清理你的收件箱、发送邮件、管理日历、办理航班值机……全部通过你常用的聊天应用完成。"

正如用户评价：

• "这是我第一次感觉自己活在未来。" — @davemorin
• "一切 Siri 本该成为的样子，而且远不止如此。" — @crossiBuilds
• "它正在运行我的公司。" — @therno
• "开源构建了一个比 Apple（3.6万亿美元公司）睡了多年的 Siri 更好的版本。" — @Hesamation

📸 汉化效果预览 

⚡ 一键安装汉化版 

Windows (PowerShell)

# 下载并执行安装脚本（注意：需要 UTF-8 编码）
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1" -OutFile "install.ps1" -Encoding UTF8; powershell -ExecutionPolicy Bypass -File ".install.ps1"

如果遇到中文乱码问题，请使用以下命令：

# 方法1：直接通过 npm 安装（推荐）
npm install -g @qingchencloud/openclaw-zh@latest

# 方法2：使用 PowerShell 7+（支持 UTF-8）
pwsh -Command "irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1 | iex"

Linux / macOS

# 下载并执行安装脚本
curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh

💡 使用 jsDelivr CDN 加速 | 🔒 查看脚本源码^[5]

📦 其他安装方式 

版本选择

我们提供两个版本源，根据需求选择：

方式 1: npm / pnpm / yarn 安装

# npm 安装（推荐）
npm install -g @qingchencloud/openclaw-zh@latest      # 稳定版
npm install -g @qingchencloud/openclaw-zh@nightly     # 最新版

# pnpm 安装
pnpm add -g @qingchencloud/openclaw-zh@latest         # 稳定版
pnpm add -g @qingchencloud/openclaw-zh@nightly        # 最新版

# yarn 安装
yarn global add @qingchencloud/openclaw-zh@latest     # 稳定版
yarn global add @qingchencloud/openclaw-zh@nightly    # 最新版

💡 我们发布的是标准 npm 包，npm / pnpm / yarn 都可以安装，选择你习惯的包管理器即可。

方式 2: 手动下载

访问 Releases 页面^[7] 下载最新版本。

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

# 访问 Dashboard: http://localhost:18789

📖 详细 Docker 配置请参考下方 Docker 部署指南^[8]

🚀 快速开始 

安装完成后：

💡 自动初始化: 使用一键安装脚本时，安装完成后会自动尝试运行初始化配置。 如需跳过，设置环境变量 OPENCLAW_SKIP_SETUP=1 即可。

# 启动初始化向导（全中文界面）
openclaw onboard

# 安装后台守护进程
openclaw onboard --install-daemon

首次运行会引导你完成：

1. 选择 AI 模型提供商（Claude、GPT、本地模型等）
2. 配置 API 密钥
3. 设置聊天通道（WhatsApp、Telegram 等）
4. 创建你的 AI 助手人格

常用命令

openclaw                    # 启动 OpenClaw
openclaw onboard            # 初始化向导
openclaw config             # 查看/修改配置
openclaw skills             # 管理技能
openclaw --help             # 查看帮助

🔄 更新升级 

已安装的 OpenClaw 汉化版如何升级？根据你的安装方式选择对应方法：

npm 安装用户

# 升级到最新稳定版
npm update -g @qingchencloud/openclaw-zh

# 或者重新安装指定版本
npm install -g @qingchencloud/openclaw-zh@latest    # 稳定版
npm install -g @qingchencloud/openclaw-zh@nightly   # 最新版

💡 查看当前版本: openclaw --version

Docker 用户

# 1. 拉取最新镜像
docker pull ghcr.io/1186258278/openclaw-zh:nightly   # 最新版
# 或
docker pull ghcr.io/1186258278/openclaw-zh:latest    # 稳定版

# 2. 停止并删除旧容器
docker stop openclaw && docker rm openclaw

# 3. 用新镜像启动（配置会自动保留，因为存储在数据卷中）
docker run -d --name openclaw -p 18789:18789 
  -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw gateway run

💡 数据不会丢失: 配置和数据存储在 openclaw-data 卷中，升级镜像不会影响。

Docker Compose 用户

# 1. 拉取最新镜像
docker compose pull

# 2. 重新创建容器
docker compose up -d

一键安装脚本用户

直接重新运行安装脚本即可，会自动升级到最新版：

# Linux/macOS
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash

# Windows PowerShell
npm install -g @qingchencloud/openclaw-zh@latest

版本对比

✨ 汉化内容 

我们提供了深度汉化，覆盖 CLI 命令行 + Dashboard 网页控制台 两大核心界面。

📊 汉化统计

🖥️ CLI 命令行 (14 个模块)

🌐 Dashboard 网页控制台 (31 个模块)

📋 配置页面完整翻译 (31 个分区)

注意：与 AI 的对话内容取决于你使用的模型，不在汉化范围内。

🔄 自动同步更新 

• 每小时 检测 OpenClaw 官方仓库更新
• 自动 应用汉化、构建、测试
• 同时发布 npm 包 + GitHub Releases

版本格式：{官方版本}-zh.{日期}，如 2026.1.29-zh.20260130

🔌 插件扩展 

OpenClaw 汉化版支持通过 npm 插件扩展功能。我们提供了官方插件，让你的 AI 助手更加强大！

插件市场

访问我们的插件市场查看所有可用插件：

如何安装插件

# 全局安装插件
npm install -g @qingchencloud/插件包名

# 例如安装更新检测插件
npm install -g @qingchencloud/openclaw-updater

安装后重启 OpenClaw 即可使用插件提供的功能。

可用插件列表

💡 更多插件正在开发中，敬请期待！访问 插件市场^[14] 获取最新插件。

更新检测插件

安装后，插件会：

• 启动时自动检测是否有新版本
• 提供 /update 命令手动检查更新
• 提供 /version 命令查看当前版本

# 安装
npm install -g @qingchencloud/openclaw-updater

# 使用
# 启动 OpenClaw 后，插件会自动检测更新
# 或使用命令 /update 手动检查

🐳 Docker 部署指南 

方式 1：一键部署脚本（推荐）

自动完成初始化、配置远程访问、启动容器：

# Linux / macOS
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash

# Windows PowerShell
irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex

方式 2：快速启动（本地访问）

适用于在本机运行并通过 localhost 访问：

# 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

方式 3：服务器部署（远程访问）

部署到服务器并从其他设备访问时，需要额外配置。

手动配置步骤：

# 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

docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan

# 4. 设置访问令牌（推荐）
docker run --rm -v openclaw-data:/root/.openclaw 
  ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token your-secure-token

# 5. 启动容器
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 → 在 Dashboard 输入 token 连接

远程访问注意事项 ⚠️ 重要

通过 HTTP 从非 localhost 访问时，浏览器会阻止设备身份验证（Web Crypto API 需要 secure context）。

✅ 推荐解决方案：设置 Token 认证

# 1. 设置访问令牌（在服务器上执行）
docker exec openclaw openclaw config set gateway.auth.token YOUR_TOKEN
docker restart openclaw

# 2. 在浏览器访问远程地址
http://服务器IP:18789/overview

# 3. 在「网关令牌」输入框填入 YOUR_TOKEN，点击「连接」

💡 说明：设置 gateway.auth.token 后，即使通过远程 HTTP 访问，只要在 Dashboard 输入正确的 token 就能连接成功。

其他解决方案对比：

⚠️ 注意：gateway.controlUi.allowInsecureAuth: true 配置存在已知上游 Bug（#1679^[16]），单独使用不起作用，必须配合 gateway.auth.token 使用。

使用 Docker Compose

项目提供了开箱即用的 docker-compose.yml：

# 下载配置文件
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-compose.yml -o docker-compose.yml

# 启动（首次会自动初始化）
docker-compose up -d

或手动创建 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=your-secure-token# 设置访问令牌
    restart:unless-stopped
    # 远程访问时使用以下命令（需先手动初始化配置）
    # command: openclaw gateway run

volumes:
openclaw-data:

自行构建 Docker 镜像

如果需要自定义或使用最新代码：

# 1. 克隆汉化项目
git clone https://github.com/1186258278/OpenClawChineseTranslation.git
cd OpenClawChineseTranslation

# 2. 克隆上游源码
git clone https://github.com/openclaw/openclaw.git openclaw

# 3. 应用汉化
npm run cli -- apply

# 4. 构建 Docker 镜像
cd openclaw
docker build -t openclaw-zh:local .

# 5. 运行
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw openclaw-zh:local

常用 Docker 命令

# 查看日志
docker logs -f openclaw

# 停止容器
docker stop openclaw

# 重启容器
docker restart openclaw

# 进入容器
docker exec -it openclaw sh

# 删除容器
docker stop openclaw && docker rm openclaw

# 查看配置
docker run --rm -v openclaw-data:/root/.openclaw alpine cat /root/.openclaw/openclaw.json

Docker 空间清理

Docker 镜像和容器会占用大量磁盘空间，建议定期清理：

# 查看 Docker 空间占用
docker system df

# 清理已停止的容器
docker container prune -f

# 清理未使用的镜像
docker image prune -f

# 清理构建缓存
docker builder prune -f

# 一键清理所有未使用资源（镜像、容器、网络、缓存）
docker system prune -a

# 连同未使用的数据卷一起清理（⚠️ 会删除数据，谨慎使用）
docker system prune -a --volumes

💡 提示：OpenClaw 镜像约 4GB，如果有多个旧版本镜像堆积，建议用 docker image prune -a 清理。

🔧 手动汉化安装 

适用于想要自定义翻译、测试最新代码或参与贡献的用户。

完整流程

# 1. 克隆汉化项目
git clone https://github.com/1186258278/OpenClawChineseTranslation.git
cd OpenClawChineseTranslation

# 2. 克隆上游 OpenClaw 源码
git clone https://github.com/openclaw/openclaw.git openclaw

# 3. 查看汉化状态
npm run cli -- status

# 4. 应用汉化补丁
npm run cli -- apply

# 5. 验证汉化结果
npm run cli -- verify

# 6. 构建 OpenClaw
cd openclaw
pnpm install
pnpm run build

# 7. 全局安装
npm install -g .

# 8. 验证安装
openclaw --version
openclaw --help

汉化 CLI 完整命令

自定义翻译

1. 找到目标文件：确定需要翻译的源文件位置

2. 创建翻译规则：在 translations/ 对应目录创建 JSON 文件

   {
     "file": "src/path/to/file.ts",
     "description": "文件说明",
     "replacements": {
       ""English Text"": ""中文翻译""
     }
   }
   

3. 注册翻译文件：在 translations/config.json 中添加

4. 测试：

   npm run cli -- apply --dry-run --verbose
   npm run cli -- apply
   npm run cli -- verify
   

5. 提交 PR：欢迎贡献你的翻译！

🛠️ 开发者 / 贡献者指南 

如果你想参与翻译或本地开发：

# 1. 克隆本项目
git clone https://github.com/1186258278/OpenClawChineseTranslation.git
cd OpenClawChineseTranslation

# 2. 克隆上游 OpenClaw 源码
git clone https://github.com/openclaw/openclaw.git openclaw

# 3. 使用汉化 CLI 工具
npm run cli -- status           # 查看状态
npm run cli -- apply --dry-run  # 预览汉化（不修改）
npm run cli -- apply            # 应用汉化
npm run cli -- verify           # 验证结果
npm run cli -- restore          # 恢复原版

项目结构

OpenClawChineseTranslation/
├── cli/                    # 汉化 CLI 工具
│   ├── index.mjs           # 入口
│   ├── commands/           # 命令实现
│   └── utils/              # 工具函数（i18n 引擎）
├── translations/           # 翻译配置（JSON 格式）
│   ├── config.json         # 主配置（加载所有翻译文件）
│   ├── cli/                # CLI 界面翻译
│   │   ├── banner.json     # 启动横幅
│   │   ├── tagline.json    # 有趣标语
│   │   └── help.json       # 帮助信息
│   ├── wizard/             # 向导翻译
│   │   ├── onboarding.json # 初始化向导
│   │   ├── security.json   # 安全警告
│   │   └── finalize.json   # 完成提示
│   ├── tui/                # TUI 界面翻译
│   │   ├── waiting.json    # 等待动画
│   │   └── commands.json   # 斜杠命令
│   ├── commands/           # 命令翻译
│   │   ├── status.json     # status 命令
│   │   ├── update.json     # update 命令
│   │   ├── skills.json     # skills 命令
│   │   └── ...             # 更多命令
│   └── dashboard/          # Dashboard UI 翻译 (20+ 文件)
│       ├── navigation.json # 导航菜单
│       ├── app-render.json # 主布局
│       ├── chat.json       # 聊天界面
│       ├── config.json     # 配置页面
│       ├── schema.json     # 配置 schema
│       ├── config-form-*.json  # 表单元素
│       ├── channels-*.json # 各渠道翻译
│       └── ...             # 更多模块
├── docs/                   # 文档
├── .github/workflows/      # 自动化工作流
├── install.sh              # Linux/macOS 安装脚本
└── install.ps1             # Windows 安装脚本

添加新翻译

1. 在 translations/ 目录下创建或编辑 JSON 文件
2. 在 translations/config.json 中注册新文件
3. 运行 npm run cli -- apply --dry-run 预览
4. 运行 npm run cli -- verify 验证
5. 提交 PR

详见 贡献指南^[19] 和 翻译规范^[20]