Skip to main content
xbot
切换暗/亮/自动模式 切换暗/亮/自动模式 切换暗/亮/自动模式 返回首页
编辑页面

渠道概览

渠道概览

xbot 通过**渠道(Channel)**接收和发送消息。每个渠道是一个可插拔的适配器,连接到同一个 Agent 引擎。

渠道对比

渠道适合谁连接方式特点
CLI开发者、终端用户本地进程 / WebSocket全功能 TUI,流式输出,工具调用,SubAgent
飞书团队协作WebSocket群内 @机器人 对话,消息卡片交互,飞书 API 集成
QQQQ 用户WebSocketQQ 官方机器人协议
NapCat个人/小圈子WebSocketOneBot 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 号。