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

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

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

GitHub 倉庫（最新源碼）：https://github.com/moltbot/moltbot

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

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

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

Moltbot 在線使用指南

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

文檔類型 鏈接 適用場景

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

消息平臺配置 https://docs.molt.bot/channels WhatsApp/Telegram/Discord 等平臺配對教程

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

主動消息功能 https://docs.molt.bot/features/proactive-messaging 設(shè)置提醒、警報、每日簡報等主動通知

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

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

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

前置條件（必須滿足）

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

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

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

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

bash

運行

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

npm install -g moltbot@latest

# 2. 一鍵啟動官方初始化向?qū)Вㄗ詣优渲镁W(wǎng)關(guān)、工作空間、消息平臺）

moltbot onboard --install-daemon

# 3. 消息平臺配對（選擇WhatsApp/Telegram等，按提示完成）

moltbot channels login

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

moltbot gateway --port 18789

# 5. 驗證安裝成功（通過配對的消息平臺發(fā)送）

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

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

同意用戶協(xié)議

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

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

選擇消息平臺（優(yōu)先 WhatsApp/Telegram，操作簡單）

開啟守護(hù)進(jìn)程（推薦，實現(xiàn)后臺自動運行）

3. 核心功能使用指南（常用場景）

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

平臺 配對步驟 關(guān)鍵注意事項

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

2. 終端生成二維碼

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

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

2. 輸入 BotFather 獲取的 Bot Token

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

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

2. 輸入 Bot Token

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

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

安裝 Ollama（本地大模型運行環(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)端點

"apiKey": "ollama"  // 固定值，無需修改

}

}

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

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

bash

運行

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

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

moltbot logs --follow # 實時查看日志

moltbot configure     # 交互配置工具

moltbot skills list   # 查看已安裝技能

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

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

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

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

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

5. 常見問題排查（快速解決）

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

bash

運行

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 配對失?。憾S碼掃描無反應(yīng) → 關(guān)閉網(wǎng)關(guān)后重新執(zhí)行moltbot channels login

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

bash

運行

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

三、兼容性說明（與 Clawdbot）

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

bash

運行

clawdbot gateway  # 等價于 moltbot gateway

clawdbot channels login  # 等價于 moltbot channels login

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

bash

運行

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

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

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

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

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

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

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

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