前言

最近 GitHub 上有個項目火得離譜。OpenClaw，一周時間從 7800 Stars 飆升到 12 萬+，成為 GitHub 歷史上增長最快的項目之一。

創(chuàng)始人 Peter Steinberger（GitHub ID：@steipete）之前創(chuàng)辦過 PSPDFKit，退休后被 AI 浪潮吸引回來，搞出了這個東西。

我上周折騰了一番，發(fā)現(xiàn)確實有點東西。但全英文界面對中文用戶不友好，于是我們團隊把整個項目漢化了，包括命令行界面和網頁控制臺。

這篇文章從頭到尾講清楚怎么搭建漢化版 OpenClaw。本地安裝、Docker 部署、服務器遠程訪問，全都有。

一、OpenClaw 是什么

OpenClaw 是一個本地運行的 AI 助手。和普通聊天機器人不同，它能真正執(zhí)行任務。

核心能力

舉個例子，你在 Telegram 上發(fā)一句"幫我查下明天的航班"，它會去幫你查，然后把結果發(fā)回來。不是演示，是真能用的功能。

支持的 AI 模型

OpenClaw 不綁定特定模型：

• Anthropic Claude（Claude 3.5 Sonnet、Claude Opus 4.5 等）
• OpenAI GPT（GPT-4、GPT-4o 等）
• Google Gemini
• 本地模型（通過 Ollama 運行 Llama、Mistral 等）

有 API Key 就能用。用本地模型可以完全免費。

和其他工具的區(qū)別

Claude Code 和 Cursor 是給程序員寫代碼用的。OpenClaw 是給所有人用的通用 AI 助手。

二、漢化版做了什么

原版 OpenClaw 全英文。我們的漢化覆蓋兩大核心界面。

CLI 命令行：14 個模塊

• 啟動橫幅和 Logo
• 幫助信息（openclaw --help）
• 初始化向導（openclaw onboard）
• 安全警告和權限確認
• 等待動畫
• 各種命令：status、update、skills、channels、doctor、uninstall 等

Dashboard 網頁控制臺：31 個模塊

• 頂欄、側邊欄、導航菜單
• 對話界面、概覽頁、會話管理
• 所有渠道卡片（WhatsApp、Telegram、Discord、Slack 等）
• 配置頁面（31 個配置分區(qū)完整翻譯，300+ 配置項）
• 技能管理、節(jié)點管理、定時任務、日志查看、調試工具

翻譯規(guī)模：35+ 翻譯文件，970+ 條翻譯規(guī)則。

自動同步更新

漢化版不是一次性的。我們設置了 CI/CD 自動化流程：

• 每小時檢測官方倉庫更新
• 自動拉取代碼、應用漢化、構建發(fā)布
• 同時發(fā)布 npm 包和 Docker 鏡像

延遲不超過 1 小時。官方發(fā)布新功能后，漢化版最快 1 小時內可用。

漢化效果圖

三、環(huán)境要求

開始之前確認一下環(huán)境。

檢查 Node.js 版本：

node -v

需要顯示 v22.x.x 或更高。如果沒有或版本太低，去 nodejs.org 下載最新 LTS 版本。

四、安裝方式一：一鍵腳本

最簡單的方式，一行命令。

Linux 或 macOS

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

Windows PowerShell

以管理員身份運行 PowerShell，執(zhí)行：

Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1" -OutFile "install.ps1"; .\install.ps1

或者用簡寫形式：

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

安裝后

腳本會自動檢測系統(tǒng)和 Node.js 版本，安裝 @qingchencloud/openclaw-zh 包，然后啟動初始化向導。跟著向導走，大概 10-15 分鐘能用上。

五、安裝方式二：npm 安裝

適合熟悉 Node.js 的開發(fā)者。

安裝命令

穩(wěn)定版（推薦）：

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

最新版（每小時更新，追蹤上游最新代碼）：

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

初始化

openclaw onboard

這會啟動一個交互式終端界面，引導你完成：

1. 確認繼續(xù)：閱讀安全提示，確認授權
2. 選擇模式：新手選 QuickStart，老手選 Advanced
3. 配置模型：選擇 AI 提供商，填入 API Key
4. 設置渠道：選擇聊天應用（Telegram、Discord 等）
5. 創(chuàng)建人格：給 AI 助手起名字，設定性格

啟動

openclaw

讓它在后臺運行：

openclaw onboard --install-daemon

六、安裝方式三：Docker 部署

適合有服務器、NAS 或者想隔離環(huán)境的用戶。

6.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

腳本會自動完成初始化、配置、啟動。

6.2 手動部署：本地訪問

如果只在本機用，通過 localhost 訪問：

第一步，初始化配置（首次運行必須）：

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

第三步，啟動容器：

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://localhost:18789

6.3 手動部署：服務器遠程訪問

部署在服務器上，想從其他電腦訪問，需要額外配置。

為什么需要額外配置？ OpenClaw 默認只監(jiān)聽 127.0.0.1（本機），這是安全考慮。遠程訪問需要讓它監(jiān)聽所有網絡接口，并設置訪問認證。

完整步驟：

第一步，創(chuàng)建數(shù)據卷：

docker volume create openclaw-data

第二步，初始化配置：

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

第四步，綁定到局域網（關鍵）：

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

第五步，設置訪問令牌（必須）：

docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token 你的密碼

第六步，啟動容器：

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
• 頁面上會有「網關令牌」輸入框
• 輸入你設置的密碼，點擊「連接」

6.4 使用 Docker Compose

下載配置文件：

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=你的密碼    restart: unless-stoppedvolumes:  openclaw-data:

注意：首次使用需要先手動執(zhí)行 setup 和 config set 命令初始化配置，Compose 不會自動初始化。

七、首次配置詳解

不管用哪種方式安裝，首次運行都會進入初始化向導。

7.1 安全確認

OpenClaw 需要訪問文件系統(tǒng)、運行腳本、控制瀏覽器。權限較大，會讓你確認：

• 你知道它能做什么
• 你愿意授權

7.2 選擇模式

建議先用 QuickStart，熟悉后再調整配置。

7.3 配置 AI 模型

選擇 AI 提供商并填入 API Key：

如果有 Claude API Key，優(yōu)先用 Claude。OpenClaw 對 Claude 的支持最好。

7.4 設置聊天渠道

支持多種聊天渠道：

建議先用 Telegram 或 Discord 測試，成功后再配置其他渠道。

八、Dashboard 使用

啟動后訪問 http://localhost:18789（或服務器 IP）打開控制臺。

主要頁面

技能系統(tǒng)

社區(qū)貢獻了 565+ 個技能擴展：

• 效率工具：1Password、Apple Notes、Notion、Jira、Trello
• 開發(fā)工具：GitHub、AWS、Docker
• 通訊工具：Gmail、Calendar
• 智能家居：HomeKit、Home Assistant
• 其他：Web 搜索、PDF 編輯、圖片生成

在 Dashboard 的「技能」頁面可以瀏覽和安裝。

九、常見問題排查

問題 1：安裝后運行還是英文

原版和漢化版的包名不同，需要先卸載原版：

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

問題 2：Docker 容器一直重啟

通常是沒有初始化配置。查看日志：

docker logs openclaw

如果提示 Missing config 或 gateway.mode，按第六節(jié)重新配置。

問題 3：遠程訪問連不上

檢查清單：

• 防火墻：確保 18789 端口開放

Ubuntu 或 Debian：

sudo ufw allow 18789

CentOS 或 RHEL：

sudo firewall-cmd --add-port=18789/tcp --permanent
sudo firewall-cmd --reload

• 綁定地址：確保配置了 gateway.bind lan

docker exec openclaw openclaw config get gateway.bind

應該顯示 lan。

• Token：確保設置了訪問令牌

docker exec openclaw openclaw config get gateway.auth.token

問題 4：Dashboard 顯示 pairing required

這是設備配對安全機制。每個瀏覽器首次連接需要管理員批準。

第一步，查看待配對設備：

docker exec openclaw openclaw devices list --password '你的網關密碼'

第二步，批準配對請求（復制 Pending 表格中的 Request ID）：

docker exec openclaw openclaw devices approve <Request-ID>

然后刷新頁面重新連接。

問題 5：npm 安裝后內網其他電腦無法訪問

默認 Gateway 只監(jiān)聽本機。配置步驟：

openclaw config set gateway.bind lanopenclaw config set gateway.auth.token '你的密碼'openclaw gateway restart

問題 6：Docker 拉取鏡像報錯 denied

清理緩存后重試：

docker logout ghcr.iodocker pull ghcr.io/1186258278/openclaw-zh:nightly

十、常用命令速查

CLI 命令

Docker 命令

十一、相關鏈接

結語

OpenClaw 是目前最接近「真正 AI 助手」的工具。它不只是聊天，而是能幫你讀郵件、管日程、填表單、跑腳本。

漢化版解決了中文用戶的上手門檻。遇到問題可以在 GitHub 提Issue。

以上就是OpenClaw(Clawd/Moltbot)漢化版搭建指南的詳細內容，更多關于OpenClaw漢化版搭建教程的資料請關注腳本之家其它相關文章！

最新評論