Moltbot (前稱Clawdbot) 詳細安裝教學指南

AI資訊

Moltbot (前稱Clawdbot) 詳細安裝教學指南

Moltbot  (前稱Clawdbot)  詳細安裝教學指南成為2026年AI實踐者必備手冊，這款開源本地AI代理僅需一行指令即可啟動，將你的電腦變身24/7智能工作站，支援WhatsApp、Telegram等多平台通訊，即刻體驗「真正會動手」的數位助理。

 

環境準備與系統需求

安裝前確認硬體規格：macOS Sonoma+、Ubuntu 24.04+或Windows 11（強烈推薦WSL2 Ubuntu）。核心需求Node.js 22+，建議搭配pnpm套件管理器提升效能。

必備前置條件：

Node.js >=22（brew install node@22 或官網下載）
Brave Search API金鑰（用於網頁搜尋）
通訊平台帳號（WhatsApp/Telegram/Discord/Slack）
AI模型API（Anthropic Claude首選，OpenAI次選）

 

硬體建議：

入門：Mac mini M1+ 或中階PC（8GB RAM）
進階：Mac Studio 或雲端VPS（16GB RAM）
極致：本地Ollama部署大模型
 

快速入門路徑：一行指令搞定

方法一：官方安裝腳本（推薦新手）

開啟終端機，複製執行：

curl -fsSL https://molt.bot/install.sh | bash

 

3-4分鐘內自動完成：

• Node.js環境檢查與安裝

• Moltbot CLI全局部署

• 依賴套件全數載入

• 基本設定模板建立

Windows PowerShell替代：

iwr -useb https://molt.bot/install.ps1 | iex

 

方法二：NPM全局安裝（穩定版）

npm install -g moltbot@latest
# 或使用pnpm（更快）
pnpm add -g moltbot@latest
 

核心安裝流程：onboard精靈全攻略

執行最關鍵一步：

moltbot onboard --install-daemon

精靈將依序設定：

 

1. 模型認證配置

本地模型（Ollama）vs 雲端API
Anthropic Claude：API金鑰（推薦）或OAuth
OpenAI：Codex訂閱（自動授權）
其他：Gemini、DeepSeek等

最佳實踐： 先設Claude Opus作為主力，保留GPT-4o備用。

 

2. Gateway服務設定

本地loopback（127.0.0.1:18789）
自動產生Gateway Token
背景守護程式（launchd/systemd）
沙箱模式（預設啟用）

 

3. 通訊頻道選擇

WhatsApp（QR Code掃描）
Telegram（Bot Token）
Discord（Bot Token）
Slack（Webhook）
iMessage（原生支援）

 

4. 工作空間初始化

預設Skills載入（20+核心功能）
AGENTS.md人格模板
本地記憶體初始化
安全白名單建立
 

驗證安裝與首次啟動

檢查服務狀態

moltbot status           # 整體健康檢查
moltbot health          # 詳細診斷報告
moltbot security audit --deep  # 資安掃描
 

預期輸出：

Gateway: running on 127.0.0.1:18789
Models: 3 configured (claude-opus primary)
Channels: 2 active (WhatsApp, Telegram)
Memory: 1.2MB (12 conversations)
Security: PASS (no public exposure)

 

快速Dashboard測試

moltbot dashboard

瀏覽器自動開啟http://127.0.0.1:18789/，內嵌聊天介面立即測試：

「你能做什麼？展示你的超能力」

通訊頻道詳細配對教學

WhatsApp QR登入（最簡單）

moltbot channels login whatsapp

手機WhatsApp → 設定 → 連結裝置 → 掃描螢幕QR Code → 完成！

注意： 首次私訊需配對驗證碼：

moltbot pairing approve whatsapp ABC123

Telegram Bot建立

1. 聯絡@BotFather → /newbot

2. 取得Token：123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. 執行：moltbot channels setup telegram --token 你的TOKEN

Discord整合

1. Discord Developer Portal → New Application

2. Bot → Token複製

3. moltbot channels setup discord --token 你的DISCORD_TOKEN

 

高階配置與最佳化

沙箱模式調整

預設安全（推薦）：

{
  "routing": {
    "agents": {
      "main": { "sandbox": { "mode": "non-main" } }
    }
  }
}
 

 

全功能解鎖（高風險）：

{
  "routing": {
    "agents": {
      "main": { 
        "workspace": "~/moltbot",
        "sandbox": { "mode": "off" }
      }
    }
  }
}
 

多模型動態切換

moltbot models list
moltbot models set anthropic/claude-opus
moltbot models add openai/gpt-4o-mini --priority 2
 

背景服務管理

# 啟動/停止/重啟
systemctl start moltbot
systemctl status moltbot
systemctl restart moltbot

# macOS launchd
brew services start moltbot
 

常見問題排除全攻略

安裝失敗

# 權限問題
sudo npm install -g moltbot --unsafe-perm

# Node版本過舊
nvm install 22
nvm use 22
 

WhatsL Telegram連線失敗

# Bun相容性問題（改用Node）
node moltbot.mjs gateway --verbose

# 防火牆阻擋
sudo ufw allow 18789
 

模型無回應

# 檢查API金鑰
moltbot models test claude-opus

# Token用量超限
moltbot status --token-usage
 

首次訊息無回應

# 配對驗證
moltbot pairing list whatsapp
moltbot pairing approve whatsapp 你的驗證碼
 

進階部署方案

雲端24/7運行（AWS免費版）

1. AWS EC2 t3.micro（Ubuntu）
2. curl -fsSL https://molt.bot/install.sh | bash
3. moltbot onboard --install-daemon
4. SSH隧道遠端存取：ssh -L 18789:localhost:18789 ubuntu@你的IP
 

 

Docker容器化部署

docker run -d
  --name moltbot
  -p 127.0.0.1:18789:18789
  -v ~/moltbot:/data
  moltbot/moltbot:latest
 

Mac mini專用最佳化

# 選用M2+型號（16GB RAM）
# 安裝macOS Menu Bar App
brew install --cask moltbot-menubar

# 語音喚醒（ElevenLabs整合）
moltbot voice enable
 

安全檢查清單（必執行）

moltbot security audit --deep
確認無公網暴露端口（nmap掃描）
API金鑰設為最低額度
白名單限制檔案路徑
定期日誌審計
啟用沙箱模式

 

首次實戰測試流程

Step 1： Telegram發送「你能做什麼？」
Step 2： 測試檔案操作「整理下載資料夾」
Step 3： 網頁自動化「查詢iPhone 17最新價格」
Step 4： 記憶測試「記住我喜歡喝黑咖啡」

成功標準：

5分鐘內完成端到端對話
AI正確執行3種不同任務類型
記憶功能正常運作
無資安警告

 

升級與維護指南

# 檢查更新
moltbot --version
npm update -g moltbot

# 備份工作空間
tar -czf moltbot-backup-$(date +%Y%m%d).tar.gz ~/moltbot

# 匯出設定
moltbot export-config > my-moltbot.json
 

Moltbot  (前稱Clawdbot)  安裝門檻並不算高，15分鐘速成後即可享受划時代AI代理體驗。從瑣碎任務自動化，到複雜工作流編排，這隻「會動手的龍蝦」將徹底改變你的數位生活方式。立即執行第一行指令，開啟智能助理新紀元！

 

歡迎查看/報讀 「OpenClaw (前稱 Clawbot / Moltbot) AI教學課程」!