反应 - OpenClaw 中文文档

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

工作原理

{
  "action": "react",
  "messageId": "msg-123",
  "emoji": "thumbsup"
}

Discord and Slack

Nextcloud Talk

Add-only reactions: emoji is required and cannot be empty.
Reaction removal is not yet wired to a delete call; remove: true returns a clear error rather than silently doing nothing.
Requires a bot registered in Talk with the reaction feature enabled (see Nextcloud Talk channel docs).

An empty emoji will remove the bot’s reaction.
remove: true also removes reactions, but tool validation still requires a non-empty emoji.

An empty emoji will remove the bot reaction.
remove: true is internally mapped to an empty emoji (but emoji is still required in the tool call).
WhatsApp has a single bot-reaction slot per message; sending a new reaction replaces it instead of stacking multiple emoji.

Zalo Personal (zalouser)

Feishu/Lark

Uses the same react operation as other channels (add/remove/list via reaction ID) rather than a separate tool.
Adding requires a non-empty emoji (mapped to Feishu’s emoji_type, e.g. SMILE, THUMBSUP, HEART).
remove: true requires a non-empty emoji and removes the bot’s own reaction matching that emoji type.
clearAll: true with an empty emoji will remove all of the bot’s reactions on that message.

Signal

Incoming 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 only for senders in channels.signal.reactionAllowlist.

iMessage

Outgoing reactions are iMessage tapbacks (love, like, dislike, laugh, emphasize, and question); emoji must map to one of these types in order to add a reaction.
Using remove: true without a recognizable tapback type removes all tapback types; if a recognizable type exists, only that one is removed.

按频道设置的 reactionLevel 会限制代理发送自身反应的频率。可选值：off、ack、minimal 或 extensive。