反应
代理使用 message 工具的 react 操作添加和移除表情回应。行为因渠道而异。
控制 UI 回应 在渠道来源提示中通过相同的 react 操作镜像机器人的回应。
工作原理¶
- 添加回应时,
emoji为必填项。 - 将
emoji设置为空字符串("")可在支持该功能的渠道上移除机器人的回应。 - 设置
remove: true可移除某个特定表情(要求emoji非空)。 clearAll: true是仅限 Feishu/Lark 的标志,用于移除机器人放在该消息上的所有回应。它与空emoji搭配使用。emoji-list是message工具的一个独立操作,不是react参数。它报告渠道可接受的表情。其返回值以及启用它的每个渠道操作开关均因渠道而异。请参阅 渠道 下的渠道页面。- 在具有状态回应的渠道上,在回应上设置
trackToolCalls: true可让运行时复用该已回应消息,用于同一轮次的状态生命周期。Discord 在工作期间保持所选回应稳定,并指示实际故障,而不是循环使用工具专属表情。
渠道行为¶
Discord 和 Slack
- 空
emoji会移除机器人放在该消息上的所有回应。 remove: true仅移除指定的表情。
Nextcloud Talk
- 仅支持添加回应:
emoji为必填项且必须非空。 - 回应移除尚未连接到删除调用。
remove: true会被明确错误拒绝,而不是静默无效。 - 要求 Talk 机器人已注册
reaction功能(参见 Nextcloud Talk 渠道文档)。
Telegram
- 使用
emoji-list查找允许的标准回应和数字自定义表情标识符。在 Telegram 上,channels.telegram.actions.reactions同时控制react和emoji-list,并且emoji-list返回当前聊天中允许的回应。 - 空
emoji会移除机器人的回应。 remove: true也会移除回应,但工具验证仍要求emoji非空。
- 空
emoji会移除机器人回应。 remove: true内部映射为空表情(工具调用中仍要求emoji)。- WhatsApp 每条消息只有一个机器人回应槽位。发送新回应会替换它,而不是叠加多个表情。
Zalo Personal (zalouser)
- 添加和移除均要求
emoji非空。 remove: true会移除该特定表情回应。
Feishu/Lark
- 与其他渠道一样使用
react操作(通过消息回应 ID 添加/移除/列出),而不是独立工具。 - 添加要求
emoji非空(映射到 Feishuemoji_type,例如SMILE、THUMBSUP、HEART)。 remove: true要求emoji非空,并移除机器人自身匹配该表情类型的回应。- 空
emoji搭配clearAll: true会移除机器人放在该消息上的所有回应。
Signal
channels.signal.reactionNotifications控制传入的回应通知。"off"禁用它们。"own"(默认)在用户对机器人消息做出回应时发出事件。"all"为所有回应发出事件。"allowlist"仅为channels.signal.reactionAllowlist中的发送者发出事件。
iMessage
- 传出回应是 iMessage tapback(
love、like、dislike、laugh、emphasize和question)。要添加回应,emoji必须映射到这些类型之一。 - 未指定可识别 tapback 类型的
remove: true会移除所有 tapback 类型。指定可识别类型时,仅移除该类型。
回应级别¶
每个渠道的 reactionLevel 会限制代理发送自身回应的频率。取值:off、ack、minimal 或 extensive。
- Telegram 回应级别 -
channels.telegram.reactionLevel(默认minimal) - WhatsApp 回应级别 -
channels.whatsapp.reactionLevel(默认minimal) - Signal 回应 -
channels.signal.reactionLevel(默认minimal)
相关¶
- Agent Send - 包含
react的message工具 - 渠道 - 渠道特定配置
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw