OpenClaw 汉化发行版

每小时自动同步 OpenClaw 官方更新，汉化版延迟 < 1 小时！

🦀 ClawPanel — 内置 AI 助手的可视化管理面板 | 📱 ClawApp — 手机端聊天客户端 | 查看生态工具 →

目录

什么是 OpenClaw？ · 🎁 免费 AI 接口 · 4 步上手 · 汉化效果预览 · 常用命令 · 网关重启 · 卸载教程 · 更新升级 · Docker 部署 · 其他安装方式 · 手机端 ClawApp · 常见问题 (FAQ) · 插件扩展 · 社区交流 · 相关链接 · 参与贡献 · 关于

子文档导航：

• 安装指南 — 前提条件 · 安装 · 初始化配置 · 验证运行 · 进阶配置 · 模型配置 · 守护进程
• Docker 部署指南 — 一键部署 · 本地启动 · 远程部署 · Token (身份验证令牌) 认证 · Nginx (高性能 HTTP 服务器) 反代 · Docker Compose (容器编排工具) · 错误排查
• 常见问题 (FAQ) — 安装问题 · 启动问题 · Dashboard 连不上 · 内网/远程访问 · 模型和对话 · 其他问题
• 贡献指南 — 环境准备 · 项目结构 · 添加新翻译 · 提交 PR (拉取请求)
• 翻译规范 — 术语表 · 翻译原则 · 风格指南

什么是 OpenClaw？

OpenClaw 是 GitHub 195,000+ Stars 的开源个人 AI 助手平台。它运行在你的电脑上，通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。

本项目 = OpenClaw + 全中文界面，CLI (命令行界面) 和 Dashboard (网页控制台) 均已深度汉化。

回到顶部

🎁 免费 AI 接口

内部公益平台，免费使用主流 AI 模型！ 签到领额度，邀请得更多，持续免费用 AI！

平台亮点：

• ** 签到领免费额度** — 每日签到 + 邀请好友，持续获取免费使用额度
• 💰 不满意可退 — 用着不爽随时退款，零风险体验
• ⚡ 兼容 OpenAI 接口 — 无缝对接 OpenClaw，即开即用
• 🔒 内部公益项目 — 长期维护，安全稳定

配合 OpenClaw 使用：

在 gpt.qt.cool 注册并签到领取免费额度，获取 API Key (应用程序接口密钥) 后，初始化 OpenClaw 时选择 OpenAI Compatible (兼容 OpenAI 标准) 提供商，填入地址和 Key 即可使用。

💡 小贴士：每日签到 + 邀请好友即可持续获取免费额度，搭配 OpenClaw 等于拥有一个免费私人 AI 助手！

立即使用 →

合作伙伴

胜算云 - 国内 AI API 聚合平台，新用户注册送额度，充值尊享 7 折优惠！

注册账号 →

回到顶部

🔥 生态工具

🦀 ClawPanel 内置 AI 助手的 OpenClaw 可视化管理面板 🤖 AI 助手 — 8 大工具 + 4 种模式，自动诊断配置 🖼️ 图片识别 — 粘贴截图，AI 一眼看懂 ⚡ 一键安装 — 自动检测环境，无需终端 🎛️ 可视化管理 — 模型、Gateway、Agent 📸 预览截图（点击展开）

📱 ClawApp 用手机浏览器和 OpenClaw AI 智能体聊天 💬 流式聊天 — WebSocket (Web 套接字协议) 实时对话 📷 图片收发 — 拍照上传，AI 图片回复 🔧 工具调用 — 实时状态显示 📱 PWA (渐进式 Web 应用) + APK (Android 安装包) — 添加到主屏幕 📸 预览截图（点击展开）

回到顶部

4 步上手

前提条件：需要 Node.js (JavaScript 运行时环境) >= 22（下载 Node.js）

检查版本：node -v

第 1 步：安装

npm (Node 包管理器) install -g @qingchencloud/openclaw-zh@latest

第 2 步：初始化（推荐守护进程模式）

openclaw onboard --install-daemon

初始化向导会引导你完成：选择 AI 模型 → 配置 API 密钥 → 设置聊天通道

第 3 步：启动网关

openclaw gateway

第 4 步：打开控制台

openclaw dashboard

浏览器会自动打开全中文的 Dashboard 控制台。完成！

想了解每一步的详细说明？查看 详细安装指南（包含 Node.js 安装、模型配置、守护进程、内网访问等）

回到顶部

汉化效果预览

概览仪表板 - 网关状态、实例监控、快捷操作一目了然

回到顶部

常用命令

openclaw                    # 启动 OpenClaw
openclaw onboard            # 初始化向导
openclaw dashboard          # 打开网页控制台
openclaw config             # 查看/修改配置
openclaw skills             # 管理技能
openclaw --help             # 查看帮助

# 网关管理
openclaw gateway run        # 前台运行（挂终端，用于调试）
openclaw gateway start      # 后台守护进程（不挂终端，推荐！）
openclaw gateway stop       # 停止网关
openclaw gateway restart    # 重启网关
openclaw gateway status     # 查看网关状态
openclaw gateway install    # 安装为系统服务（开机自启）

# 常用操作
openclaw update             # 检查并更新 CLI (命令行接口)
openclaw doctor             # 诊断问题（自动修复）

Windows 用户注意：如果 gateway install 失败（提示 schtasks 不可用），可使用 gateway start 启动后台进程，或使用 Docker 部署方案。

Dashboard 语言设置：首次打开网页控制台后，前往 Overview 页面底部，将 Language 切换为 简体中文 (Simplified Chinese)，即可显示中文界面。设置后刷新页面生效。

回到顶部

网关重启

# 方式 1：使用 gateway 子命令（推荐）
openclaw gateway restart

# 方式 2：先停止再启动
openclaw gateway stop
openclaw gateway start

# 方式 3：守护进程模式（后台运行，不挂终端）
openclaw daemon start       # 启动后台守护
openclaw daemon stop        # 停止守护
openclaw daemon restart    # 重启守护
openclaw daemon status     # 查看状态

# Docker 容器重启
docker restart openclaw

回到顶部

卸载教程

CLI 卸载

# 卸载汉化版
npm uninstall -g @qingchencloud/openclaw-zh

# 如果之前安装过原版，也一并卸载
npm uninstall -g openclaw

数据清理（可选）

# 删除配置和缓存（不可恢复！）
rm -rf ~/.openclaw

# Docker 清理
docker rm -f openclaw                # 删除容器
docker volume rm openclaw-data       # 删除数据卷

守护进程卸载

# macOS
launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
rm ~/Library/LaunchAgents/com.openclaw.plist

# Linux (systemd)
sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service
sudo systemctl daemon-reload

回到顶部

更新升级

npm update -g @qingchencloud/openclaw-zh

查看当前版本：openclaw --version

回到顶部

Docker 部署（国内推荐）

国内用户强烈推荐使用 Docker Hub 镜像，拉取速度快，无需翻墙！

一键部署（最简单）

# Linux/macOS — 加 --china 自动使用国内镜像
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | bash -s -- --china

# Windows PowerShell — 加 -China 自动使用国内镜像
irm https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.ps1 | iex
# 或：.\docker-deploy.ps1 -China

手动 Docker 部署

# 国内用户使用 Docker Hub 镜像
IMAGE=1186258278/openclaw-zh:latest
# 海外用户使用：IMAGE=ghcr.io/1186258278/openclaw-zh:latest

# 1. 初始化（首次运行）
# Docker 需要交互式运行来配置 AI 模型和 API 密钥
docker run --rm -it -v openclaw-data:/root/.openclaw $IMAGE openclaw onboard

# 按向导完成：选择模型 → 配置 API 密钥 → 设置聊天通道

# 2. 配置网关模式
docker run --rm -v openclaw-data:/root/.openclaw $IMAGE openclaw config set gateway.mode local

# 3. 启动（守护进程模式，容器会一直运行）
docker run -d --name openclaw -p 18789:18789 \
  -v openclaw-data:/root/.openclaw --restart unless-stopped \
  $IMAGE openclaw gateway run

参数说明：

• -d: 后台运行（守护进程模式）
• --name openclaw: 给容器取名，方便管理
• -p 18789:18789: 端口映射
• --restart unless-stopped: 除非手动停止，否则一直运行
• openclaw gateway run: 启动网关（容器启动命令）

访问：http://localhost:18789

完整指南（远程部署、Nginx 反代、Docker Compose、内网访问等）请查看 Docker 部署指南

回到顶部

其他安装方式

curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh

[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"

# 使用 npmmirror 镜像源（国内推荐）
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com

# 或全局设置镜像源后再安装
npm config set registry https://registry.npmmirror.com
npm install -g @qingchencloud/openclaw-zh@latest

# pnpm
pnpm add -g @qingchencloud/openclaw-zh@latest

# yarn
yarn global add @qingchencloud/openclaw-zh@latest

# 方案 1: 使用 GitHub 代理
git clone https://ghproxy.net/https://github.com/1186258278/OpenClawChineseTranslation.git

# 方案 2: 无需 git，直接用 npx 运行
npx @qingchencloud/openclaw-zh@latest

回到顶部

手机端 — ClawApp

想用手机和 AI 智能体聊天？ ClawApp 是 OpenClaw 的移动端 H5 聊天客户端，打开浏览器就能用，不需要装 App。

OpenClaw Gateway 默认只监听本机（127.0.0.1:18789），手机无法直接连接。ClawApp 通过 WebSocket 代理解决了这个问题：

手机浏览器（任意网络）
    ↓ WebSocket (WS / WSS)
ClawApp 代理服务端（端口 3210）
    ↓ WebSocket (localhost)
OpenClaw Gateway（端口 18789）

核心特性：实时流式聊天 · 图片发送 · Markdown 渲染 + 代码高亮 · 快捷指令 · 会话管理 · 暗色/亮色主题 · 中英文切换 · PWA 支持 · Android APK

快速部署（Docker 一键启动）：

git clone https://github.com/qingchencloud/clawapp.git
cd clawapp

# 创建 .env，填入你的 Token
echo 'PROXY_TOKEN=设置一个连接密码' > .env
echo 'OPENCLAW_GATEWAY_TOKEN=你的 gateway-token' >> .env

docker compose up -d --build

手机浏览器打开 http://你的电脑 IP:3210 即可使用。

详细文档（外网访问、Cloudflare Tunnel、Nginx 反代等）请查看 ClawApp 项目主页 | 产品官网

回到顶部

常见问题

Top 3 高频问题

# 方案 1：npm 加镜像源
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com

# 方案 2：用 Docker（国内最快）
docker pull 1186258278/openclaw-zh:latest

npm uninstall -g openclaw
npm install -g @qingchencloud/openclaw-zh@latest

# token mismatch —— 用 dashboard 命令自动带 Token 打开：
openclaw dashboard

# pairing required —— 批准设备：
openclaw devices list           # 查看待批准设备 ID
openclaw devices approve <ID>   # 批准该设备

# Docker 用户如果无法运行 CLI，可以一键关闭设备认证：
docker run --rm -v openclaw-data:/root/.openclaw \
  1186258278/openclaw-zh:latest \
  openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true
# 然后重启容器

其他常见问题

完整排查手册 (25+ 个问题) | Docker 问题排查

回到顶部

插件扩展

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

访问 插件市场 获取更多插件。

回到顶部

社区交流

QQ 交流群

扫码或 点击链接 加入 | 2000 人大群，满员自动切换

微信交流群

扫码或 点击链接 加入 | 碰到问题也可以直接在群内反馈

抖音交流群

扫码或 点击链接 加入 | 拍视频、看教程、交流心得

飞书交流群

扫码或 点击链接 加入 | 飞书群聊，高效协作交流

回到顶部

相关链接

回到顶部

参与贡献

• 报告问题 | 改进翻译 | 翻译规范 | 给项目点个 Star

回到顶部

关于

武汉晴辰天下网络科技有限公司 出品 | qingchencloud.com | MIT 许可证

© 武汉晴辰天下网络科技有限公司 | 鄂 ICP 备 2025164966 号

回到顶部

OpenClaw 汉化版快速上手指南

环境准备

• 操作系统: Windows / macOS / Linux
• 前置依赖: Node.js >= 22
  • 检查版本：node -v

安装步骤

方式一：CLI 安装（推荐）

npm install -g @qingchencloud/openclaw-zh@latest

方式二：Docker 部署（国内推荐）

国内用户建议使用国内加速镜像源。

1. 拉取镜像

   docker pull 1186258278/openclaw-zh:latest
   

2. 一键部署脚本

   • Linux/macOS:

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

   • Windows PowerShell:

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

基本使用

1. 初始化配置 运行以下命令跟随向导完成模型选择、API Key 及聊天通道配置：

   openclaw onboard --install-daemon
   

2. 启动网关

   openclaw gateway
   

   (若需后台守护进程模式，可使用 openclaw gateway start)

3. 打开控制台

   openclaw dashboard
   

   浏览器将自动打开 Dashboard。

💡 语言设置提示：首次打开 Dashboard 后，请前往 Overview 页面底部，将 Language 切换为 简体中文 (Simplified Chinese)，刷新页面即可显示全中文界面。