openclaw/docs/tools/reactions.md

summary, read_when, title

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. - Inbound reaction notifications emit system events when `channels.signal.reactionNotifications` is enabled.

Related

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