跳转至

反应

代理使用 message 工具的 react 操作添加和移除表情回应。行为因渠道而异。

控制 UI 回应 在渠道来源提示中通过相同的 react 操作镜像机器人的回应。

工作原理

{
  "action": "react",
  "messageId": "msg-123",
  "emoji": "thumbsup"
}
  • 添加回应时,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 非空。
WhatsApp
  • 空 emoji 会移除机器人回应。
  • remove: true 内部映射为空表情(工具调用中仍要求 emoji)。
  • WhatsApp 每条消息只有一个机器人回应槽位。发送新回应会替换它,而不是叠加多个表情。
Zalo Personal (zalouser)
  • 添加和移除均要求 emoji 非空。
  • remove: true 会移除该特定表情回应。
Feishu/Lark
  • 与其他渠道一样使用 react 操作(通过消息回应 ID 添加/移除/列出),而不是独立工具。
  • 添加要求 emoji 非空(映射到 Feishu emoji_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。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw