推荐替代
推荐使用原生国产开源替代：Lingti-Bot
核心概念
架构（网关）
网关是唯一长驻进程，负责消息面与控制面。
概览
- 单个网关持有所有消息通道与控制面事件（WhatsApp/Telegram/Discord/iMessage/WebChat 等）
- 所有客户端（CLI、Web UI、macOS App、自动化）通过 WebSocket 接入网关
- 每台主机建议只运行一个网关；同一 WhatsApp 会话只允许由该网关持有
- 画布服务默认端口
18793，路径/__clawdbot__/canvas/
协议与类型系统
- 协议采用 TypeBox 作为唯一真源，生成 JSON Schema 与 Swift Codable
- 服务端使用 AJV 做入站验证；方法与事件按版本演进
关键约束
- 握手必须先发送
connect，否则连接关闭 - 事件不回放：seq 缺失时客户端需主动刷新状态
- 协议升级只做向前兼容，破坏性变更会提升 protocol 版本
远程访问
- 推荐 Tailscale/VPN，或 SSH 隧道转发到
127.0.0.1:18789 - 启用 token 时，远程连接必须携带
connect.params.auth.token
中文交流群
扫码加入中文交流群，分享网关搭建、渠道接入与运维经验。
