openclaw/docs/tools/reactions.md

---
summary: "Reaction semantics shared across channels"
read_when:
  - Working on reactions in any channel
title: "Reactions"
---

# Reaction tooling

Shared reaction semantics across channels:

- `emoji` is required when adding a reaction.
- `emoji=""` removes the bot's reaction(s) when supported.
- `remove: true` removes the specified emoji when supported (requires `emoji`).

Channel notes:

- **Discord/Slack**: empty `emoji` removes all of the bot's reactions on the message; `remove: true` removes just that emoji.
- **Google Chat**: empty `emoji` removes the app's reactions on the message; `remove: true` removes just that emoji.
- **Telegram**: empty `emoji` removes the bot's reactions; `remove: true` also removes reactions but still requires a non-empty `emoji` for tool validation.
- **WhatsApp**: empty `emoji` removes the bot reaction; `remove: true` maps to empty emoji (still requires `emoji`).
- **Signal**: inbound reaction notifications emit system events when `channels.signal.reactionNotifications` is enabled.
docs: naming sweep and platform wording 2026-01-08 23:25:45 +01:00			`---`
docs: complete channels rename sweep 2026-01-13 07:15:57 +00:00			`summary: "Reaction semantics shared across channels"`
docs: naming sweep and platform wording 2026-01-08 23:25:45 +01:00			`read_when:`
docs: complete channels rename sweep 2026-01-13 07:15:57 +00:00			`- Working on reactions in any channel`
Docs: add nav titles across docs (#5689) 2026-01-31 16:04:03 -05:00			`title: "Reactions"`
docs: naming sweep and platform wording 2026-01-08 23:25:45 +01:00			`---`
chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
refactor: share reaction schemas and notes 2026-01-07 04:24:11 +01:00			`# Reaction tooling`

docs: complete channels rename sweep 2026-01-13 07:15:57 +00:00			`Shared reaction semantics across channels:`
refactor: share reaction schemas and notes 2026-01-07 04:24:11 +01:00
docs: align reaction semantics 2026-01-11 03:42:34 +00:00			- `emoji` is required when adding a reaction.
docs: clarify reactions + timeout 2026-01-11 03:55:54 +00:00			- `emoji=""` removes the bot's reaction(s) when supported.
docs: align reaction semantics 2026-01-11 03:42:34 +00:00			- `remove: true` removes the specified emoji when supported (requires `emoji`).
refactor: share reaction schemas and notes 2026-01-07 04:24:11 +01:00
docs: complete channels rename sweep 2026-01-13 07:15:57 +00:00			`Channel notes:`
refactor: share reaction schemas and notes 2026-01-07 04:24:11 +01:00
			- Discord/Slack: empty `emoji` removes all of the bot's reactions on the message; `remove: true` removes just that emoji.
feat: add beta googlechat channel 2026-01-23 16:45:37 -06:00			- Google Chat: empty `emoji` removes the app's reactions on the message; `remove: true` removes just that emoji.
docs: align reaction semantics 2026-01-11 03:42:34 +00:00			- Telegram: empty `emoji` removes the bot's reactions; `remove: true` also removes reactions but still requires a non-empty `emoji` for tool validation.
			- WhatsApp: empty `emoji` removes the bot reaction; `remove: true` maps to empty emoji (still requires `emoji`).
refactor!: rename chat providers to channels 2026-01-13 06:16:43 +00:00			- Signal: inbound reaction notifications emit system events when `channels.signal.reactionNotifications` is enabled.