SuperAPI AI 工具集

im-channels

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:本技能覆盖两类场景。一是理解来自 IM 渠道的入站消息;二是将当前 Agent 连接到 IM 平台(微信、企业微信、钉钉、飞书),使其可在目标应用中收发消息。

主要能力:当用户消息末尾包含 <im> 块时,说明该消息由 IM 平台转发。source 字段标明平台(WeChat、WeCom、DingTalk 或 Lark);<file> 表示已下载到工作区的文件,可直接使用其 path;type 为媒体类别(image、voice、video、file 等);mime 为文件 MIME 类型;from="quoted" 表示文件来自用户所回复的消息而非当前消息。应答时以用户文本为主要意图,<im> 块仅作元数据;媒体文件用 path 直接读取处理,无需下载;回复保持自然,平台负责发送时的格式。注意只有最终回复对用户可见,IM 渠道会用最后一条消息替换中间内容,因此需给出完整、自洽的答案。

使用方式:连接 IM 机器人时,先确认渠道,如未指定则询问用户要连接哪个平台。随后加载对应参考文件获取凭据与具体步骤:微信(官方 ClawBot)→ reference/wechat.md;企业微信 → reference/wecom.md;钉钉 → reference/dingtalk.md;飞书 → reference/lark.md。注意微信与企业微信是完全不同的平台,不要混淆;微信使用扫码授权,不需要 bot_id 或 secret。按参考文件收集凭据并执行 run_sdk_snippet 代码建立连接,成功后告知用户下一步,失败则返回错误并引导。查看状态可运行: from sdk.tool import tool result = tool.call("get_im_channel_status", {}) print(result.content)

限制与说明:连接建立后在后台持续运行,凭据保存到 .magic/config/im-channels.json 并绑定当前沙箱,重启同一沙箱进程应自动重连,无需重新配置。如需关闭某渠道自动重连,可编辑该文件将该渠道的 enabled 设为 false。所有渠道与网页会话共用同一 Agent,对话历史跨端保持连贯。微信场景不要自行生成二维码版式,工具会返回确切要输出的 markdown 内容,需原样回复。具体凭据字段与更多细节以各参考文件为准,本资料未提供的部分暂未说明。