OpenClaw第三方開(kāi)源漢化中文發(fā)行版部署全指南以及常見(jiàn)問(wèn)題解決方法
我要評(píng)論OpenClaw這是什么？
OpenClaw（曾用名 Clawdbot / Moltbot）是一個(gè)開(kāi)源的個(gè)人 AI 助手平臺(tái)（GitHub 120k+ Stars），可以通過(guò) WhatsApp 、Telegram、Discord 等聊天軟件與 AI 交互。簡(jiǎn)單說(shuō)就是：在你自己的機(jī)器上運(yùn)行一個(gè) AI 助手，通過(guò)常用聊天軟件跟它對(duì)話(huà)。
forks項(xiàng)目倉(cāng)庫(kù) ：https://github.com/MaoTouHU/OpenClawChinese
原版是全英文的，開(kāi)源社區(qū)伙伴做了一個(gè)中文發(fā)行版：
漢化效果預(yù)覽
先看看效果，Dashboard 界面全中文：
概覽儀表板 - 網(wǎng)關(guān)狀態(tài)、實(shí)例監(jiān)控、快捷操作一目了然：
對(duì)話(huà)界面 - 與 AI 助手實(shí)時(shí)交互：
渠道管理 - WhatsApp、Telegram 、Discord 等多平臺(tái)支持：
配置中心 - 30+ 配置項(xiàng)完整漢化：
節(jié)點(diǎn)配置 - 執(zhí)行審批、安全策略管理：
技能插件 - 1Password、Apple Notes 等豐富擴(kuò)展：
環(huán)境要求
檢查 Node.js 版本：
node -v # 輸出應(yīng)該是 v22.x.x 或更高
如果版本不夠，去 Node.js 官網(wǎng) 下載最新 LTS 版本，或者用 nvm 管理：
# Linux/macOS curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash nvm install 22 nvm use 22 # Windows 用 nvm-windows # https://github.com/coreybutler/nvm-windows
安裝方式
提供三種方式，根據(jù)自己情況選擇。
方式 A：一鍵腳本（推薦新手）
最簡(jiǎn)單的方式，下載執(zhí)行腳本自動(dòng)完成安裝。
Linux / macOS：
curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.sh && bash install.sh
Windows PowerShell：
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/OpenClawChinese@main/install.ps1" -OutFile "install.ps1"; .\install.ps1
腳本會(huì)自動(dòng)：
檢查 Node.js 版本
安裝中文版 npm 包
嘗試運(yùn)行初始化配置
方式 B：npm 手動(dòng)安裝
如果腳本有問(wèn)題，可以手動(dòng)安裝：
# 穩(wěn)定版（推薦） npm install -g @qingchencloud/openclaw-zh@latest # 或者 nightly 版（每小時(shí)同步上游最新代碼） npm install -g @qingchencloud/openclaw-zh@nightly
驗(yàn)證安裝：
openclaw --version openclaw --help
如果 --help 輸出是中文，說(shuō)明安裝成功。
方式 C：Docker 部署 （服務(wù)器推薦）
在服務(wù)器 上運(yùn)行，或者不想污染本地環(huán)境，用 Docker。
快速啟動(dòng)（本地訪問(wèn)）：
# 1. 初始化配置 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 # 2. 啟動(dòng) docker run -d \ --name openclaw \ -p 18789:18789 \ -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly \ openclaw gateway run
啟動(dòng)后訪問(wèn) http://localhost:18789 打開(kāi) Dashboard。
首次配置
安裝完成后，需要進(jìn)行初始化 配置。
運(yùn)行初始化向?qū)?/p>
openclaw onboard
這是一個(gè)交互式向?qū)?，?huì)引導(dǎo)你完成：
選擇 AI 模型：支持 Claude、GPT、本地模型等
配置 API Key：根據(jù)選擇的模型輸入對(duì)應(yīng)的 API Key
設(shè)置聊天通道：可以連接 WhatsApp、Telegram 等
創(chuàng)建助手人格：給你的 AI 起個(gè)名字，設(shè)置性格
整個(gè)過(guò)程都是中文界面，跟著提示走就行。
安裝守護(hù)進(jìn)程（可選）
如果希望 OpenClaw 在后臺(tái)持續(xù)運(yùn)行：
openclaw onboard --install-daemon
常用命令速查
openclaw # 啟動(dòng)（交互模式） openclaw onboard # 初始化向?qū)? openclaw config # 查看配置 openclaw config set key val # 修改配置 openclaw skills # 管理技能插件 openclaw status # 查看運(yùn)行狀態(tài) openclaw gateway run # 啟動(dòng)網(wǎng)關(guān)（Dashboard）
Docker 服務(wù)器部署詳解
這部分重點(diǎn)講一下在服務(wù)器上部署并遠(yuǎn)程訪問(wèn)的配置，因?yàn)檫@里坑比較多。
本地訪問(wèn) vs 遠(yuǎn)程訪問(wèn)
為什么遠(yuǎn)程訪問(wèn)需要額外配置？
OpenClaw 的 Dashboard 使用 Web Crypto API 進(jìn)行設(shè)備身份驗(yàn)證，這個(gè) API 在非 HTTPS 環(huán)境下只能在 localhost 使用。簡(jiǎn)單說(shuō)就是：通過(guò) HTTP 遠(yuǎn)程訪問(wèn)時(shí)，瀏覽器安全策略會(huì)阻止認(rèn)證。
方式 1：一鍵部署腳本（推薦）
項(xiàng)目提供了一鍵部署腳本，自動(dòng)完成環(huán)境檢測(cè)、初始化、配置遠(yuǎn)程訪問(wèn)：
# 自動(dòng)生成 Token curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash # 或者指定 Token curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash -s -- --token 你的密碼 # 僅本地訪問(wèn)（不配置遠(yuǎn)程） curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-deploy.sh | bash -s -- --local-only
腳本會(huì)自動(dòng)：
檢查 Docker 環(huán)境
拉取鏡像
創(chuàng)建數(shù)據(jù)卷
初始化配置
配置遠(yuǎn)程訪問(wèn)（Token 認(rèn)證）
啟動(dòng)容器
部署完成后會(huì)顯示訪問(wèn)地址和 Token。
方式 2：手動(dòng)配置步驟
如果想手動(dòng)控制每一步：
# 1. 創(chuàng)建數(shù)據(jù)卷 docker volume create openclaw-data # 2. 初始化 docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly openclaw setup # 3. 配置網(wǎng)關(guān)模式 docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.mode local # 4. 配置遠(yuǎn)程訪問(wèn)（允許局域網(wǎng)訪問(wèn)） docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.bind lan # 5. 設(shè)置訪問(wèn)令牌（重要！遠(yuǎn)程訪問(wèn)必須） docker run --rm -v openclaw-data:/root/.openclaw \ ghcr.io/1186258278/openclaw-zh:nightly openclaw config set gateway.auth.token 你的密碼 # 6. 啟動(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) http://服務(wù)器IP:18789，在「網(wǎng)關(guān)令牌」輸入框填入你設(shè)置的 Token，點(diǎn)擊連接即可。
方式 3：Docker Compose
項(xiàng)目提供了 docker-compose.yml：
# 下載配置文件 curl -fsSL https://cdn.jsdelivr.net/gh/OpenClawChinese@main/docker-compose.yml -o docker-compose.yml
配置文件內(nèi)容：
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=${OPENCLAW_GATEWAY_TOKEN:-}
restart: unless-stopped
command: openclaw gateway run --allow-unconfigured
volumes:
openclaw-data:
name: openclaw-data首次需要初始化配置：
# 啟動(dòng)容器（首次會(huì)自動(dòng)創(chuàng)建卷） docker-compose up -d # 初始化配置 docker-compose exec openclaw openclaw setup docker-compose exec openclaw openclaw config set gateway.mode local # 遠(yuǎn)程訪問(wèn)配置（可選） docker-compose exec openclaw openclaw config set gateway.bind lan docker-compose exec openclaw openclaw config set gateway.auth.token 你的密碼 # 重啟生效 docker-compose restart
踩坑記錄
分享幾個(gè)實(shí)際踩過(guò)的坑：
坑 1：掛載路徑錯(cuò)誤
OpenClaw 容器以 root 用戶(hù)運(yùn)行，配置文件在 /root/.openclaw，不是 /home/node/.openclaw。
# 錯(cuò)誤（配置不會(huì)持久化） -v openclaw-data:/home/node/.openclaw # 正確 -v openclaw-data:/root/.openclaw
坑 2：必須先初始化再啟動(dòng)
容器啟動(dòng)前必須先運(yùn)行 openclaw setup，否則會(huì)報(bào)錯(cuò)：
Missing config. Run openclaw setup
使用一鍵腳本或按照上面的步驟順序執(zhí)行就不會(huì)遇到這個(gè)問(wèn)題。
坑 3：遠(yuǎn)程訪問(wèn)報(bào) 1008 錯(cuò)誤
如果看到這樣的錯(cuò)誤：
disconnected (1008): control ui requires HTTPS or localhost disconnected (1008): device identity required
這是因?yàn)闆](méi)有配置 Token。瀏覽器安全策略阻止了非 HTTPS 環(huán)境下的設(shè)備認(rèn)證。
解決方法：設(shè)置 gateway.auth.token
# 容器已運(yùn)行的情況下 docker exec openclaw openclaw config set gateway.auth.token 你的密碼 docker restart openclaw
然后在 Dashboard 的「網(wǎng)關(guān)令牌」輸入框填入 Token 連接。
坑 4：allowInsecureAuth 配置不生效
官方文檔提到的 gateway.controlUi.allowInsecureAuth: true 配置存在上游 Bug，單獨(dú)使用不起作用。必須配合 gateway.auth.token 使用。
坑 5：package: 拉取 Docker 鏡像…Error response
:package: 拉取 Docker 鏡像… Error response from daemon: error from registry: denied denied root@racknerd-bbcd572:~# curl -sL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/docker-deploy.sh | grep “IMAGE=” IMAGE=“ghcr.io/qingchencloud/openclaw-zh:latest” root@racknerd-bbcd572:~#
常見(jiàn)問(wèn)題
Q：安裝后運(yùn)行還是英文？
可能安裝了原版。先卸載再安裝中文版：
npm uninstall -g openclaw npm install -g @qingchencloud/openclaw-zh@latest
Q：Dashboard 打不開(kāi)？
確認(rèn)容器在運(yùn)行：docker ps
確認(rèn)端口沒(méi)被占用：netstat -tlnp | grep 18789
查看容器日志：docker logs openclaw
Q：Docker 重啟后配置丟失？
檢查掛載路徑是否正確（應(yīng)該是 /root/.openclaw），以及是否使用了命名卷而不是匿名卷。
Q：如何更新到最新版？
# npm 安裝 npm update -g @qingchencloud/openclaw-zh # Docker docker pull ghcr.io/1186258278/openclaw-zh:nightly docker stop openclaw && docker rm openclaw # 重新啟動(dòng)（配置保留在數(shù)據(jù)卷中） 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
Q：如何徹底卸載？
# 卸載 npm 包 npm uninstall -g @qingchencloud/openclaw-zh # 刪除配置文件（可選，會(huì)刪除所有數(shù)據(jù)） rm -rf ~/.openclaw # Docker 方式 docker stop openclaw && docker rm openclaw docker volume rm openclaw-data
其他遠(yuǎn)程訪問(wèn)方案
除了 Token 認(rèn)證，還有其他方案：
常用 Docker 命令
# 查看日志 docker logs -f openclaw # 重啟服務(wù) docker restart openclaw # 停止服務(wù) docker stop openclaw # 進(jìn)入容器 docker exec -it openclaw sh # 查看當(dāng)前配置 docker exec openclaw cat /root/.openclaw/openclaw.json
版本說(shuō)明
中文發(fā)行版提供兩個(gè)版本：
推薦日常使用穩(wěn)定版，想體驗(yàn)最新功能用 nightly。
官方發(fā)布新功能后，中文版最快 1 小時(shí)內(nèi)可用。
總結(jié)
這個(gè)中文發(fā)行版會(huì)每小時(shí)自動(dòng)同步上游更新，功能和官方保持一致，界面是中文的，開(kāi)箱即用。
如果使用過(guò)程中遇到問(wèn)題，可以在 GitHub 倉(cāng)庫(kù)提 Issue。也歡迎有興趣的佬友參與貢獻(xiàn)。
到此這篇關(guān)于OpenClaw第三方開(kāi)源漢化中文發(fā)行版部署全指南的文章就介紹到這了,更多相關(guān)OpenClaw安裝部署教程內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！
相關(guān)文章
OpenClaw安裝部署及應(yīng)用場(chǎng)景教程(2026最新完整版)
本文將從OpenClaw核心介紹、兩種主流安裝部署方案（新手友好型+深度定制型）、高頻避坑指南，到實(shí)際應(yīng)用場(chǎng)景全解析，全程實(shí)操落地，適合各類(lèi)需求的使用者，收藏備用2026-03-02
OpenClaw安裝排錯(cuò)方法筆記(含基本使用命令)
OpenClaw(原Clawdbot/Moltbot)是一款開(kāi)源的本地優(yōu)先AI代理與自動(dòng)化平臺(tái),支持多渠道通信集成、大模型調(diào)用及自動(dòng)化任務(wù)執(zhí)行,可滿(mǎn)足個(gè)人與小型團(tuán)隊(duì)的智能輔助需求,這篇文章主2026-03-02
超輕量級(jí)OpenClaw本地部署與一鍵安裝、配置指南
OpenClaw超輕量版本地部署指南介紹了一個(gè)功能完整且輕量級(jí)的AI助手,適用于學(xué)習(xí)和使用,該指南詳細(xì)介紹了環(huán)境準(zhǔn)備、快速安裝、基礎(chǔ)配置、核心功能體驗(yàn)等步驟，安裝配置過(guò)程比2026-03-02
Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程
在 Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程，你可以讓它運(yùn)行在自己的電腦上，通過(guò) WhatsApp、Telegram、Discord、Slack 等你已經(jīng)在用的聊天軟件與它對(duì)話(huà)2026-03-01
OpenClaw 完整本地部署安裝與使用指南(接入飛書(shū))
本文詳細(xì)介紹了在macOS/Linux/Windows系統(tǒng)上進(jìn)行本地部署的步驟,并展示了如何配置飛書(shū)機(jī)器人以實(shí)現(xiàn)飛書(shū)內(nèi)的AI對(duì)話(huà),文中通過(guò)示例代碼介紹的非常詳細(xì)，需要的朋友們下面隨著2026-03-05
