你想了解 Moltbot、Clawdbot 與 OpenClaw 的本地安裝方法，首先要明確：三者是同一開(kāi)源項(xiàng)目的不同階段名稱(chēng)，本地安裝流程基本完全一致，優(yōu)先推薦安裝最新版 OpenClaw（向下兼容 Clawdbot/Moltbot 的所有功能與指令），下面我會(huì)提供詳細(xì)、可落地的本地安裝指南，分「新手快速安裝」和「進(jìn)階自定義安裝」，兼顧零基礎(chǔ)用戶(hù)和有技術(shù)基礎(chǔ)的用戶(hù)。

一、安裝前置準(zhǔn)備（必須滿(mǎn)足）

1. 環(huán)境要求

運(yùn)行系統(tǒng)：支持 macOS、Linux、Windows（僅支持 WSL2，不支持原生 Windows，建議安裝 WSL2 + Ubuntu 20.04 及以上）

核心依賴(lài)：Node.js ≥ 22.0.0（必須滿(mǎn)足版本要求，低版本會(huì)導(dǎo)致安裝失?。?

AI 模型支持（二選一即可）：

云端 API：Claude Pro/Max（推薦）、OpenAI 訂閱（需 API Key）

本地大模型：Ollama（推薦）、LM Studio（需配置 OpenAI 兼容端點(diǎn)）

可選依賴(lài)：Docker（用于開(kāi)啟沙箱隔離，提升安全性）、Tailscale（用于遠(yuǎn)程訪問(wèn)）

2. 前置環(huán)境驗(yàn)證（以 Linux/macOS/WSL2 為例）

bash

運(yùn)行

# 1. 檢查 Node.js 版本（需 ≥22.0.0）

node -v

# 2. 若 Node.js 版本過(guò)低，安裝/升級(jí) 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. 驗(yàn)證 Node.js 版本是否達(dá)標(biāo)

node -v  # 輸出 v22.x.x 即合格

二、核心安裝流程（優(yōu)先最新版 OpenClaw）

方式一：新手快速安裝（5 分鐘搞定，推薦零基礎(chǔ)用戶(hù)）

該方法通過(guò)官方一鍵向?qū)瓿砂惭b，自動(dòng)配置守護(hù)進(jìn)程，無(wú)需手動(dòng)修改配置。

bash

運(yùn)行

# 1. 全局安裝最新版 OpenClaw（兼容 Moltbot/Clawdbot 指令）

npm install -g openclaw@latest

# 補(bǔ)充：若想安裝舊版 Moltbot/Clawdbot，可執(zhí)行對(duì)應(yīng)命令（不推薦，僅兼容測(cè)試用）

# npm install -g moltbot@latest

# npm install -g clawdbot@latest

# 2. 運(yùn)行官方初始化向?qū)Вㄗ詣?dòng)安裝守護(hù)進(jìn)程、配置基礎(chǔ)環(huán)境）

openclaw onboard --install-daemon

# 執(zhí)行后會(huì)出現(xiàn)交互式引導(dǎo)，按提示操作：

# - 同意用戶(hù)協(xié)議

# - 選擇默認(rèn)安裝目錄（建議直接回車(chē)使用默認(rèn)路徑）

# - 配置是否開(kāi)啟自動(dòng)啟動(dòng)（新手推薦開(kāi)啟）

方式二：進(jìn)階手動(dòng)安裝（適合需要自定義配置的用戶(hù)）

bash

運(yùn)行

# 1. 全局安裝 OpenClaw

npm install -g openclaw@latest

# 2. 創(chuàng)建專(zhuān)屬配置目錄（手動(dòng)管理配置文件）

mkdir -p ~/.openclaw/config

# 3. 生成基礎(chǔ)配置文件

openclaw init --config ~/.openclaw/config/openclaw.json

# 4. （可選）修改配置文件（自定義 AI 模型、消息平臺(tái)等，后續(xù)詳細(xì)說(shuō)明）

# 可使用 vim 或記事本編輯配置文件

vim ~/.openclaw/config/openclaw.json

# 5. 安裝守護(hù)進(jìn)程（可選，實(shí)現(xiàn)后臺(tái)運(yùn)行）

openclaw daemon install

3. 消息平臺(tái)配對(duì)（關(guān)鍵步驟，實(shí)現(xiàn)設(shè)備與 AI 助手通信）

無(wú)論哪種安裝方式，都需要配對(duì)消息平臺(tái)才能正常使用，以最常用的 WhatsApp 為例，Telegram 次之：

bash

運(yùn)行

# 1. 啟動(dòng)消息平臺(tái)配對(duì)工具

openclaw channels login

# 2. 選擇要配對(duì)的平臺(tái)（按回車(chē)選擇 WhatsApp，輸入對(duì)應(yīng)數(shù)字選擇其他平臺(tái)）

# - WhatsApp：會(huì)在終端生成二維碼，用手機(jī) WhatsApp 「設(shè)置-鏈接設(shè)備」掃描即可配對(duì)

# - Telegram：需提前在 Telegram 中創(chuàng)建 Bot（@BotFather 獲取 Bot Token），按提示輸入 Token 即可完成配對(duì)

# 3. 驗(yàn)證配對(duì)是否成功

openclaw channels list  # 輸出已配對(duì)的平臺(tái)及狀態(tài)，顯示「online」即成功

4. 啟動(dòng) OpenClaw 核心服務(wù)（網(wǎng)關(guān)）

bash

運(yùn)行

# 1. 快速啟動(dòng)網(wǎng)關(guān)（默認(rèn)端口 18789）

openclaw gateway --port 18789

# 2. 進(jìn)階啟動(dòng)（指定配置文件、開(kāi)啟日志記錄）

openclaw gateway --config ~/.openclaw/config/openclaw.json --log ~/.openclaw/logs/openclaw.log --port 18789

# 3. 后臺(tái)運(yùn)行（通過(guò)守護(hù)進(jìn)程，避免終端關(guān)閉后服務(wù)停止）

openclaw daemon start

# 驗(yàn)證服務(wù)是否啟動(dòng)成功

openclaw daemon status  # 顯示「running」即成功

5. 首次交互驗(yàn)證（確認(rèn)安裝成功）

通過(guò)已配對(duì)的 WhatsApp/Telegram 給 OpenClaw 發(fā)送消息：

plaintext

消息內(nèi)容：嗨，你能做什么？

若收到 OpenClaw 的回復(fù)（列出核心功能，如日歷管理、瀏覽器自動(dòng)化等），說(shuō)明本地安裝與配置全部成功。

三、舊名稱(chēng)（Clawdbot/Moltbot）的兼容與遷移

指令兼容：安裝 OpenClaw 后，舊指令 moltbot、clawdbot 仍可使用（為兼容舊腳本保留的別名），例如：

bash

運(yùn)行

moltbot gateway  # 等價(jià)于 openclaw gateway

clawdbot channels login  # 等價(jià)于 openclaw channels login

配置文件遷移：若之前安裝過(guò) Moltbot/Clawdbot，可直接將舊配置文件復(fù)制到 OpenClaw 配置目錄，無(wú)需重新配置：

bash

運(yùn)行

# 復(fù)制 Moltbot 配置到 OpenClaw

cp ~/.clawdbot/moltbot.json ~/.openclaw/config/openclaw.json

升級(jí)建議：舊版本不再維護(hù)安全補(bǔ)丁，建議盡快通過(guò) npm install -g openclaw@latest 升級(jí)到最新版，避免安全風(fēng)險(xiǎn)。

四、本地大模型配置（無(wú)需云端 API，完全私有化）

若不想依賴(lài) Claude/OpenAI 云端 API，可搭配 Ollama 實(shí)現(xiàn)完全本地部署，步驟如下：

安裝 Ollama：前往 Ollama 官方網(wǎng)站 下載對(duì)應(yīng)系統(tǒng)版本，完成安裝后啟動(dòng) Ollama 服務(wù)。

拉取支持工具調(diào)用的本地模型（推薦 GLM-4.7-Flash 或 Llama 3.1）：

bash

運(yùn)行

ollama pull glm-4:7b-flash

修改 OpenClaw 配置文件，指定本地模型：

編輯 ~/.openclaw/config/openclaw.json，修改 agent 節(jié)點(diǎn)配置：

json

{

"agent": {

"model": "ollama/glm-4:7b-flash",

"endpoint": "http://127.0.0.1:11434/v1",  // Ollama 默認(rèn) OpenAI 兼容端點(diǎn)

"apiKey": "ollama"  // 固定值，無(wú)需修改

},

"channels": {

"whatsapp": {

"allowFrom": ["+1234567890"]

}

}

}

重啟 OpenClaw 服務(wù)，即可使用本地大模型完成所有任務(wù)，無(wú)需消耗云端 API 額度。

五、常見(jiàn)安裝問(wèn)題排查

Node.js 版本過(guò)低報(bào)錯(cuò)：提示 Unsupported engine，解決方案：通過(guò) nvm 安裝 Node.js 22 及以上版本（參考前置環(huán)境配置）。

端口 18789 被占用：?jiǎn)?dòng)網(wǎng)關(guān)時(shí)提示 EADDRINUSE，解決方案：更換端口，例如 openclaw gateway --port 18790。

WhatsApp 配對(duì)失?。憾S碼過(guò)期或掃描無(wú)反應(yīng)，解決方案：關(guān)閉網(wǎng)關(guān)后重新執(zhí)行 openclaw channels login，確保手機(jī)網(wǎng)絡(luò)與電腦在同一局域網(wǎng)。

npm 安裝權(quán)限不足：提示 Permission denied，解決方案：添加 --unsafe-perm 參數(shù)，npm install -g openclaw@latest --unsafe-perm。

總結(jié)

三者是同一項(xiàng)目的不同階段，優(yōu)先安裝最新版 OpenClaw，向下兼容 Moltbot/Clawdbot 的所有功能與指令。

本地安裝核心步驟：滿(mǎn)足 Node.js ≥22 環(huán)境 → 全局安裝包 → 消息平臺(tái)配對(duì) → 啟動(dòng)網(wǎng)關(guān)服務(wù)。

零基礎(chǔ)選「一鍵向?qū)О惭b」，需私有化部署選「Ollama + 本地模型」配置，避免依賴(lài)云端 API。

舊版本用戶(hù)可直接遷移配置文件，通過(guò)新指令啟動(dòng)，無(wú)需重新搭建環(huán)境。

本資訊來(lái)自互聯(lián)網(wǎng)，如有侵權(quán)強(qiáng)聯(lián)系刪除~