Moltbot 核心官網入口
Moltbot 官方主頁:https://molt.bot/ (原名 Clawdbot,2026 年 1 月 27 日正式更名)
官方文檔中心:https://docs.molt.bot/ (推薦,包含完整安裝、配置、技能開發指南)
GitHub 倉庫(最新源碼):https://github.com/moltbot/moltbot
技能市場(ClawdHub):https://clawdhub.com/ (100 + 社區開發的技能,如 Todoist 集成、財務跟蹤)
Discord 社區(技術支持):https://discord.gg/clawd (8,900 + 成員,實時問題解答)
重要提示:Moltbot 是 Clawdbot 的正式更名版本,原 Clawdbot 官網(https://clawd.bot/)會自動跳轉至 Moltbot 主頁,所有功能保持不變,僅品牌標識更新。
Moltbot 在線使用指南
1. 官方核心文檔資源(推薦優先閱讀)
文檔類型 鏈接 適用場景
快速入門向導 https://docs.molt.bot/getting-started 5 分鐘完成基礎安裝與首次交互
消息平臺配置 https://docs.molt.bot/channels WhatsApp/Telegram/Discord 等平臺配對教程
模型配置指南 https://docs.molt.bot/models 云端 API(Claude/OpenAI)與本地模型(Ollama)設置
主動消息功能 https://docs.molt.bot/features/proactive-messaging 設置提醒、警報、每日簡報等主動通知
安全最佳實踐 https://docs.molt.bot/security DM 配對、Docker 沙箱、權限管控等安全設置
命令行參考 https://docs.molt.bot/cli 完整 CLI 命令說明,含moltbot onboard、moltbot gateway等
2. 5 分鐘快速上手流程(零基礎用戶推薦)
前置條件(必須滿足)
操作系統:macOS、Linux 或 Windows(僅支持 WSL2,不支持原生 Windows)
Node.js ≥22.0.0(核心依賴,低版本會導致安裝失?。?
AI 模型支持:Claude Pro/Max API 密鑰、OpenAI API 密鑰或 Ollama 本地模型(二選一)
安裝與初始化命令(直接復制執行)
bash
運行
# 1. 全局安裝最新版Moltbot(兼容Clawdbot所有指令)
npm install -g moltbot@latest
# 2. 一鍵啟動官方初始化向導(自動配置網關、工作空間、消息平臺)
moltbot onboard --install-daemon
# 3. 消息平臺配對(選擇WhatsApp/Telegram等,按提示完成)
moltbot channels login
# 4. 啟動核心網關服務(默認端口18789)
moltbot gateway --port 18789
# 5. 驗證安裝成功(通過配對的消息平臺發送)
消息內容:嗨,你能做什么?
向導交互關鍵步驟
同意用戶協議
選擇安裝模式(推薦quickstart快速模式)
配置 AI 模型(輸入 API 密鑰或選擇本地模型)
選擇消息平臺(優先 WhatsApp/Telegram,操作簡單)
開啟守護進程(推薦,實現后臺自動運行)
3. 核心功能使用指南(常用場景)
(1)消息平臺配對詳細教程
平臺 配對步驟 關鍵注意事項
WhatsApp 1. 執行moltbot channels login→選擇 WhatsApp
2. 終端生成二維碼
3. 手機 WhatsApp「設置 - 鏈接設備」掃描二維碼 確保手機與電腦在同一局域網,二維碼有效期 2 分鐘
Telegram 1. 執行moltbot channels login→選擇 Telegram
2. 輸入 BotFather 獲取的 Bot Token
3. 發送/start到機器人完成配對 需先在 Telegram 搜索 @BotFather 創建機器人獲取 Token
Discord 1. 執行moltbot channels login→選擇 Discord
2. 輸入 Bot Token
3. 邀請機器人到服務器 需在 Discord 開發者平臺創建應用并添加 Bot 權限
(2)本地模型配置(無需云端 API,完全私有化)
安裝 Ollama(本地大模型運行環境):https://ollama.com/
拉取支持工具調用的模型: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默認端點
"apiKey": "ollama" // 固定值,無需修改
}
}
重啟網關:moltbot gateway restart
(3)常用命令速查(高效管理)
bash
運行
moltbot status # 檢查服務狀態
moltbot health # 系統健康檢查
moltbot logs --follow # 實時查看日志
moltbot configure # 交互配置工具
moltbot skills list # 查看已安裝技能
moltbot daemon start # 啟動守護進程
4. 本地 Web UI 使用(可視化管理)
安裝成功并啟動網關后,通過瀏覽器訪問:
Web 控制臺:http://127.0.0.1:18789/ (管理會話、查看狀態、調試)
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碼掃描無反應 → 關閉網關后重新執行moltbot channels login
npm 安裝權限不足:提示Permission denied → 添加--unsafe-perm參數:
bash
運行
npm install -g moltbot@latest --unsafe-perm
三、兼容性說明(與 Clawdbot)
指令兼容:安裝 Moltbot 后,舊指令clawdbot仍可使用(為兼容舊腳本保留的別名)
bash
運行
clawdbot gateway # 等價于 moltbot gateway
clawdbot channels login # 等價于 moltbot channels login
配置文件遷移:Clawdbot 的配置文件可直接復制到 Moltbot 配置目錄
bash
運行
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/moltbot.json
功能完全兼容:Moltbot 保留了 Clawdbot 的所有核心功能,并新增了更多模型支持和安全特性
四、進階學習資源
技能開發指南:https://docs.molt.bot/skills-development (創建自定義技能)
多代理編排:https://docs.molt.bot/agents/multi-agent (多個 AI 代理協作完成復雜任務)
Docker 部署:https://docs.molt.bot/deployment/docker (容器化部署,提升安全性)
中文社區教程:https://clawdbotcn.cn/moltbot.html (適合國內用戶的詳細指南)
本資訊來自互聯網,如有侵權強聯系刪除~