openclaw/README_zht.md

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

---

🦞 Moltbot — 個人 AI 助手

脫殼進化！脫殼進化！ (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）僅僅是控制平面 —— 助手產品本身才是核心。

如果你想要一個私密的、單用戶使用的、感覺像是本地運行且響應極快、永遠在線的助手，這就是你的最佳選擇。

官方網站 · 文檔 · 入門指南 · 更新說明 · 案例展示 · 常見問題 · 配置嚮導 · Nix · Docker · Discord

推薦安裝方式：運行初始化嚮導 (moltbot onboard)。它會引導你設置網關、工作區、頻道和技能。CLI 嚮導是官方推薦的路徑，支持 macOS, Linux, 和 Windows (通過 WSL2; 強烈推薦)。 支持使用 npm, pnpm, 或 bun。 新用戶安裝？從這裡開始：入門指南

訂閱服務 (OAuth):

• Anthropic (Claude Pro/Max)
• OpenAI (ChatGPT/Codex)

模型建議：雖然支持任何模型，但我強烈建議使用 Anthropic Pro/Max (100/200) + Opus 4.5，以獲得最強的長文本處理能力和更好的提示詞注入防禦。詳見 入門嚮導。

模型 (選擇 + 認證)

• 模型配置 + CLI：模型概念
• 認證配置文件輪換 (OAuth vs API keys) + 備選方案：模型故障轉移

安裝 (推薦)

運行環境：Node ≥22。

npm install -g moltbot@latest
# 或: pnpm add -g moltbot@latest

moltbot onboard --install-daemon

嚮導會安裝網關守護進程（launchd/systemd 用戶服務）以保持後台運行。 歷史備註：clawdbot 命令作為兼容墊片（shim）依然可用。

快速開始 (TL;DR)

運行環境：Node ≥22。

完整的初學者指南（認證、配對、頻道）：入門指南

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

正在升級？請參考 更新指南（並運行 moltbot doctor）。

開發頻道

• stable (穩定版)：帶有標籤的發布版本 (vYYYY.M.D 或 vYYYY.M.D-<patch>)，npm 標記為 latest。
• beta (測試版)：預發布標籤 (vYYYY.M.D-beta.N)，npm 標記為 beta（可能缺少 macOS 應用）。
• dev (開發版)：main 分支的最前沿，npm 標記為 dev。

切換頻道 (git + npm)：moltbot update --channel stable|beta|dev。 詳情見：開發頻道說明。

源碼安裝 (開發用)

從源碼構建推薦使用 pnpm。直接運行 TypeScript 時 Bun 是可選的。

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 連接到真實的通訊平台。請將所有接收到的私聊消息視為 不可信輸入。

完整的安全指南：安全

在 Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 上的默認行為：

• 私聊配對 (dmPolicy="pairing")：未知的發送者會收到一個簡短的配對碼，助手不會處理他們的消息。
• 批准方式：執行 moltbot pairing approve <channel> <code>（之後該發送者將被添加到本地允許列表中）。
• 公開接收私聊：需要明確開啟，設置 dmPolicy="open" 並在允許列表 (allowFrom) 中包含 "*"。

運行 moltbot doctor 以發現風險項或配置錯誤的私聊策略。

亮點功能

• 本地優先網關 — 會話、頻道、工具和事件的統一控制平面。
• 多頻道收件箱 — 支持 WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, BlueBubbles, Microsoft Teams, Matrix, Zalo, Zalo Personal, WebChat, macOS, iOS/Android。
• 多代理路由 — 將接收的頻道/賬戶路由到獨立代理（工作區 + 獨立會話）。
• **語音喚醒 + 通話模式** — 適用於 macOS/iOS/Android 的全天候語音，配合 ElevenLabs。
• 實時畫布 (Live Canvas) — 代理驅動的可視化工作區，集成 A2UI。
• 一流的工具鏈 — 瀏覽器、畫布、節點、定時任務 (Cron)、會話，以及 Discord/Slack 動作。
• 伴侶應用 — macOS 菜單欄應用 + iOS/Android 節點應用。
• **新手引導 + 技能系統** — 嚮導驅動的設置，包含內置、託管和工作區技能。

Star 增長歷史

目前已構建的所有功能

核心平台

• 網關 WS 控制平面：包含會話、在線狀態、配置、定時任務、Webhooks、控制 UI 以及 畫布主機。
• 命令行界面：網關控制、代理對話、發送消息、嚮導 和 醫生自檢。
• Pi 代理運行時：支持 RPC 模式，具備工具流式傳輸和塊流傳輸。
• 會話模型：支持 main 直接聊天、群組隔離、激活模式、隊列模式、自動回覆。群組規則參見：群組。
• 媒體流水線：處理圖片/音頻/視頻，支持轉錄鉤子、大小限制、臨時文件生命週期管理。音頻詳情：音頻。

頻道支持

• 頻道列表：WhatsApp (Baileys), Telegram (grammY), Slack (Bolt), Discord (discord.js), Google Chat (Chat API), Signal (signal-cli), iMessage (imsg), BlueBubbles, Microsoft Teams, Matrix, Zalo, Zalo Personal, WebChat。
• 群組路由：提及觸發、回覆標籤、分頻道分塊和路由。頻道規則見：頻道。

應用 + 節點

• macOS 應用：菜單欄控制平面、語音喚醒/PTT、通話模式 懸浮層、WebChat、調試工具、遠程網關 控制。
• iOS 節點：支持 畫布、語音喚醒、通話模式、攝像頭、屏幕錄製、Bonjour 自動配對。
• Android 節點：畫布、通話模式、攝像頭、屏幕錄製、可選的短信支持。
• macOS 節點模式：系統命令運行/通知 + 畫布/攝像頭開放。

工具 + 自動化

• 瀏覽器控制：專用 moltbot Chrome/Chromium，支持快照、操作、上傳、配置文件管理。
• 畫布 (Canvas)：A2UI 推送/重置、代碼執行、快照。
• 節點工具：攝像頭抓拍/剪輯、屏幕記錄、位置獲取、通知。
• Cron + 喚醒；Webhooks；Gmail 消息推送。
• 技能平台：內置、託管和工作區技能，具備安裝門檻和 UI。

運行時 + 安全

• 頻道路由、重試策略 以及 流式分塊。
• 在線狀態、輸入狀態指示器 和 使用情況跟踪。
• 模型管理、模型故障轉移 和 會話清理。
• 安全指南 和 故障排除。

運維 + 打包

• 控制 UI + WebChat 直接由網關提供服務。
• Tailscale Serve/Funnel 或 SSH 隧道，支持 Token/密碼認證。
• 用於聲明式配置的 Nix 模式；基於 Docker 的安裝。
• 醫生 (Doctor) 遷移工具，日誌管理。

工作原理 (簡述)

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 網絡 — 用於客戶端、工具和事件的統一 WS 控制平面（及運維：網關運行手冊）。
• Tailscale 暴露 — 為網關儀錶盤 + WS 提供內網穿透（遠程訪問：遠程連接）。
• 瀏覽器控制 — 由 moltbot 管理的 Chrome/Chromium，具備 CDP 控制能力。
• 畫布 + A2UI — 代理驅動的可視化工作區。
• **語音喚醒 + 通話模式** — 始終在線的語音和連續對話支持。
• 節點 (Nodes) — 提供畫布、攝像頭快拍、屏幕記錄、位置獲取、通知，以及 macOS 專有的系統命令執行。

運維與故障排除

• 健康檢查
• 日誌管理
• 故障排除指南

Molty

Moltbot 是為 Molty 構建的，它是一隻太空龍蝦 AI 助手。 🦞 由 Peter Steinberger 及社區共同開發。

• 官網 clawd.me
• 推特 @moltbot

社群

查看 CONTRIBUTING.md 獲取貢獻指南。歡迎提交各種 PR！🤖

特別鳴謝 Mario Zechner 及其提供的 pi-mono。

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