IM 集成
IM 集成允许用户通过消息渠道与 Agent 交互。首次引导页面列出微信、钉钉、飞书、企业微信、Telegram 和 WhatsApp；实际可用渠道及字段以当前版本页面为准。
首次引导中的 IM 集成渠道开始前准备
- 已完成模型、Agent 引擎和实例配置。
- 在目标消息平台创建专用机器人或应用，并了解其权限范围。
- 准备页面要求的 Bot ID、Secret、Token、Webhook 或回调信息。
- 使用测试群或测试账号，不要直接接入生产群聊。
在首次引导中配置
- 在“引导安装”完成运行环境、AI 模型和引擎安装。
- 进入“IM 集成”，选择目标渠道。
- 按当前页面和消息平台后台共同要求填写配置。
- 在消息平台确认回调、事件和机器人权限。
- 使用测试账号发送一条简单消息。
- 确认面板收到消息，并由预期 Agent 返回结果。
- 暂时不用 IM 时使用页面提供的跳过入口，不要填写虚假凭据。
首次引导完成后，可在“设置 > IM 机器人”等当前版本提供的入口维护配置。
完成状态
测试账号发送的消息只进入预期机器人；面板日志没有持续认证或回调错误，回复能够回到同一测试会话。
权限与凭据
- 只申请收发任务需要的消息、群组和文件权限。
- 不在截图、对话或普通日志中公开 Secret、Token 和完整 Bot ID。
- 不同渠道使用不同凭据，便于单独撤销。
- 机器人能访问本地文件或执行工具时，还要限制工作目录、Skill 和 MCP。
- 停用渠道后在消息平台撤销旧凭据，并验证旧机器人无法继续调用。
故障排查
| 现象 | 检查顺序 |
|---|---|
| 无法保存 | 必填字段、格式、账号权限和当前页面错误 |
| 收不到消息 | 平台事件订阅、回调状态、网络和机器人是否加入测试会话 |
| 能收到但不回复 | 模型、Agent、实例和面板日志 |
| 重复回复 | 平台重复订阅、多个机器人或重试配置 |
| 401 / 签名错误 | Secret/Token、时间同步和平台签名要求 |
| 文件无法处理 | 平台文件权限、下载限制、工作目录和敏感文件夹规则 |