沒問題，我已經為你將 README 內容轉換為**繁體中文**，同時維持所有連結、圖片標籤、代碼塊以及勳章（Shields）的原始格式。 --- # 🦞 Moltbot — 個人 AI 助手

脫殼進化！脫殼進化！ (EXFOLIATE!)

**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-`)，npm 標記為 `latest`。 * **beta (測試版)**：預發布標籤 (`vYYYY.M.D-beta.N`)，npm 標記為 `beta`（可能缺少 macOS 應用）。 * **dev (開發版)**：`main` 分支的最前沿，npm 標記為 `dev`。切換頻道 (git + npm)：`moltbot update --channel stable|beta|dev`。詳情見：[開發頻道說明](https://docs.molt.bot/install/development-channels)。 ## 源碼安裝 (開發用) 從源碼構建推薦使用 `pnpm`。直接運行 TypeScript 時 Bun 是可選的。 ```bash git clone https://github.com/moltbot/moltbot.git cd moltbot pnpm install pnpm ui:build # 首次運行時自動安裝 UI 依賴 pnpm build pnpm moltbot onboard --install-daemon # 開發循環（修改 TS 後自動重載） pnpm gateway:watch ``` 注意：`pnpm moltbot ...` 直接通過 `tsx` 運行 TypeScript。`pnpm build` 會生成 `dist/` 目錄，用於通過 Node 或打包後的 `moltbot` 二進制文件運行。 ## 安全默認設置 (私聊訪問) Moltbot 連接到真實的通訊平台。請將所有接收到的私聊消息視為 **不可信輸入**。完整的安全指南：[安全](https://docs.molt.bot/gateway/security) 在 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 上的默認行為： * **私聊配對** (`dmPolicy="pairing"`)：未知的發送者會收到一個簡短的配對碼，助手不會處理他們的消息。 * 批准方式：執行 `moltbot pairing approve

`（之後該發送者將被添加到本地允許列表中）。
* 公開接收私聊：需要明確開啟，設置 `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)。

再次感謝以下所有的貢獻者：