Clawdbot 🦞

大多数操作都通过 **网关** (`clawdbot gateway`) 运行，这是一个单一的长期运行进程，负责管理通道连接和 WebSocket 控制平面。

## 网络模型

- **每个主机一个网关（推荐）**：它是唯一允许拥有 WhatsApp Web 会话的进程。如果你需要救援机器人或严格的隔离，可以运行多个网关，使用隔离的配置文件和端口；详见 [多个网关](/gateway/multiple-gateways)。
- **回环优先**：网关的 WebSocket 默认使用 `ws://127.0.0.1:18789`。
  - 向导现在默认会生成一个网关令牌（即使对于回环连接也如此）。
  - 对于 Tailnet 访问，请运行 `clawdbot gateway --bind tailnet --token ...`（非回环绑定需要令牌）。
- **节点**：连接到网关的 WebSocket（根据需要使用 LAN/Tailnet/SSH）；旧版 TCP 桥接已弃用/移除。
- **Canvas 主机**：HTTP 文件服务器在 `canvasHost.port`（默认 `18793`），为节点的 WebViews 提供 `/__clawdbot__/canvas/`；详见 [网关配置](/gateway/configuration)（`canvasHost`）。
- **远程使用**：通过 SSH 隧道或 Tailnet/VPN；详见 [远程访问](/gateway/remote) 和 [发现](/gateway/discovery)。

## 特性（高级功能）

- 📱 **WhatsApp 集成** — 使用 Baileys 实现 WhatsApp Web 协议
- ✈️ **Telegram 机器人** — 通过 grammY 实现私信 + 群组
- 🎮 **Discord 机器人** — 通过 channels.discord.js 实现私信 + 频道
- 🧩 **Mattermost 机器人（插件）** — 机器人令牌 + WebSocket 事件
- 💬 **iMessage** — 本地 imsg CLI 集成（macOS）
- 🤖 **代理桥接** — Pi（RPC 模式）支持工具流式传输
- ⏱️ **流式传输 + 分块** — 块流式传输 + Telegram 草稿流式传输细节 ([/concepts/streaming](/concepts/streaming))
- 🧠 **多代理路由** — 将提供者账户/对等方路由到隔离的代理（工作区 + 每代理会话）
- 🔐 **订阅认证** — 通过 OAuth 实现 Anthropic（Claude Pro/Max） + OpenAI（ChatGPT/Codex）
- 💬 **会话** — 直接聊天会合并为共享的 `main`（默认）；群组是隔离的
- 👥 **群组聊天支持** — 默认基于@提及；所有者可以切换 `/activation always|mention`
- 📎 **媒体支持** — 支持发送和接收图片、音频、文档
- 🎤 **语音备忘录** — 可选的语音转文字钩子
- 🖥️ **WebChat + macOS 应用** — 本地 UI + 菜单栏伴侣用于操作和语音唤醒
- 📱 **iOS 节点** — 作为节点配对，并暴露一个 Canvas 表面
- 📱 **Android 节点** — 作为节点配对，并暴露 Canvas + 聊天 + 摄像头

注意：旧版 Claude/Codex/Gemini/Opencode 路径已被移除；Pi 是唯一的编码代理路径。```bash
# Recommended: global install (npm/pnpm)
npm install -g clawdbot@latest
# or: pnpm add -g clawdbot@latest

# Onboard + install the service (launchd/systemd user service)
clawdbot onboard --install-daemon

# Pair WhatsApp Web (shows QR)
clawdbot channels login

# Gateway runs via the service after onboarding; manual run is still possible:
clawdbot gateway --port 18789

如果你还没有全局安装，請從存儲庫中通過 `pnpm clawdbot ...` 進行入門步驟。

多實例快速入門（可選）：```bash
CLAWDBOT_CONFIG_PATH=~/.clawdbot/a.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-a \
clawdbot gateway --port 19001

## 配置（可选）

配置文件位于 `~/.clawdbot/clawdbot.json`。

- 如果你 **什么也不做**，Clawdbot 将使用内置的 Pi 二进制文件以 RPC 模式运行，并为每个发送者启用会话。
- 如果你想对其进行限制，可以从 `channels.whatsapp.allowFrom` 开始，并（对于群组）设置相关规则。

示例：```json5
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } }
    }
  },
  messages: { groupChat: { mentionPatterns: ["@clawd"] } }
}