渠道概览
xbot 通过**渠道(Channel)**接收和发送消息。每个渠道是一个可插拔的适配器,连接到同一个 Agent 引擎。
| 渠道 | 适合谁 | 连接方式 | 特点 |
|---|---|---|---|
| CLI | 开发者、终端用户 | 本地进程 / WebSocket | 全功能 TUI,流式输出,工具调用,SubAgent |
| 飞书 | 团队协作 | WebSocket | 群内 @机器人 对话,消息卡片交互,飞书 API 集成 |
| QQ 用户 | WebSocket | QQ 官方机器人协议 | |
| NapCat | 个人/小圈子 | WebSocket | OneBot 11 协议,兼容 NapCat 等 |
| Web | 任何有浏览器的人 | HTTP + WebSocket | 网页聊天,注册/登录,邀请制 |
所有渠道通过 ~/.xbot/config.json 启用,无需设置环境变量。
在 TUI 中可视化配置:输入 /channel 命令打开频道配置面板,可以图形化管理各频道的启用/禁用和参数,变更会直接写入 config.json。这在 Remote 模式下特别有用,因为无需 SSH 登录到 Server 手动编辑配置文件。
⚠️ 飞书、QQ、NapCat、Web 渠道需要 Server 模式。 Standalone 模式仅支持 CLI。
- 个人使用、快速体验 → CLI(Standalone 模式)
- 团队在飞书里用 AI → Server 模式 + 飞书渠道
- 给朋友/QQ 群用 → Server 模式 + NapCat 渠道
- 提供公开的网页聊天入口 → Server 模式 + Web 渠道
- 多渠道同时使用 → Server 模式 + 启用多个渠道
所有渠道都支持 allow_from 白名单:
- 留空(默认):允许所有人使用
- 设置后:只有列表中的用户可以与 Agent 对话
飞书用 open_id,QQ 用 openid,NapCat 用 QQ 号。