Moltbot 核心官網(wǎng)入口

Moltbot 官方主頁(yè)：https://molt.bot/ （原名 Clawdbot，2026 年 1 月 27 日正式更名）

官方文檔中心：https://docs.molt.bot/ （推薦，包含完整安裝、配置、技能開(kāi)發(fā)指南）

GitHub 倉(cāng)庫(kù)（最新源碼）：https://github.com/moltbot/moltbot

技能市場(chǎng)（ClawdHub）：https://clawdhub.com/ （100 + 社區(qū)開(kāi)發(fā)的技能，如 Todoist 集成、財(cái)務(wù)跟蹤）

Discord 社區(qū)（技術(shù)支持）：https://discord.gg/clawd （8,900 + 成員，實(shí)時(shí)問(wèn)題解答）

重要提示：Moltbot 是 Clawdbot 的正式更名版本，原 Clawdbot 官網(wǎng)（https://clawd.bot/）會(huì)自動(dòng)跳轉(zhuǎn)至 Moltbot 主頁(yè)，所有功能保持不變，僅品牌標(biāo)識(shí)更新。

Moltbot 在線使用指南

1. 官方核心文檔資源（推薦優(yōu)先閱讀）

文檔類型 鏈接 適用場(chǎng)景

快速入門向?qū)?https://docs.molt.bot/getting-started 5 分鐘完成基礎(chǔ)安裝與首次交互

消息平臺(tái)配置 https://docs.molt.bot/channels WhatsApp/Telegram/Discord 等平臺(tái)配對(duì)教程

模型配置指南 https://docs.molt.bot/models 云端 API（Claude/OpenAI）與本地模型（Ollama）設(shè)置

主動(dòng)消息功能 https://docs.molt.bot/features/proactive-messaging 設(shè)置提醒、警報(bào)、每日簡(jiǎn)報(bào)等主動(dòng)通知

安全最佳實(shí)踐 https://docs.molt.bot/security DM 配對(duì)、Docker 沙箱、權(quán)限管控等安全設(shè)置

命令行參考 https://docs.molt.bot/cli 完整 CLI 命令說(shuō)明，含moltbot onboard、moltbot gateway等

2. 5 分鐘快速上手流程（零基礎(chǔ)用戶推薦）

前置條件（必須滿足）

操作系統(tǒng)：macOS、Linux 或 Windows（僅支持 WSL2，不支持原生 Windows）

Node.js ≥22.0.0（核心依賴，低版本會(huì)導(dǎo)致安裝失敗）

AI 模型支持：Claude Pro/Max API 密鑰、OpenAI API 密鑰或 Ollama 本地模型（二選一）

安裝與初始化命令（直接復(fù)制執(zhí)行）

bash

運(yùn)行

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

npm install -g moltbot@latest

# 2. 一鍵啟動(dòng)官方初始化向?qū)Вㄗ詣?dòng)配置網(wǎng)關(guān)、工作空間、消息平臺(tái)）

moltbot onboard --install-daemon

# 3. 消息平臺(tái)配對(duì)（選擇WhatsApp/Telegram等，按提示完成）

moltbot channels login

# 4. 啟動(dòng)核心網(wǎng)關(guān)服務(wù)（默認(rèn)端口18789）

moltbot gateway --port 18789

# 5. 驗(yàn)證安裝成功（通過(guò)配對(duì)的消息平臺(tái)發(fā)送）

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

向?qū)Ы换リP(guān)鍵步驟

同意用戶協(xié)議

選擇安裝模式（推薦quickstart快速模式）

配置 AI 模型（輸入 API 密鑰或選擇本地模型）

選擇消息平臺(tái)（優(yōu)先 WhatsApp/Telegram，操作簡(jiǎn)單）

開(kāi)啟守護(hù)進(jìn)程（推薦，實(shí)現(xiàn)后臺(tái)自動(dòng)運(yùn)行）

3. 核心功能使用指南（常用場(chǎng)景）

（1）消息平臺(tái)配對(duì)詳細(xì)教程

平臺(tái) 配對(duì)步驟 關(guān)鍵注意事項(xiàng)

WhatsApp 1. 執(zhí)行moltbot channels login→選擇 WhatsApp

2. 終端生成二維碼

3. 手機(jī) WhatsApp「設(shè)置 - 鏈接設(shè)備」掃描二維碼 確保手機(jī)與電腦在同一局域網(wǎng)，二維碼有效期 2 分鐘

Telegram 1. 執(zhí)行moltbot channels login→選擇 Telegram

2. 輸入 BotFather 獲取的 Bot Token

3. 發(fā)送/start到機(jī)器人完成配對(duì) 需先在 Telegram 搜索 @BotFather 創(chuàng)建機(jī)器人獲取 Token

Discord 1. 執(zhí)行moltbot channels login→選擇 Discord

2. 輸入 Bot Token

3. 邀請(qǐng)機(jī)器人到服務(wù)器 需在 Discord 開(kāi)發(fā)者平臺(tái)創(chuàng)建應(yīng)用并添加 Bot 權(quán)限

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

安裝 Ollama（本地大模型運(yùn)行環(huán)境）：https://ollama.com/

拉取支持工具調(diào)用的模型：ollama pull glm-4:7b-flash

修改 Moltbot 配置文件（~/.clawdbot/moltbot.json）：

json

{

"agent": {

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

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

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

}

}

重啟網(wǎng)關(guān)：moltbot gateway restart

（3）常用命令速查（高效管理）

bash

運(yùn)行

moltbot status        # 檢查服務(wù)狀態(tài)

moltbot health        # 系統(tǒng)健康檢查

moltbot logs --follow # 實(shí)時(shí)查看日志

moltbot configure     # 交互配置工具

moltbot skills list   # 查看已安裝技能

moltbot daemon start  # 啟動(dòng)守護(hù)進(jìn)程

4. 本地 Web UI 使用（可視化管理）

安裝成功并啟動(dòng)網(wǎng)關(guān)后，通過(guò)瀏覽器訪問(wèn)：

Web 控制臺(tái)：http://127.0.0.1:18789/ （管理會(huì)話、查看狀態(tài)、調(diào)試）

Web 聊天界面：http://127.0.0.1:18789/webui （直接與 AI 助手交互，無(wú)需消息平臺(tái)）

5. 常見(jiàn)問(wèn)題排查（快速解決）

Node.js 版本過(guò)低：提示Unsupported engine → 通過(guò) nvm 安裝 Node.js 22+

bash

運(yùn)行

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

nvm install 22 && nvm use 22

端口 18789 被占用：提示EADDRINUSE → 更換端口：moltbot gateway --port 18790

WhatsApp 配對(duì)失敗：二維碼掃描無(wú)反應(yīng) → 關(guān)閉網(wǎng)關(guān)后重新執(zhí)行moltbot channels login

npm 安裝權(quán)限不足：提示Permission denied → 添加--unsafe-perm參數(shù)：

bash

運(yùn)行

npm install -g moltbot@latest --unsafe-perm

三、兼容性說(shuō)明（與 Clawdbot）

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

bash

運(yùn)行

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

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

配置文件遷移：Clawdbot 的配置文件可直接復(fù)制到 Moltbot 配置目錄

bash

運(yùn)行

cp ~/.clawdbot/clawdbot.json ~/.clawdbot/moltbot.json

功能完全兼容：Moltbot 保留了 Clawdbot 的所有核心功能，并新增了更多模型支持和安全特性

四、進(jìn)階學(xué)習(xí)資源

技能開(kāi)發(fā)指南：https://docs.molt.bot/skills-development （創(chuàng)建自定義技能）

多代理編排：https://docs.molt.bot/agents/multi-agent （多個(gè) AI 代理協(xié)作完成復(fù)雜任務(wù)）

Docker 部署：https://docs.molt.bot/deployment/docker （容器化部署，提升安全性）

中文社區(qū)教程：https://clawdbotcn.cn/moltbot.html （適合國(guó)內(nèi)用戶的詳細(xì)指南）

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