IM 配置
📌 AutoClaw 当前支持 5 类 IM 频道：飞书、企业微信、微信、钉钉和 QQ。接入后，可在侧边栏“聊天平台”集中查看、切换和管理各频道对话；本篇同时以飞书为例讲解账号配置。
学完你可以收获：
• 找到 IM 频道配置入口
• 在侧边栏查看、切换和管理 IM 频道对话
• 通过扫码或 App ID / App Secret 接入飞书
• 完成连接后的检查与日常维护
一、什么是 IM 频道
IM 频道用于把 AutoClaw 的 Agent 接入常用即时通讯工具。接入后，你既可以直接在对应平台中与指定 Agent 对话，也可以在侧边栏“聊天平台”集中管理不同频道的对话，包括按平台切换会话、查看历史消息和继续对话。
每个 IM 账号只绑定一个 Agent。需要让不同机器人承担不同工作时，可以为同一频道添加多个账号，再分别绑定对应的 Agent。
二、进入 IM 频道
方式一：首页顶部入口
- 打开 AutoClaw 桌面端。
- 在首页右上角点击“接入飞书/微信等通讯工具”。
- 系统会直接进入设置页的“IM 频道”。
方式二：在侧边栏管理 IM 对话
侧边栏“聊天平台”是 IM 对话管理区。这里会按频道汇总已接入账号产生的对话，方便查看会话列表、切换不同频道、进入历史对话并继续处理消息；需要新增或调整频道时，也可以从这里进入 IM 频道配置。
- 在左侧边栏顶部点击“聊天平台”。
- 页面会按频道展示对话列表；点击频道名称可切换平台，点击具体会话可进入历史对话并继续处理消息。
- 点击会话列表底部的“接入飞书/微信等通讯工具”。
- 系统会进入设置页的“IM 频道”，后续配置方式与首页入口一致。
三、添加和管理频道
在“IM 频道”页面中，你可以查看已连接的频道、账号数量、绑定的 Agent 和当前状态。支持飞书、企业微信、微信、钉钉和 QQ；已经接入的频道以账号卡片展示，尚未接入的平台会出现在“快速添加”区域。
- 点击右上角“添加频道”，选择需要接入的即时通讯平台。
- 也可以在“快速添加”区域直接点击对应平台。
- 频道接入后，可继续添加账号，或通过“设置”调整账号名称与绑定的 Agent。
四、配置飞书账号
如果飞书频道已经存在，点击频道卡片右上角的“添加账号”；如果还没有飞书频道，可通过“添加频道”或“快速添加”中的飞书入口开始配置。
填写基础信息
| 配置项 | 说明 |
|---|---|
| Account ID | 账号的唯一标识，例如 bot-prod、bot-sales。创建后不可修改，建议使用英文、数字或短横线。 |
| 账号名称 | 可选的显示名称，用于在多个账号之间快速区分。 |
| 绑定 Agent | 选择这个飞书机器人收到消息后交给哪个 Agent 处理。每个账号只绑定一个 Agent。 |
方式一：扫码连接（推荐）
- 填写 Account ID，并按需填写账号名称。
- 选择需要绑定的 Agent。
- 点击“立即扫码连接”。
- 按页面提示使用飞书扫码并完成授权。
- 回到 AutoClaw，等待连接完成后检查频道状态。
方式二：手动填写 App ID / App Secret
如果已有飞书应用，可以展开“已有 App ID？手动输入”，填写应用的 App ID 和 App Secret，然后点击“保存”。保存成功后，返回 IM 频道页并点击“刷新”确认连接状态。
❗ 安全提醒：App Secret 属于敏感凭据，不要粘贴到聊天、截图或公开文档中。截图前应遮挡 App ID、App Secret、二维码及账号身份信息；怀疑泄露时，应立即在飞书开放平台重置凭据，并更新 AutoClaw 中的配置。
五、连接后的管理
- 设置：查看或调整账号名称、绑定 Agent 和连接方式。
- 添加账号：为同一频道增加多个机器人账号，并分别绑定不同 Agent。
- 停用：临时停止频道收发消息，配置会保留，可随时恢复。
- 删除：移除不再使用的频道或账号；执行前请确认该机器人没有仍在使用的工作流。
- 刷新：接入或修改配置后，重新拉取最新连接状态。
六、验证是否接入成功
- 确认频道卡片显示“已连接”。
- 确认账号卡片中的 Agent 与预期一致。
- 在对应 IM 中向机器人发送一条测试消息。
- 检查机器人是否正常回复，并确认回复来自预期 Agent。
💡 建议首次接入时先绑定测试 Agent，并用不含敏感信息的消息验证收发。确认稳定后，再切换到正式工作流。
更多频道接入和连接排查问题统一收录在常见问题。