8.12 AI Agent 消息通道
AI Agent 支持通过即时通讯工具与您交互。配置消息通道后，您可以在飞书、Telegram 或微信上与 AI Agent 对话，而无需始终打开 IDMP Web 界面。系统管理员配置通道后，每个用户需将自己的 IM 账号与 IDMP 用户账号绑定，以建立安全的对话通道。
8.12.1 通道概览
消息通道涉及三层概念：
- 管理员配置通道：在管理后台为每个 IM 平台配置 Bot 凭证。
- 用户绑定：每个用户将自己的 IM 账号与 IDMP 用户绑定。
- 日常使用：绑定后，您可以直接在 IM 中与 AI Agent 对话。
IDMP 目前支持三种消息通道：
| 通道 | Bot 配置 | 用户绑定方式 | 特点 |
|---|---|---|---|
| 飞书 | App ID + App Secret | 二维码扫码后发送任意消息获取 6 位绑定码 | 企业用户常用，需创建飞书应用 |
| Telegram | Bot Token（± Proxy） | 打开 Bot 链接发送指令获取 6 位绑定码 | 个人用户常用，需通过 @BotFather 创建 Bot |
| 微信 | 系统开关，无需 Bot 凭证 | 二维码扫码 + 手机确认 | 个人微信绑定，用户扫码后自动完成 |
8.12.2 配置消息通道（管理员）
在管理后台 → 智能AI → 通道管理中集中管理消息通道的 Bot 配置。
通道列表
通道列表以表格形式展示三个通道，每行包含通道名称、启用开关、运行状态和「详情」操作：
| 列 | 说明 |
|---|---|
| 名称 | 通道图标 + 名称（飞书 / Telegram / WeChat） |
| 启用 | 切换开关。飞书/Telegram 在未保存 Bot 配置时不可用；微信直接控制系统级开关 |
| 状态 | 飞书/Telegram 显示运行中 / 已停止；微信不显示 |
| 操作 | 「详情」按钮，进入该通道的详细配置页 |
飞书通道配置
在通道管理列表中点击飞书行的「详情」进入飞书通道配置页。
首次配置：
- 访问飞书开放平台（https://open.feishu.cn/page/launcher）创建企业自建应用。
- 在应用凭证中获取 App ID 和 App Secret。
- 在 IDMP 飞书配置页填入 App ID 和 App Secret，点击保存。
- 保存后启用通道开关。
- 点击启动按钮启动消息监听。
修改配置： 点击编辑图标，App Secret 留空表示保持原值不变。
查看绑定用户： 配置页下半部分展示已绑定的用户列表，包含邮箱、姓名、绑定时间，管理员可直接解除绑定。
Telegram 通道配置
在通道管理列表中点击 Telegram 行的「详情」进入 Telegram 通道配置页。
首次配置：
- 在 Telegram 中搜索 @BotFather，按照指引创建新 Bot 并获取 Bot Token。
- 在 IDMP Telegram 配置页填入 Token。
- 可选：如果您的网络环境需要代理，填写 Proxy 字段（如
http://proxy.example.com:8080）。 - 点击保存。
- 保存后启用通道开关。
- 点击启动按钮启动消息监听。
修改配置： 点击编辑图标，Token 留空表示保持原值不变。您也可以随时删除 Telegram 配置。
查看绑定用户： 配置页下半部分展示已绑定的用户列表。
微信通道配置
微信通道无需配置 Bot 凭证。在通道管理列表中点击 WeChat 行的「详情」进入微信配置页，仅展示绑定用户列表。
在通道列表页通过启用开关控制该通道的全局可用性。
8.12.3 用户绑定 IM 账号
查看通道状态
在个人设置页的 IM 绑定区域，始终显示三个通道的状态卡片，无论您是否已绑定：
[飞书图标] 飞书 状态：正常监听 | ID: ou_xxxx [解除绑定]
[Telegram] Telegram 状态：监听未启动 | [启动监听]
[微信图标] WeChat 状态：未绑定 | [绑定用户]
各状态的含义：
| 状态 | 说明 |
|---|---|
| 未启用 | 管理员尚未配置该通道 |
| 监听未启动 | 通道已配置但 Bot 监听未启动 |
| 正常监听 | 通道已配置且监听正常运行 |
| 未绑定 | 您的 IM 账号未与 IDMP 绑定 |
| 已绑定 | 您的 IM 账号已绑定，可接收 AI Agent 消息 |
绑定飞书
- 确保管理员已配置飞书通道且监听正常运行。
- 点击页面右上角个人头像，在 IM 绑定区域，飞书行状态为「正常监听」时，点击绑定用户。
- 弹出飞书二维码，使用飞书客户端扫码。
- 扫码后打开 Bot 会话，发送任意消息获取 6 位绑定码。
- 在对话框中输入 6 位绑定码，点击绑定。
- 绑定成功后，页面自动刷新，状态变为「已绑定」。
绑定 Telegram
- 确保管理员已配置 Telegram 通道且监听正常运行。
- 点击页面右上角个人头像，在 IM 绑定区域，Telegram 行状态为「正常监听」时，点击绑定用户。
- 系统新窗口打开 Telegram Bot 链接。
- 在 Telegram Bot 中发送消息获取 6 位绑定码。
- 返回 IDMP 对话框，输入 6 位绑定码，点击绑定。
绑定微信
- 确保管理员已在系统设置中启用「个人微信绑定」。
- 点击页面右上角个人头像，在 IM 绑定区域，微信行点击绑定用户。
- 弹出二维码，使用微信扫码。
- 在手机上确认登录。
- 系统自动轮询二维码状态，确认后自动完成绑定。
- 绑定成功后弹窗自动关闭，状态更新为「已绑定」。
- 在手机微信中点击刚完成添加的微信 Clawbot，可以进行备注名修改、消息置顶或更改头像等个性化配置
解除绑定
对于已绑定的通道，点击解除绑定按钮。在确认弹窗中点击确定后，系统即解除您的 IM 账号与 IDMP 账号的绑定关系。
8.12.4 数据与安全
- 绑定信息存储在
channel_user_binding表中，包括 IM 平台的用户开放 ID、绑定时间和绑定码。 - 绑定码为 6 位临时码，5 分钟有效期，过期后需重新获取。
- AI Agent 缓存：解绑时系统自动清除缓存的 API Key，避免旧的凭证被继续使用。
- Bot 配置中的 Secret 和 Token 在管理后台查看时脱敏显示（
********），编辑时留空保持原值。
8.12.5 常见问题
Q：飞书 Bot 创建后无法收到消息？
A：飞书应用发布后需要等待数分钟生效。请确认在飞书开放平台中已正确配置事件订阅和权限，并且 Bot 已启用。然后检查 IDMP 通道配置页中 App ID 和 App Secret 是否正确，并点击启动按钮启动监听。
Q：Telegram Bot 如何创建？
A：在 Telegram 中搜索 @BotFather，发送 /newbot 命令并按指引设置 Bot 名称和用户名。创建成功后 @BotFather 会返回 Bot Token，将其填入 IDMP 的 Telegram 通道配置页即可。
Q：绑定码过期了怎么办？
A：绑定码有效期为 5 分钟。过期后重新在 Bot 中发送消息获取新的 6 位绑定码，然后在对话框中输入新码即可。
Q：解除绑定后 AI Agent 还能通过 IM 联系我吗？
A：不能。解除绑定后，AI Agent 将不再向您的 IM 账号发送消息。如需恢复，重新绑定即可。
