其他安装方式
一键安装脚本（npm）
Linux / macOS：
curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh
Windows 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@latest
pnpm / yarn 安装
# pnpm
pnpm add -g @qingchencloud/openclaw-zh@latest
# yarn
yarn global add @qingchencloud/openclaw-zh@latest
Git 克隆加速
# 方案 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 高频问题
❶ 安装卡住 / 下载慢
原因：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 后缀。❸ 打开 Dashboard 报 `pairing required` 或 `token mismatch`
原因：OpenClaw 的安全机制要求设备配对或 Token 验证。
解决：
# 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
# 然后重启容器
其他常见问题
| 问题 | 快速解决 | 详情 |
|---|---|---|
安装报 Permission denied (publickey) |
git config --global url."https://github.com/".insteadOf ssh://git@github.com/ |
查看 → |
| 远程 / 内网访问不了 | openclaw config set gateway.bind lan 然后重启 |
查看 → |
| 镜像源版本落后 | 去掉 --registry 参数直接安装，或等待镜像同步（已自动触发） |
#32 |
Missing config |
运行 openclaw onboard 初始化配置 |
查看 → |
Missing workspace template |
升级到最新版即可：npm install -g @qingchencloud/openclaw-zh@latest |
查看 → |
| Ollama 无响应 | 检查 baseURL 是否为 http://localhost:11434/v1 |
查看 → |
| Docker 容器启动后退出 | 确保启动命令包含 openclaw gateway run |
查看 → |
| Docker 打不开 Dashboard | 设置 gateway.bind lan 监听所有网卡 |
查看 → |
插件扩展
# 安装更新检测插件
npm install -g @qingchencloud/openclaw-updater
