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