远程连接
消息渠道
配置飞书、Telegram、钉钉、微信、企业微信和扩展渠道。
消息渠道把一个 SoniBot 助手连接到聊天应用。用户从聊天应用发消息，任务仍在运行 SoniBot 的机器上执行。
支持范围
当前设置界面包含 Telegram、飞书、钉钉、微信和企业微信，并可显示扩展插件贡献的渠道。Slack、Discord 或其他渠道是否可配置，以当前版本的状态和扩展安装情况为准。
通用配置流程
- 进入“设置 → Channels”；
- 选择一个渠道；
- 在平台开发者后台创建 Bot 或应用；
- 把渠道要求的凭据填入 SoniBot；
- 点击测试连接；
- 连接成功后启用渠道；
- 选择该渠道默认使用的助手；
- 如果助手使用内置 Agent，可按需选择默认模型；
- 从聊天应用向 Bot 发消息，获取配对码；
- 回到 SoniBot 批准配对。
不同平台要求的凭据不同：
| 渠道 | 常见凭据 |
|---|---|
| Telegram | Bot Token |
| 飞书 | App ID、App Secret；可选 Encrypt Key、Verification Token |
| 钉钉 | 平台应用凭据与机器人配置 |
| 微信 | 平台要求的账号或连接配置 |
| 企业微信 | 智能机器人或企业应用相关凭据 |
| 扩展渠道 | 由扩展声明的必填与可选字段 |
助手与模型
每个渠道保存自己的助手绑定。更换渠道助手不会自动改变桌面端已有会话。
对于由 SoniBot 内置 Agent 驱动的助手，渠道可以配置默认模型；其他 CLI 助手通常由自身运行时管理模型。保存的模型服务被删除或失效时，需要重新选择。
配对与授权用户
配对用于避免任何发现 Bot 的人直接调用你的 SoniBot：
- 新用户向 Bot 发起消息；
- SoniBot 收到带有效期的配对申请；
- 管理员核对平台用户信息和配对码；
- 选择批准或拒绝；
- 已批准用户进入授权列表；
- 不再允许时撤销该用户。
凭据已用于活跃用户时，部分渠道会锁定凭据编辑。需要更换时，先停用渠道并撤销相关授权用户，再修改配置。
故障排查
- 无法启用：确认必填凭据已保存，并先测试连接；
- 连接成功但收不到消息：检查平台端 Bot 能力、事件配置、应用发布和网络；
- 一直等待配对：刷新配对列表，确认申请未过期且平台类型正确；
- 助手不可用：在 Agents 页面测试该助手绑定的运行时；
- 模型失效：重新选择仍存在的服务商与模型；
- 文件发送失败：确认文件位于渠道允许发送的目录中。
飞书的完整步骤见飞书机器人接入。