寫(xiě)在前面

最近技術(shù)圈被一只"小龍蝦"刷屏了——OpenClaw（前身Clawdbot/Moltbot）。作為GitHub史上增長(zhǎng)最快的開(kāi)源項(xiàng)目之一，它不像ChatGPT那樣只會(huì)"說(shuō)話"，而是真正能動(dòng)手做事的AI Agent：瀏覽網(wǎng)頁(yè)、執(zhí)行命令、管理文件、甚至幫你寫(xiě)代碼。

但說(shuō)實(shí)話，官方文檔對(duì)國(guó)內(nèi)用戶不夠友好，我在部署過(guò)程中踩了不少坑。這篇文章記錄從0到1的完整部署流程，以及我整理的中文優(yōu)化資料，希望能幫你少走冤枉路。

一、OpenClaw是什么？為什么值得折騰？

簡(jiǎn)單來(lái)說(shuō)，OpenClaw是一個(gè)運(yùn)行在你自己服務(wù)器上的高權(quán)限AI智能體。與SaaS類AI服務(wù)不同，它：

• 數(shù)據(jù)自主可控：所有操作在本地/云端服務(wù)器完成，敏感信息不出境
• 7×24小時(shí)待命：部署后通過(guò)Telegram、飛書(shū)、釘釘?shù)惹离S時(shí)喚醒
• 真正"動(dòng)手"能力：不是給建議，而是直接執(zhí)行命令、操作瀏覽器、讀寫(xiě)文件

特別適合需要自動(dòng)化處理重復(fù)工作的開(kāi)發(fā)者，比如定時(shí)拉取數(shù)據(jù)生成報(bào)表、自動(dòng)回復(fù)標(biāo)準(zhǔn)化咨詢、遠(yuǎn)程執(zhí)行服務(wù)器維護(hù)等場(chǎng)景。

二、部署前的準(zhǔn)備工作

根據(jù)官方要求和個(gè)人實(shí)戰(zhàn)經(jīng)驗(yàn)，建議按以下配置準(zhǔn)備：

特別提醒：國(guó)內(nèi)服務(wù)器訪問(wèn)GitHub/npm可能不穩(wěn)定，建議提前配置代理或使用鏡像源。

三、實(shí)戰(zhàn)部署：三步走策略

第一步：環(huán)境初始化（5分鐘）

安裝Git和Node.js環(huán)境。這里有個(gè)避坑點(diǎn)：不要用apt直接裝Node.js，版本可能不兼容。

# 安裝NVM（國(guó)內(nèi)用戶建議用Gitee鏡像）
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
source ~/.bashrc
# 安裝Node.js 22
nvm install 22
nvm use 22
node -v  # 確認(rèn)輸出v22.x.x

第二步：安裝OpenClaw（3分鐘）

官方提供了一鍵安裝腳本，但國(guó)內(nèi)網(wǎng)絡(luò)環(huán)境下可能中斷。如果遇到問(wèn)題，可以參考我整理的離線安裝方案（見(jiàn)文末資料站）。

# 官方一鍵安裝（網(wǎng)絡(luò)通暢時(shí)）
curl -fsSL https://openclaw.ai/install.sh | bash
# 或通過(guò)npm安裝（更穩(wěn)定）
npm install -g openclaw@latest

安裝完成后，首次運(yùn)行會(huì)看到一個(gè)ASCII藝術(shù)小龍蝦和交互式配置向?qū)В?/p>

?████?█?????█████?█???█?███??████??████???█?
              ?? FRESH DAILY ??

第三步：配置向?qū)г斀猓?0分鐘）

運(yùn)行openclaw onboard --install-daemon進(jìn)入配置，關(guān)鍵步驟如下：

1. 安全確認(rèn) 向?qū)?huì)明確提示風(fēng)險(xiǎn)：Agent可以執(zhí)行命令、讀寫(xiě)文件。輸入yes繼續(xù)。

2. 選擇AI后端 國(guó)內(nèi)用戶強(qiáng)烈推薦選擇通義千問(wèn)(Qwen)或GLM：

• 前往阿里云百煉或智譜AI創(chuàng)建API Key
• 免費(fèi)額度通常足夠個(gè)人使用數(shù)月

3. 配置消息渠道

• 新手建議選Telegram Bot（最簡(jiǎn)單，5分鐘搞定）
• 國(guó)內(nèi)辦公場(chǎng)景可選飛書(shū)或釘釘，需額外配置Webhook

4. 安裝守護(hù)進(jìn)程 選擇--install-daemon參數(shù)會(huì)自動(dòng)創(chuàng)建系統(tǒng)服務(wù)，實(shí)現(xiàn)開(kāi)機(jī)自啟。

四、進(jìn)階配置：讓AI真正"可用"

基礎(chǔ)部署完成后，還需要三個(gè)關(guān)鍵配置才能真正投入生產(chǎn)：

1. 持久化記憶配置

OpenClaw通過(guò)本地Markdown文件存儲(chǔ)偏好，編輯~/.openclaw/openclaw.json：

{
  "agent": {
    "memory": {
      "enabled": true,
      "storagePath": "~/.openclaw/memory"
    }
  }
}

2. 安全沙箱（強(qiáng)烈推薦）

默認(rèn)情況下Agent擁有較高權(quán)限，建議啟用Docker沙箱隔離：

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main",
        "docker": {
          "image": "openclaw-sandbox:bookworm-slim",
          "network": "none"
        }
      }
    }
  }
}

3. 防火墻與端口

確保服務(wù)器放行18789端口（Gateway默認(rèn)端口）：

sudo ufw allow 18789/tcp
# 或云服務(wù)器安全組配置

五、國(guó)內(nèi)部署的特殊技巧

由于網(wǎng)絡(luò)環(huán)境差異，國(guó)內(nèi)部署需要一些"土辦法"：

鏡像加速：npm和Docker拉取經(jīng)常超時(shí)，建議使用淘寶NPM鏡像、阿里云Docker鏡像等國(guó)內(nèi)源。

模型選擇：實(shí)測(cè)通義千問(wèn)Qwen2.5-coder在代碼任務(wù)上表現(xiàn)優(yōu)異，且阿里云免費(fèi)額度 generous。配置示例：

{
  "agent": {
    "model": "qwen2.5-coder:32b",
    "providers": {
      "qwen": {
        "apiKey": "sk-your-key",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }
    }
  }
}

移動(dòng)端訪問(wèn)：部署完成后，通過(guò)飛書(shū)/釘釘接入可以實(shí)現(xiàn)手機(jī)遠(yuǎn)程操控家里或公司的電腦，這是目前最符合國(guó)內(nèi)使用習(xí)慣的方案。

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

七、寫(xiě)在最后

OpenClaw代表了AI Agent從"玩具"走向"工具"的轉(zhuǎn)折點(diǎn)。雖然部署過(guò)程比ChatGPT復(fù)雜，但換來(lái)的是完全的數(shù)據(jù)所有權(quán)和無(wú)限的定制化能力。

如果你在部署過(guò)程中遇到文檔里沒(méi)提到的問(wèn)題，歡迎交流。文中提到的配置文件模板、鏡像加速地址、以及各平臺(tái)Bot創(chuàng)建的具體截圖步驟，我都匯總了方便隨時(shí)查閱。

畢竟，配置一次，受益良久。當(dāng)你的AI助手開(kāi)始在凌晨三點(diǎn)自動(dòng)處理郵件時(shí)，你會(huì)感謝現(xiàn)在折騰的自己。

參考資源：

• OpenClaw官方文檔: docs.openclaw.ai
• 阿里云部署指南: 開(kāi)發(fā)者社區(qū)

到此這篇關(guān)于OpenClaw配置部署完整實(shí)戰(zhàn)指南(附踩坑記錄)的文章就介紹到這了,更多相關(guān)OpenClaw配置部署內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論