每小时自动同步 OpenClaw 官方更新，汉化版延迟 < 1 小时！
🦀 ClawPanel — 内置 AI 助手的可视化管理面板 | 📱 ClawApp — 手机端聊天客户端 | 查看生态工具 →
什么是 OpenClaw？ · 词元 API 赞助 · 4 步上手 · 汉化效果预览 · 常用命令 · 网关重启 · 卸载教程 · 更新升级 · Docker 部署 · 其他安装方式 · 手机端 ClawApp · 常见问题 · 插件扩展 · 社区交流 · 相关链接 · 参与贡献 · 关于
子文档导航：
- 安装指南 — 前提条件 · 安装 · 初始化配置 · 验证运行 · 进阶配置 · 模型配置 · 守护进程
- Docker 部署指南 — 一键部署 · 本地启动 · 远程部署 · Token 认证 · Nginx 反代 · Docker Compose · 错误排查
- 常见问题 — 安装问题 · 启动问题 · Dashboard 连不上 · 内网/远程访问 · 模型和对话 · 其他问题
- 贡献指南 — 环境准备 · 项目结构 · 添加新翻译 · 提交 PR
- 翻译规范 — 术语表 · 翻译原则 · 风格指南
OpenClaw 是 GitHub 195,000+ Stars 的开源个人 AI 助手平台。它运行在你的电脑上，通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。
本项目 = OpenClaw + 全中文界面，CLI 命令行和 Dashboard 网页控制台均已深度汉化。
第三方赞助推广，具体规则以词元 API 页面为准。
平台亮点：
- 主流模型覆盖 — 支持 GPT、Claude、Gemini、Grok、Kimi 等主流前沿模型
- 价格福利 — 充值 ¥1 到账 $1 平台额度，部分线路按折扣计费
- OpenAI Compatible — API Base URL：
https://ciyapi.79tian.com/v1 - 赞助推广 — 第三方服务，具体规则以词元 API 页面为准
配合 OpenClaw 使用：
在 词元 API 注册，前往 API 密钥 获取 Key。初始化 OpenClaw 时选择 OpenAI Compatible 提供商，Base URL 填入 https://ciyapi.79tian.com/v1，再填入 Key 即可使用。
胜算云 - 国内 AI API 聚合平台，新用户注册送额度，充值尊享 7 折优惠！
|
内置 AI 助手的 OpenClaw 可视化管理面板
📸 预览截图（点击展开）
|
📱 ClawApp用手机浏览器和 OpenClaw AI 智能体聊天
📸 预览截图（点击展开）
|
前提条件：需要 Node.js >= 22.19.0（下载 Node.js）
检查版本：
node -v
npm install -g @qingchencloud/openclaw-zh@latestopenclaw onboard --install-daemon初始化向导会引导你完成：选择 AI 模型 → 配置 API 密钥 → 设置聊天通道
openclaw gatewayopenclaw dashboard浏览器会自动打开全中文的 Dashboard 控制台。完成！
想了解每一步的详细说明？查看 详细安装指南（包含 Node.js 安装、模型配置、守护进程、内网访问等）
概览仪表板 - 网关状态、实例监控、快捷操作一目了然
查看更多截图
对话界面 - 与 AI 助手实时交互
渠道管理 - WhatsApp、Telegram、Discord 等全平台支持
配置中心 - 完整汉化
节点配置 - 执行审批、安全策略管理
技能插件 - 1Password、Apple Notes 等丰富扩展
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# 卸载汉化版
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-reloadnpm update -g @qingchencloud/openclaw-zh查看当前版本：
openclaw --version
| 版本 | 安装命令 | 说明 |
|---|---|---|
| 稳定版 | npm install -g @qingchencloud/openclaw-zh@latest |
经过测试，推荐使用 |
| 最新版 | npm install -g @qingchencloud/openclaw-zh@nightly |
每小时同步上游，体验新功能 |
国内用户强烈推荐使用 Docker Hub 镜像，拉取速度快，无需翻墙！
| 镜像源 | 拉取命令 | 适用 |
|---|---|---|
| Docker Hub（国内推荐） | docker pull 1186258278/openclaw-zh:latest |
国内用户 |
| GitHub Container Registry | docker pull ghcr.io/1186258278/openclaw-zh:latest |
海外用户 |
# 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 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 部署指南
一键安装脚本（npm）
Linux / macOS：
curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.shWindows PowerShell：
[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"如遇中文乱码，直接用 npm 安装：
npm install -g @qingchencloud/openclaw-zh@latest
npm 国内加速安装
# 使用 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@latestpnpm / yarn 安装
# pnpm
pnpm add -g @qingchencloud/openclaw-zh@latest
# yarn
yarn global add @qingchencloud/openclaw-zh@latestGit 克隆加速
# 方案 1: 使用 GitHub 代理
git clone https://ghproxy.net/https://github.com/1186258278/OpenClawChineseTranslation.git
# 方案 2: 无需 git，直接用 npx 运行
npx @qingchencloud/openclaw-zh@latest想用手机和 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 项目主页 | 产品官网
❶ 安装卡住 / 下载慢
原因：npm 默认从国外源下载，国内网络可能很慢。
解决：加 --registry 参数使用国内镜像源，或直接用 Docker 部署：
# 方案 1：npm 加镜像源
npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com
# 方案 2：用 Docker（国内最快）
docker pull 1186258278/openclaw-zh:latest❷ 安装后还是英文界面
原因：系统上还残留了英文原版 openclaw，它的优先级高于汉化版。
解决：先卸载原版，再重装汉化版：
npm uninstall -g openclaw
npm install -g @qingchencloud/openclaw-zh@latest验证：openclaw --version 输出应包含 -zh 后缀。