+
+
+
+脫殼進化！脫殼進化！ (EXFOLIATE!) +
+ +
+ 
+
+ English | + 简体中文 | + 繁體中文 | +
+ +**Moltbot** 是一款運行在你自己設備上的 *個人 AI 助手*。 +它可以在你已有的社交頻道中回覆你（WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat），並支持通過 BlueBubbles, Matrix, Zalo, 和 Zalo Personal 等擴展渠道。它可以在 macOS/iOS/Android 上進行語音對話，並能渲染一個由你控制的實時畫布（Canvas）。網關（Gateway）僅僅是控制平面 —— 助手產品本身才是核心。 + +如果你想要一個私密的、單用戶使用的、感覺像是本地運行且響應極快、永遠在線的助手，這就是你的最佳選擇。 + +[官方網站](https://molt.bot) · [文檔](https://docs.molt.bot) · [入門指南](https://docs.molt.bot/start/getting-started) · [更新說明](https://docs.molt.bot/install/updating) · [案例展示](https://docs.molt.bot/start/showcase) · [常見問題](https://docs.molt.bot/start/faq) · [配置嚮導](https://docs.molt.bot/start/wizard) · [Nix](https://github.com/moltbot/nix-clawdbot) · [Docker](https://docs.molt.bot/install/docker) · [Discord](https://discord.gg/clawd) + +推薦安裝方式：運行初始化嚮導 (`moltbot onboard`)。它會引導你設置網關、工作區、頻道和技能。CLI 嚮導是官方推薦的路徑，支持 **macOS, Linux, 和 Windows (通過 WSL2; 強烈推薦)**。 +支持使用 npm, pnpm, 或 bun。 +新用戶安裝？從這裡開始：[入門指南](https://docs.molt.bot/start/getting-started) + +**訂閱服務 (OAuth):** + +* **[Anthropic](https://www.anthropic.com/)** (Claude Pro/Max) +* **[OpenAI](https://openai.com/)** (ChatGPT/Codex) + +模型建議：雖然支持任何模型，但我強烈建議使用 **Anthropic Pro/Max (100/200) + Opus 4.5**，以獲得最強的長文本處理能力和更好的提示詞注入防禦。詳見 [入門嚮導](https://docs.molt.bot/start/onboarding)。 + +## 模型 (選擇 + 認證) + +* 模型配置 + CLI：[模型概念](https://docs.molt.bot/concepts/models) +* 認證配置文件輪換 (OAuth vs API keys) + 備選方案：[模型故障轉移](https://docs.molt.bot/concepts/model-failover) + +## 安裝 (推薦) + +運行環境：**Node ≥22**。 + +```bash +npm install -g moltbot@latest +# 或: pnpm add -g moltbot@latest + +moltbot onboard --install-daemon + +``` + +嚮導會安裝網關守護進程（launchd/systemd 用戶服務）以保持後台運行。 +歷史備註：`clawdbot` 命令作為兼容墊片（shim）依然可用。 + +## 快速開始 (TL;DR) + +運行環境：**Node ≥22**。 + +完整的初學者指南（認證、配對、頻道）：[入門指南](https://docs.molt.bot/start/getting-started) + +```bash +moltbot onboard --install-daemon + +moltbot gateway --port 18789 --verbose + +# 發送消息 +moltbot message send --to +1234567890 --message "來自 Moltbot 的問候" + +# 與助手對話（可選擇將結果發送回任何已連接的頻道：WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/Microsoft Teams/Matrix/Zalo/Zalo Personal/WebChat） +moltbot agent --message "工作清單" --thinking high + +``` + +正在升級？請參考 [更新指南](https://docs.molt.bot/install/updating)（並運行 `moltbot doctor`）。 + +## 開發頻道 + +* **stable (穩定版)**：帶有標籤的發布版本 (`vYYYY.M.D` 或 `vYYYY.M.D-`（之後該發送者將被添加到本地允許列表中）。
+* 公開接收私聊：需要明確開啟，設置 `dmPolicy="open"` 並在允許列表 (`allowFrom`) 中包含 `"*"`。
+
+運行 `moltbot doctor` 以發現風險項或配置錯誤的私聊策略。
+
+## 亮點功能
+
+* **[本地優先網關](https://docs.molt.bot/gateway)** — 會話、頻道、工具和事件的統一控制平面。
+* **[多頻道收件箱](https://docs.molt.bot/channels)** — 支持 WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, BlueBubbles, Microsoft Teams, Matrix, Zalo, Zalo Personal, WebChat, macOS, iOS/Android。
+* **[多代理路由](https://docs.molt.bot/gateway/configuration)** — 將接收的頻道/賬戶路由到獨立代理（工作區 + 獨立會話）。
+* **[語音喚醒](https://docs.molt.bot/nodes/voicewake) + [通話模式**](https://docs.molt.bot/nodes/talk) — 適用於 macOS/iOS/Android 的全天候語音，配合 ElevenLabs。
+* **[實時畫布 (Live Canvas)](https://docs.molt.bot/platforms/mac/canvas)** — 代理驅動的可視化工作區，集成 [A2UI](https://docs.molt.bot/platforms/mac/canvas#canvas-a2ui)。
+* **[一流的工具鏈](https://docs.molt.bot/tools)** — 瀏覽器、畫布、節點、定時任務 (Cron)、會話，以及 Discord/Slack 動作。
+* **[伴侶應用](https://docs.molt.bot/platforms/macos)** — macOS 菜單欄應用 + iOS/Android [節點應用](https://docs.molt.bot/nodes)。
+* **[新手引導](https://docs.molt.bot/start/wizard) + [技能系統**](https://docs.molt.bot/tools/skills) — 嚮導驅動的設置，包含內置、託管和工作區技能。
+
+## Star 增長歷史
+
+## 目前已構建的所有功能
+
+### 核心平台
+
+* [網關 WS 控制平面](https://docs.molt.bot/gateway)：包含會話、在線狀態、配置、定時任務、Webhooks、[控制 UI](https://docs.molt.bot/web) 以及 [畫布主機](https://docs.molt.bot/platforms/mac/canvas#canvas-a2ui)。
+* [命令行界面](https://docs.molt.bot/tools/agent-send)：網關控制、代理對話、發送消息、[嚮導](https://docs.molt.bot/start/wizard) 和 [醫生自檢](https://docs.molt.bot/gateway/doctor)。
+* [Pi 代理運行時](https://docs.molt.bot/concepts/agent)：支持 RPC 模式，具備工具流式傳輸和塊流傳輸。
+* [會話模型](https://docs.molt.bot/concepts/session)：支持 `main` 直接聊天、群組隔離、激活模式、隊列模式、自動回覆。群組規則參見：[群組](https://docs.molt.bot/concepts/groups)。
+* [媒體流水線](https://docs.molt.bot/nodes/images)：處理圖片/音頻/視頻，支持轉錄鉤子、大小限制、臨時文件生命週期管理。音頻詳情：[音頻](https://docs.molt.bot/nodes/audio)。
+
+### 頻道支持
+
+* [頻道列表](https://docs.molt.bot/channels)：[WhatsApp](https://docs.molt.bot/channels/whatsapp) (Baileys), [Telegram](https://docs.molt.bot/channels/telegram) (grammY), [Slack](https://docs.molt.bot/channels/slack) (Bolt), [Discord](https://docs.molt.bot/channels/discord) (discord.js), [Google Chat](https://docs.molt.bot/channels/googlechat) (Chat API), [Signal](https://docs.molt.bot/channels/signal) (signal-cli), [iMessage](https://docs.molt.bot/channels/imessage) (imsg), [BlueBubbles](https://docs.molt.bot/channels/bluebubbles), [Microsoft Teams](https://docs.molt.bot/channels/msteams), [Matrix](https://docs.molt.bot/channels/matrix), [Zalo](https://docs.molt.bot/channels/zalo), [Zalo Personal](https://docs.molt.bot/channels/zalouser), [WebChat](https://docs.molt.bot/web/webchat)。
+* [群組路由](https://docs.molt.bot/concepts/group-messages)：提及觸發、回覆標籤、分頻道分塊和路由。頻道規則見：[頻道](https://docs.molt.bot/channels)。
+
+### 應用 + 節點
+
+* [macOS 應用](https://docs.molt.bot/platforms/macos)：菜單欄控制平面、[語音喚醒](https://docs.molt.bot/nodes/voicewake)/PTT、[通話模式](https://docs.molt.bot/nodes/talk) 懸浮層、[WebChat](https://docs.molt.bot/web/webchat)、調試工具、[遠程網關](https://docs.molt.bot/gateway/remote) 控制。
+* [iOS 節點](https://docs.molt.bot/platforms/ios)：支持 [畫布](https://docs.molt.bot/platforms/mac/canvas)、[語音喚醒](https://docs.molt.bot/nodes/voicewake)、[通話模式](https://docs.molt.bot/nodes/talk)、攝像頭、屏幕錄製、Bonjour 自動配對。
+* [Android 節點](https://docs.molt.bot/platforms/android)：[畫布](https://docs.molt.bot/platforms/mac/canvas)、[通話模式](https://docs.molt.bot/nodes/talk)、攝像頭、屏幕錄製、可選的短信支持。
+* [macOS 節點模式](https://docs.molt.bot/nodes)：系統命令運行/通知 + 畫布/攝像頭開放。
+
+### 工具 + 自動化
+
+* [瀏覽器控制](https://docs.molt.bot/tools/browser)：專用 moltbot Chrome/Chromium，支持快照、操作、上傳、配置文件管理。
+* [畫布 (Canvas)](https://docs.molt.bot/platforms/mac/canvas)：[A2UI](https://docs.molt.bot/platforms/mac/canvas#canvas-a2ui) 推送/重置、代碼執行、快照。
+* [節點工具](https://docs.molt.bot/nodes)：攝像頭抓拍/剪輯、屏幕記錄、[位置獲取](https://docs.molt.bot/nodes/location-command)、通知。
+* [Cron + 喚醒](https://docs.molt.bot/automation/cron-jobs)；[Webhooks](https://docs.molt.bot/automation/webhook)；[Gmail 消息推送](https://docs.molt.bot/automation/gmail-pubsub)。
+* [技能平台](https://docs.molt.bot/tools/skills)：內置、託管和工作區技能，具備安裝門檻和 UI。
+
+### 運行時 + 安全
+
+* [頻道路由](https://docs.molt.bot/concepts/channel-routing)、[重試策略](https://docs.molt.bot/concepts/retry) 以及 [流式分塊](https://docs.molt.bot/concepts/streaming)。
+* [在線狀態](https://docs.molt.bot/concepts/presence)、[輸入狀態指示器](https://docs.molt.bot/concepts/typing-indicators) 和 [使用情況跟踪](https://docs.molt.bot/concepts/usage-tracking)。
+* [模型管理](https://docs.molt.bot/concepts/models)、[模型故障轉移](https://docs.molt.bot/concepts/model-failover) 和 [會話清理](https://docs.molt.bot/concepts/session-pruning)。
+* [安全指南](https://docs.molt.bot/gateway/security) 和 [故障排除](https://docs.molt.bot/channels/troubleshooting)。
+
+### 運維 + 打包
+
+* [控制 UI](https://docs.molt.bot/web) + [WebChat](https://docs.molt.bot/web/webchat) 直接由網關提供服務。
+* [Tailscale Serve/Funnel](https://docs.molt.bot/gateway/tailscale) 或 [SSH 隧道](https://docs.molt.bot/gateway/remote)，支持 Token/密碼認證。
+* 用於聲明式配置的 [Nix 模式](https://docs.molt.bot/install/nix)；基於 [Docker](https://docs.molt.bot/install/docker) 的安裝。
+* [醫生 (Doctor)](https://docs.molt.bot/gateway/doctor) 遷移工具，[日誌管理](https://docs.molt.bot/logging)。
+
+## 工作原理 (簡述)
+
+```
+WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / Microsoft Teams / Matrix / Zalo / Zalo Personal / WebChat
+ │
+ ▼
+┌───────────────────────────────┐
+│ 網關 (Gateway) │
+│ (控制平面) │
+│ ws://127.0.0.1:18789 │
+└──────────────┬────────────────┘
+ │
+ ├─ Pi 代理 (RPC)
+ ├─ 命令行工具 (moltbot …)
+ ├─ WebChat 界面
+ ├─ macOS 應用
+ └─ iOS / Android 節點
+
+```
+
+## 核心子系統
+
+* **[網關 WebSocket 網絡](https://docs.molt.bot/concepts/architecture)** — 用於客戶端、工具和事件的統一 WS 控制平面（及運維：[網關運行手冊](https://docs.molt.bot/gateway)）。
+* **[Tailscale 暴露](https://docs.molt.bot/gateway/tailscale)** — 為網關儀錶盤 + WS 提供內網穿透（遠程訪問：[遠程連接](https://docs.molt.bot/gateway/remote)）。
+* **[瀏覽器控制](https://docs.molt.bot/tools/browser)** — 由 moltbot 管理的 Chrome/Chromium，具備 CDP 控制能力。
+* **[畫布 + A2UI](https://docs.molt.bot/platforms/mac/canvas)** — 代理驅動的可視化工作區。
+* **[語音喚醒](https://docs.molt.bot/nodes/voicewake) + [通話模式**](https://docs.molt.bot/nodes/talk) — 始終在線的語音和連續對話支持。
+* **[節點 (Nodes)](https://docs.molt.bot/nodes)** — 提供畫布、攝像頭快拍、屏幕記錄、位置獲取、通知，以及 macOS 專有的系統命令執行。
+
+## 運維與故障排除
+
+* [健康檢查](https://docs.molt.bot/gateway/health)
+* [日誌管理](https://docs.molt.bot/logging)
+* [故障排除指南](https://docs.molt.bot/channels/troubleshooting)
+
+## Molty
+
+Moltbot 是為 **Molty** 構建的，它是一隻太空龍蝦 AI 助手。 🦞
+由 Peter Steinberger 及社區共同開發。
+
+* [官網 clawd.me](https://clawd.me)
+* [推特 @moltbot](https://x.com/moltbot)
+
+## 社群
+
+查看 [CONTRIBUTING.md](https://www.google.com/search?q=CONTRIBUTING.md) 獲取貢獻指南。歡迎提交各種 PR！🤖
+
+特別鳴謝 [Mario Zechner](https://mariozechner.at/) 及其提供的
+[pi-mono](https://github.com/badlogic/pi-mono)。
+
+再次感謝以下所有的貢獻者：
+
+
+ 
+ 
+ 
+ 
+ ![google-labs-jules[bot]](https://avatars.githubusercontent.com/in/842251?v=4&s=48 "google-labs-jules[bot]")
+ 
+ 
+ 
+ 
+ 
+ 
+ 
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4&s=48 "dependabot[bot]")
+ 
+ 
+ 
![blacksmith-sh[bot]](https://avatars.githubusercontent.com/in/807020?v=4&s=48 "blacksmith-sh[bot]")
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+
+