前言

最近 GitHub 上有個(gè)項(xiàng)目火得離譜。OpenClaw，一周時(shí)間從 7800 Stars 飆升到 12 萬(wàn)+，成為 GitHub 歷史上增長(zhǎng)最快的項(xiàng)目之一。

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

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

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

一、OpenClaw 是什么

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

核心能力

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

支持的 AI 模型

OpenClaw 不綁定特定模型：

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

有 API Key 就能用。用本地模型可以完全免費(fèi)。

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

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

二、漢化版做了什么

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

CLI 命令行：14 個(gè)模塊

• 啟動(dòng)橫幅和 Logo
• 幫助信息（openclaw --help）
• 初始化向?qū)В?code>openclaw onboard）
• 安全警告和權(quán)限確認(rèn)
• 等待動(dòng)畫
• 各種命令：status、update、skills、channels、doctor、uninstall 等

Dashboard 網(wǎng)頁(yè)控制臺(tái)：31 個(gè)模塊

• 頂欄、側(cè)邊欄、導(dǎo)航菜單
• 對(duì)話界面、概覽頁(yè)、會(huì)話管理
• 所有渠道卡片（WhatsApp、Telegram、Discord、Slack 等）
• 配置頁(yè)面（31 個(gè)配置分區(qū)完整翻譯，300+ 配置項(xiàng)）
• 技能管理、節(jié)點(diǎn)管理、定時(shí)任務(wù)、日志查看、調(diào)試工具

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

自動(dòng)同步更新

漢化版不是一次性的。我們?cè)O(shè)置了 CI/CD 自動(dòng)化流程：

• 每小時(shí)檢測(cè)官方倉(cāng)庫(kù)更新
• 自動(dòng)拉取代碼、應(yīng)用漢化、構(gòu)建發(fā)布
• 同時(shí)發(fā)布 npm 包和 Docker 鏡像

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

漢化效果圖

三、環(huán)境要求

開(kāi)始之前確認(rèn)一下環(huán)境。

檢查 Node.js 版本：

node -v

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

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

最簡(jiǎn)單的方式，一行命令。

Linux 或 macOS

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

Windows PowerShell

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

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

或者用簡(jiǎn)寫形式：

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

安裝后

腳本會(huì)自動(dòng)檢測(cè)系統(tǒng)和 Node.js 版本，安裝 @qingchencloud/openclaw-zh 包，然后啟動(dòng)初始化向?qū)?。跟著向?qū)ё?，大?10-15 分鐘能用上。

五、安裝方式二：npm 安裝

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

安裝命令

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

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

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

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

初始化

openclaw onboard

這會(huì)啟動(dòng)一個(gè)交互式終端界面，引導(dǎo)你完成：

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

啟動(dòng)

openclaw

讓它在后臺(tái)運(yùn)行：

openclaw onboard --install-daemon

六、安裝方式三：Docker 部署

適合有服務(wù)器、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

腳本會(huì)自動(dòng)完成初始化、配置、啟動(dòng)。

6.2 手動(dòng)部署：本地訪問(wèn)

如果只在本機(jī)用，通過(guò) localhost 訪問(wèn)：

第一步，初始化配置（首次運(yùn)行必須）：

docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup

第二步，設(shè)置網(wǎng)關(guān)模式：

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

第三步，啟動(dòng)容器：

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

啟動(dòng)后訪問(wèn) http://localhost:18789

6.3 手動(dòng)部署：服務(wù)器遠(yuǎn)程訪問(wèn)

部署在服務(wù)器上，想從其他電腦訪問(wèn)，需要額外配置。

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

完整步驟：

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

docker volume create openclaw-data

第二步，初始化配置：

docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:nightly openclaw setup

第三步，設(shè)置網(wǎng)關(guān)模式：

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

第四步，綁定到局域網(wǎng)（關(guān)鍵）：

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

第五步，設(shè)置訪問(wèn)令牌（必須）：

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

第六步，啟動(dòng)容器：

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

訪問(wèn)方式：

• 打開(kāi)瀏覽器，訪問(wèn) http://服務(wù)器IP:18789
• 頁(yè)面上會(huì)有「網(wǎng)關(guān)令牌」輸入框
• 輸入你設(shè)置的密碼，點(diǎn)擊「連接」

6.4 使用 Docker Compose

下載配置文件：

curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-compose.yml -o docker-compose.yml

啟動(dòng)：

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:

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

七、首次配置詳解

不管用哪種方式安裝，首次運(yùn)行都會(huì)進(jìn)入初始化向?qū)А?/p>

7.1 安全確認(rèn)

OpenClaw 需要訪問(wèn)文件系統(tǒng)、運(yùn)行腳本、控制瀏覽器。權(quán)限較大，會(huì)讓你確認(rèn)：

• 你知道它能做什么
• 你愿意授權(quán)

7.2 選擇模式

建議先用 QuickStart，熟悉后再調(diào)整配置。

7.3 配置 AI 模型

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

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

7.4 設(shè)置聊天渠道

支持多種聊天渠道：

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

八、Dashboard 使用

啟動(dòng)后訪問(wèn) http://localhost:18789（或服務(wù)器 IP）打開(kāi)控制臺(tái)。

主要頁(yè)面

技能系統(tǒng)

社區(qū)貢獻(xiàn)了 565+ 個(gè)技能擴(kuò)展：

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

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

九、常見(jiàn)問(wèn)題排查

問(wèn)題 1：安裝后運(yùn)行還是英文

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

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

問(wèn)題 2：Docker 容器一直重啟

通常是沒(méi)有初始化配置。查看日志：

docker logs openclaw

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

問(wèn)題 3：遠(yuǎn)程訪問(wèn)連不上

檢查清單：

• 防火墻：確保 18789 端口開(kāi)放

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

應(yīng)該顯示 lan。

• Token：確保設(shè)置了訪問(wèn)令牌

docker exec openclaw openclaw config get gateway.auth.token

問(wèn)題 4：Dashboard 顯示 pairing required

這是設(shè)備配對(duì)安全機(jī)制。每個(gè)瀏覽器首次連接需要管理員批準(zhǔn)。

第一步，查看待配對(duì)設(shè)備：

docker exec openclaw openclaw devices list --password '你的網(wǎng)關(guān)密碼'

第二步，批準(zhǔn)配對(duì)請(qǐng)求（復(fù)制 Pending 表格中的 Request ID）：

docker exec openclaw openclaw devices approve <Request-ID>

然后刷新頁(yè)面重新連接。

問(wèn)題 5：npm 安裝后內(nèi)網(wǎng)其他電腦無(wú)法訪問(wèn)

默認(rèn) Gateway 只監(jiān)聽(tīng)本機(jī)。配置步驟：

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

問(wèn)題 6：Docker 拉取鏡像報(bào)錯(cuò) denied

清理緩存后重試：

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

十、常用命令速查

CLI 命令

Docker 命令

十一、相關(guān)鏈接

結(jié)語(yǔ)

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

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

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

最新評(píng)論