oclaw/openclaw/docs/tools/reactions.md
oliver dbbe3add6a 重构主控编排与运行时预热链路,统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。
同时收敛启动与运维脚本默认行为(含 wiki worker)、更新 Admin 可观测性与相关测试,降低首轮时延并提高运行稳定性。

Made-with: Cursor
2026-04-26 08:34:33 +08:00

2.7 KiB

summary read_when title
Reaction tool semantics across all supported channels
Working on reactions in any channel
Understanding how emoji reactions differ across platforms
Reactions

Reactions

The agent can add and remove emoji reactions on messages using the message tool with the react action. Reaction behavior varies by channel.

How it works

{
  "action": "react",
  "messageId": "msg-123",
  "emoji": "thumbsup"
}
  • emoji is required when adding a reaction.
  • Set emoji to an empty string ("") to remove the bot's reaction(s).
  • Set remove: true to remove a specific emoji (requires non-empty emoji).

Channel behavior

- Empty `emoji` removes all of the bot's reactions on the message. - `remove: true` removes just the specified emoji. - Empty `emoji` removes the app's reactions on the message. - `remove: true` removes just the specified emoji. - Empty `emoji` removes the bot's reactions. - `remove: true` also removes reactions but still requires a non-empty `emoji` for tool validation. - Empty `emoji` removes the bot reaction. - `remove: true` maps to empty emoji internally (still requires `emoji` in the tool call). - Requires non-empty `emoji`. - `remove: true` removes that specific emoji reaction. - Use the `feishu_reaction` tool with actions `add`, `remove`, and `list`. - Add/remove requires `emoji_type`; remove also requires `reaction_id`. - Inbound reaction notifications are controlled by `channels.signal.reactionNotifications`: `"off"` disables them, `"own"` (default) emits events when users react to bot messages, and `"all"` emits events for all reactions.

Reaction level

Per-channel reactionLevel config controls how broadly the agent uses reactions. Values are typically off, ack, minimal, or extensive.

Set reactionLevel on individual channels to tune how actively the agent reacts to messages on each platform.

  • Agent Send — the message tool that includes react
  • Channels — channel-specific configuration