三層架構
| 層級 | 職責 | 關鍵細節 |
|---|---|---|
| Gateway | 中央控制平面，維護 WebSocket、管理 Session、調度 Agent | 預設綁定 ws://127.0.0.1:18789，每台主機一個實例 |
| Node | 設備端執行節點，負責本地操作 | camera、screen recording、system.run 等 |
| Channel | 訊息渠道接入層 | WhatsApp / Telegram / Discord / Slack / 飛書 / 釘釘… |
Loopback-First：預設安全
- ▸Gateway 預設只綁定 localhost，不開放任何外網端口
- ▸同主機 Node 直接以 WebSocket 連接 Gateway
- ▸需遠程訪問時，透過 Tailscale Serve / Funnel 暴露，不直接開放端口
★核心建議：每台主機只運行一個 Gateway 實例。WhatsApp Web 等渠道需要獨佔會話，多實例會導致登入衝突。
通信流程
用戶發消息 → Channel 接收 → Gateway 路由 → Agent 處理 → Node 執行 → 回覆用戶Gateway 作為 24/7 運行的 daemon，持續監聽所有已連接的 Channel。它不像 CLI Agent 那樣會話結束就丟失上下文，而是長駐運行，持續累積記憶。
規模與性能
| 指標 | 數值 |
|---|---|
| 代碼規模 | 約 43 萬行 TypeScript |
| 內存佔用 | 約 1 GB（運行時） |
| 啟動時間 | 3–5 秒 |
| 官方擴展 | 40+ |
| 內置技能 | 55 |
| 社群技能 | 13,729（ClawHub 註冊） |