你想了解 Moltbot、Clawdbot 與 OpenClaw 的本地安裝方法,首先要明確:三者是同一開源項目的不同階段名稱,本地安裝流程基本完全一致,優(yōu)先推薦安裝最新版 OpenClaw(向下兼容 Clawdbot/Moltbot 的所有功能與指令),下面我會提供詳細(xì)、可落地的本地安裝指南,分「新手快速安裝」和「進(jìn)階自定義安裝」,兼顧零基礎(chǔ)用戶和有技術(shù)基礎(chǔ)的用戶。
一、安裝前置準(zhǔn)備(必須滿足)
1. 環(huán)境要求
運行系統(tǒng):支持 macOS、Linux、Windows(僅支持 WSL2,不支持原生 Windows,建議安裝 WSL2 + Ubuntu 20.04 及以上)
核心依賴:Node.js ≥ 22.0.0(必須滿足版本要求,低版本會導(dǎo)致安裝失?。?
AI 模型支持(二選一即可):
云端 API:Claude Pro/Max(推薦)、OpenAI 訂閱(需 API Key)
本地大模型:Ollama(推薦)、LM Studio(需配置 OpenAI 兼容端點)
可選依賴:Docker(用于開啟沙箱隔離,提升安全性)、Tailscale(用于遠(yuǎn)程訪問)
2. 前置環(huán)境驗證(以 Linux/macOS/WSL2 為例)
bash
運行
# 1. 檢查 Node.js 版本(需 ≥22.0.0)
node -v
# 2. 若 Node.js 版本過低,安裝/升級 Node.js(以 nvm 為例,推薦 nvm 管理 Node 版本)
# 安裝 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 刷新環(huán)境變量
source ~/.bashrc (Ubuntu/WSL2)或 source ~/.zshrc(macOS)
# 安裝 Node.js 22 穩(wěn)定版
nvm install 22
nvm use 22
# 3. 驗證 Node.js 版本是否達(dá)標(biāo)
node -v # 輸出 v22.x.x 即合格
二、核心安裝流程(優(yōu)先最新版 OpenClaw)
方式一:新手快速安裝(5 分鐘搞定,推薦零基礎(chǔ)用戶)
該方法通過官方一鍵向?qū)瓿砂惭b,自動配置守護進(jìn)程,無需手動修改配置。
bash
運行
# 1. 全局安裝最新版 OpenClaw(兼容 Moltbot/Clawdbot 指令)
npm install -g openclaw@latest
# 補充:若想安裝舊版 Moltbot/Clawdbot,可執(zhí)行對應(yīng)命令(不推薦,僅兼容測試用)
# npm install -g moltbot@latest
# npm install -g clawdbot@latest
# 2. 運行官方初始化向?qū)Вㄗ詣影惭b守護進(jìn)程、配置基礎(chǔ)環(huán)境)
openclaw onboard --install-daemon
# 執(zhí)行后會出現(xiàn)交互式引導(dǎo),按提示操作:
# - 同意用戶協(xié)議
# - 選擇默認(rèn)安裝目錄(建議直接回車使用默認(rèn)路徑)
# - 配置是否開啟自動啟動(新手推薦開啟)
方式二:進(jìn)階手動安裝(適合需要自定義配置的用戶)
bash
運行
# 1. 全局安裝 OpenClaw
npm install -g openclaw@latest
# 2. 創(chuàng)建專屬配置目錄(手動管理配置文件)
mkdir -p ~/.openclaw/config
# 3. 生成基礎(chǔ)配置文件
openclaw init --config ~/.openclaw/config/openclaw.json
# 4. (可選)修改配置文件(自定義 AI 模型、消息平臺等,后續(xù)詳細(xì)說明)
# 可使用 vim 或記事本編輯配置文件
vim ~/.openclaw/config/openclaw.json
# 5. 安裝守護進(jìn)程(可選,實現(xiàn)后臺運行)
openclaw daemon install
3. 消息平臺配對(關(guān)鍵步驟,實現(xiàn)設(shè)備與 AI 助手通信)
無論哪種安裝方式,都需要配對消息平臺才能正常使用,以最常用的 WhatsApp 為例,Telegram 次之:
bash
運行
# 1. 啟動消息平臺配對工具
openclaw channels login
# 2. 選擇要配對的平臺(按回車選擇 WhatsApp,輸入對應(yīng)數(shù)字選擇其他平臺)
# - WhatsApp:會在終端生成二維碼,用手機 WhatsApp 「設(shè)置-鏈接設(shè)備」掃描即可配對
# - Telegram:需提前在 Telegram 中創(chuàng)建 Bot(@BotFather 獲取 Bot Token),按提示輸入 Token 即可完成配對
# 3. 驗證配對是否成功
openclaw channels list # 輸出已配對的平臺及狀態(tài),顯示「online」即成功
4. 啟動 OpenClaw 核心服務(wù)(網(wǎng)關(guān))
bash
運行
# 1. 快速啟動網(wǎng)關(guān)(默認(rèn)端口 18789)
openclaw gateway --port 18789
# 2. 進(jìn)階啟動(指定配置文件、開啟日志記錄)
openclaw gateway --config ~/.openclaw/config/openclaw.json --log ~/.openclaw/logs/openclaw.log --port 18789
# 3. 后臺運行(通過守護進(jìn)程,避免終端關(guān)閉后服務(wù)停止)
openclaw daemon start
# 驗證服務(wù)是否啟動成功
openclaw daemon status # 顯示「running」即成功
5. 首次交互驗證(確認(rèn)安裝成功)
通過已配對的 WhatsApp/Telegram 給 OpenClaw 發(fā)送消息:
plaintext
消息內(nèi)容:嗨,你能做什么?
若收到 OpenClaw 的回復(fù)(列出核心功能,如日歷管理、瀏覽器自動化等),說明本地安裝與配置全部成功。
三、舊名稱(Clawdbot/Moltbot)的兼容與遷移
指令兼容:安裝 OpenClaw 后,舊指令 moltbot、clawdbot 仍可使用(為兼容舊腳本保留的別名),例如:
bash
運行
moltbot gateway # 等價于 openclaw gateway
clawdbot channels login # 等價于 openclaw channels login
配置文件遷移:若之前安裝過 Moltbot/Clawdbot,可直接將舊配置文件復(fù)制到 OpenClaw 配置目錄,無需重新配置:
bash
運行
# 復(fù)制 Moltbot 配置到 OpenClaw
cp ~/.clawdbot/moltbot.json ~/.openclaw/config/openclaw.json
升級建議:舊版本不再維護安全補丁,建議盡快通過 npm install -g openclaw@latest 升級到最新版,避免安全風(fēng)險。
四、本地大模型配置(無需云端 API,完全私有化)
若不想依賴 Claude/OpenAI 云端 API,可搭配 Ollama 實現(xiàn)完全本地部署,步驟如下:
安裝 Ollama:前往 Ollama 官方網(wǎng)站 下載對應(yīng)系統(tǒng)版本,完成安裝后啟動 Ollama 服務(wù)。
拉取支持工具調(diào)用的本地模型(推薦 GLM-4.7-Flash 或 Llama 3.1):
bash
運行
ollama pull glm-4:7b-flash
修改 OpenClaw 配置文件,指定本地模型:
編輯 ~/.openclaw/config/openclaw.json,修改 agent 節(jié)點配置:
json
{
"agent": {
"model": "ollama/glm-4:7b-flash",
"endpoint": "http://127.0.0.1:11434/v1", // Ollama 默認(rèn) OpenAI 兼容端點
"apiKey": "ollama" // 固定值,無需修改
},
"channels": {
"whatsapp": {
"allowFrom": ["+1234567890"]
}
}
}
重啟 OpenClaw 服務(wù),即可使用本地大模型完成所有任務(wù),無需消耗云端 API 額度。
五、常見安裝問題排查
Node.js 版本過低報錯:提示 Unsupported engine,解決方案:通過 nvm 安裝 Node.js 22 及以上版本(參考前置環(huán)境配置)。
端口 18789 被占用:啟動網(wǎng)關(guān)時提示 EADDRINUSE,解決方案:更換端口,例如 openclaw gateway --port 18790。
WhatsApp 配對失?。憾S碼過期或掃描無反應(yīng),解決方案:關(guān)閉網(wǎng)關(guān)后重新執(zhí)行 openclaw channels login,確保手機網(wǎng)絡(luò)與電腦在同一局域網(wǎng)。
npm 安裝權(quán)限不足:提示 Permission denied,解決方案:添加 --unsafe-perm 參數(shù),npm install -g openclaw@latest --unsafe-perm。
總結(jié)
三者是同一項目的不同階段,優(yōu)先安裝最新版 OpenClaw,向下兼容 Moltbot/Clawdbot 的所有功能與指令。
本地安裝核心步驟:滿足 Node.js ≥22 環(huán)境 → 全局安裝包 → 消息平臺配對 → 啟動網(wǎng)關(guān)服務(wù)。
零基礎(chǔ)選「一鍵向?qū)О惭b」,需私有化部署選「Ollama + 本地模型」配置,避免依賴云端 API。
舊版本用戶可直接遷移配置文件,通過新指令啟動,無需重新搭建環(huán)境。
本資訊來自互聯(lián)網(wǎng),如有侵權(quán)強聯(lián)系刪除~