Reactions
기준일: 2026-07-26
난이도: 중급
공식 기준: Reactions
개요
이 페이지는 OpenClaw Reactions 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.
공식 요약: Reaction tool semantics across all supported channels
도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.
공식 문서 기반 상세
아래는 공식 tools/reactions 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.
The agent adds and removes emoji reactions with the message tool's react
action. Behavior varies by channel.
동작 방식
{
"action": "react",
"messageId": "msg-123",
"emoji": "thumbsup"
}
emojiis required when adding a reaction.- Set
emojito an empty string ("") to remove the bot's reaction(s) on channels that support it. - Set
remove: trueto remove one specific emoji (requires non-emptyemoji). - On channels with status reactions,
trackToolCalls: trueon a reaction lets the runtime reuse that reacted message for subsequent tool-progress reactions during the same turn.
Channel behavior
Discord and Slack
- Empty `emoji` removes all of the bot's reactions on the message.
- `remove: true` removes just the specified emoji.
Nextcloud Talk
- Adding reactions only: `emoji` is required and must be non-empty.
- Reaction removal is not wired to a delete call yet; `remove: true` is rejected with an explicit error instead of silently no-oping.
- Requires the Talk bot registered with the `reaction` feature (see [Nextcloud Talk channel docs](https://docs.openclaw.ai/channels/nextcloud-talk)).
Telegram
- 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).
- WhatsApp has one bot reaction slot per message; sending a new reaction replaces it rather than stacking multiple emoji.
Zalo Personal (zalouser)
- Requires non-empty `emoji` for both add and remove.
- `remove: true` removes that specific emoji reaction.
Feishu/Lark
- Uses the same `react` action as other channels (add/remove/list via message reaction IDs), not a separate tool.
- Adding requires non-empty `emoji` (mapped to a Feishu `emoji_type`, e.g. `SMILE`, `THUMBSUP`, `HEART`).
- `remove: true` requires non-empty `emoji` and removes the bot's own reaction matching that emoji type.
- Empty `emoji` with `clearAll: true` removes all of the bot's reactions on the message.
Signal
- Inbound reaction notifications are controlled by `channels.signal.reactionNotifications`: `"off"` disables them, `"own"` (default) emits events when users react to bot messages, `"all"` emits events for all reactions, and `"allowlist"` emits events only for senders in `channels.signal.reactionAllowlist`.
iMessage
- Outbound reactions are iMessage tapbacks (`love`, `like`, `dislike`, `laugh`, `emphasize`, and `question`); `emoji` must map to one of these kinds to add a reaction.
- `remove: true` without a recognized tapback kind removes all tapback kinds; with a recognized kind it removes just that one.
Reaction level
Per-channel reactionLevel throttles how often the agent sends its own
reactions. Values: off, ack, minimal, or extensive.
- Telegram reaction notifications -
channels.telegram.reactionLevel(defaultminimal) - WhatsApp reaction level -
channels.whatsapp.reactionLevel(defaultminimal) - Signal reactions -
channels.signal.reactionLevel(defaultminimal)
관련 문서
- Agent Send - the
messagetool that includesreact - Channels - channel-specific configuration
검증 체크리스트
- 해당 tool이 활성 profile/policy에서 허용되는지 확인
- sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
- 채널·에이전트 권한과 충돌하지 않는지 확인
- 공식 CLI/
--help와 문서 옵션이 버전과 맞는지 확인