Moltbot是什麼?如何安裝與上手


Moltbot 是什麼?

Moltbot(原名 Clawdbot)是一套開源的個人 AI 助理系統,由資深 iOS 開發者彼得.史坦伯格(Peter Steinberger)開發。它的核心特色是將 AI 從被動聊天工具轉變為具備行動能力的自主代理,能夠直接在你的電腦或伺服器上運行。

核心特徵

1. 擁有真正的執行權限 — 傳統 AI(如 ChatGPT、Claude)只能在對話框內生成文本,而 Moltbot 擁有完整的系統權限,可以直接執行終端機指令、讀寫檔案、執行 Python 腳本,甚至控制你的瀏覽器進行網頁自動化。

2. 持久的長期記憶 — 每次對話都被轉存為 Markdown 檔案,讓 AI 能夠無限期地記住你的偏好、工作流程和過去的指令。

3. 多通道整合 — 支援透過 WhatsApp、Telegram、Discord、Slack、iMessage 等 11+ 個平台與你的 AI 助理互動。

4. 主動而非被動 — 可以根據排程在背景運行,主動監控天氣、郵件、股價,並主動發送提醒。

真實應用範例

  • 在外出時透過 Telegram 傳訊息:「幫我預訂下週六晚上的餐廳」,它就在你家電腦上自動執行
  • 自動清理 Gmail、整理 Notion 筆記、控制 Spotify
  • 監控顯示卡或股票價格並推送更新
  • 24/7 生成晨間簡報,整合你的行事曆、待辦事項和新聞

系統需求

在開始安裝前,確認你的系統符合以下要求:

項目需求
作業系統macOS 10.15+、Windows 10+、Linux (任何發行版本)
Node.js 版本v22.0 或更新
系統記憶體最低 512MB–1GB RAM(建議 2GB+)
存儲空間200MB 以上自由空間
網路連線穩定的網際網路連線(用於 API 呼叫)

分步驟安裝指南

步驟 1:準備工作 — 驗證或安裝 Node.js

在 macOS 上驗證 Node.js

打開終端機(Terminal),輸入以下指令檢查 Node.js 版本:

node -v
npm -v

如果版本號出現且 ≥ v22.0,跳到步驟 2

若 Node.js 未安裝或版本過舊:

使用 Homebrew 安裝最新版本:

# 如果未安裝 Homebrew,先執行此指令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安裝 Node.js
brew install node

驗證安裝成功:

node -v

在 Windows 上安裝 Node.js

  1. 造訪 Node.js 官方網站
  2. 下載 LTS 版本(長期支援版本)
  3. 執行安裝程式,按照默認設定完成安裝
  4. 重新啟動電腦
  5. 打開 PowerShell(以系統管理員身分),驗證安裝:
node -v
npm -v

在 Linux 上安裝 Node.js

# Ubuntu/Debian 系統
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# 驗證
node -v
npm -v

步驟 2:安裝 Moltbot

Moltbot 提供多個安裝方式,選擇最適合你的方式:

方式 A:一鍵安裝(推薦初學者)

macOS 和 Linux:

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

Windows(PowerShell):

開啟 PowerShell(以系統管理員身分),執行:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://molt.bot/install.ps1 | iex

Windows(CMD 命令提示字元):

curl -fsSL https://molt.bot/install.cmd -o install.cmd && install.cmd && del install.cmd

這個一鍵腳本會自動:

  • 偵測你的作業系統
  • 安裝所有必要的依賴項
  • 設定 Node.js 環境
  • 啟動初始化設置精靈

方式 B:手動安裝(進階用戶)

若你已有 npm 環境,可直接安裝:

# 使用 npm
npm install -g moltbot@latest

# 或使用 pnpm(更快)
npm install -g pnpm
pnpm add -g moltbot@latest

驗證安裝成功:

moltbot -v

步驟 3:初始化配置與後台服務設置

安裝完成後,執行初始化指令啟動設置精靈:

moltbot onboard --install-daemon

這個步驟至關重要。 設置精靈會引導你完成以下配置:

3.1 選擇 AI 模型供應商

系統會提示選擇語言模型提供者,常見選項包括:

  • Claude (Anthropic) — 推薦。支援完整的功能集,提供最佳的代理能力
  • GPT (OpenAI) — 支援,但功能略遜於 Claude
  • Gemini (Google) — 支援
  • 本地開源模型 — 支援 Ollama 等本地運行的模型

獲取 API 密鑰:

若選擇 Claude,訪問 Anthropic 官方網站,取得 API 密鑰並在設置時貼上。

3.2 設置網關端口

系統會詢問 Gateway Port,默認為 18789。保留默認值即可,除非你有埠位衝突。

3.3 配置通訊渠道

設置精靈會提示你連接通訊平台。對初學者而言,建議從 Telegram 或 WhatsApp 開始:

Telegram 連接步驟:

  1. 在 Telegram 上找到 @BotFather 機器人
  2. 發送 /newbot 指令建立新的機器人
  3. 輸入機器人名稱和用戶名(需以 _bot 結尾)
  4. 複製生成的 API Token
  5. 將 Token 貼入 Moltbot 設置精靈

Discord 連接步驟:

  1. 前往 Discord Developer Portal
  2. 建立新的應用程式
  3. 在 Bot 標籤頁生成 Token
  4. 啟用 Message Content Intent
  5. 複製 Token 並貼入 Moltbot 設置

3.4 設置工作目錄

系統會建立 ~/moltbot/ 目錄(Linux/macOS)或 C:\Users\YourName\moltbot\(Windows),用來儲存配置、記憶檔案和日誌。保留默認值即可。

3.5 安裝後台服務

設置精靈會詢問是否安裝後台守護進程(daemon service)。建議選擇「是」,這樣 Moltbot 可以在系統啟動時自動運行。

  • macOS: 安裝為 launchd 服務
  • Linux: 安裝為 systemd 用戶服務
  • Windows: 安裝為 Windows 服務

步驟 4:啟動與驗證

驗證安裝成功

moltbot status

如果輸出顯示 Gateway 正在運行,安裝成功。

啟動 Web 儀表板

moltbot dashboard

或直接訪問:

http://127.0.0.1:18789/chat

你會看到一個聊天介面,可以直接與 Moltbot 對話。

測試對話

嘗試發送簡單指令,例如:

告訴我今天的天氣

列出我桌面上的檔案

Moltbot 應該能夠執行這些指令並回傳結果。


常見安裝問題排解

問題解決方案
找不到 moltbot 命令npm 路徑未設置。嘗試 npm install -g moltbot@latest 或重新啟動終端機/PowerShell
Gateway 連線失敗檢查防火牆設定,確保允許本地連線。試試改變端口:moltbot onboard --port 18790
API Key 驗證失敗確認 API Key 複製無誤,且帳戶有足夠的 API 配額
Telegram Bot 無法連接確認 Bot Token 正確,且網路連線正常
Node.js 版本不符更新 Node.js。使用 node -v 確認版本 ≥ 22.0

運行診斷工具:

moltbot doctor

此指令會進行全面的健康檢查並自動修復常見問題。


下一步:開始使用

1. 通過 Telegram/WhatsApp 測試

一旦設置完成,在 Telegram 或 WhatsApp 上傳訊息給你的 Bot,例如:

整理我的下載資料夾

Moltbot 會在你的電腦上執行此任務。

2. 探索 Skills(技能)

Skills 是可重複使用的工作流程。官方社群提供許多預建 Skills,你也可以要求 Moltbot 自己編寫新的 Skills。

常見 Skills 包括:

  • 網頁搜尋
  • 代碼執行
  • 檔案處理
  • 圖片生成
  • 郵件管理

3. 設置自動排程任務

你可以要求 Moltbot 執行定時任務,例如:

每天早上 8 點發送我的日程摘要

Moltbot 會自動建立 Cron 排程並執行。


費用與資源需求

Moltbot 本身完全免費且開源,但運行時有兩項成本:

  1. API 費用: 根據使用的 LLM 提供者決定
    • Claude API:每月約 $3–10 USD
    • OpenAI GPT API:費用因模型而異
    • 免費本地模型(如 Ollama):零成本
  2. 伺服器費用(可選) — 若要 24 小時不間斷運行
    • AWS EC2:約 $5/月
    • Digital Ocean VPS:約 $5–6/月
    • 本地電腦或舊 MacBook:免費

安全提示

Moltbot 擁有高度的系統權限,使用時應謹慎:

✅ 建議做法:

  • 在專用設備或 VPS 上運行
  • 定期檢查日誌和執行歷史
  • 定期更新 Moltbot

⚠️ 避免做法:

  • 不要在存有加密貨幣私鑰或機密資料的電腦上運行
  • 避免暴露在公網上或配置不當
  • 小心提示詞注入(Prompt Injection)攻擊

總結

Moltbot 代表 AI 助理的一次飛躍——從被動聊天工具進化為能自主執行工作的數位員工。安裝過程簡單友善,甚至非技術使用者也能在 10–15 分鐘內完成設置。一旦啟動,你便擁有了一個 24/7 可用的 AI 助理,它能記住你的偏好、透過多個通訊平台與你互動,並主動完成各種自動化任務。

無論你是開發者、企業用戶,還是想要提升生產力的個人,Moltbot 都提供了一個強大且靈活的平台。開始探索它的可能性吧!


參考資源: