Skip to content
OpenClaw Docs

Reactions

Agent 可以使用 message 工具搭配 react 動作，在訊息上新增及移除 emoji 反應。反應行為會因頻道和傳輸方式而異。

運作方式

Section titled “運作方式”
{
  "action": "react",
  "messageId": "msg-123",
  "emoji": "thumbsup"
}
  • 新增反應時需要 emoji。
  • 將 emoji 設為空字串 ("") 以移除機器人的反應。
  • 設定 remove: true 以移除特定的 emoji（需要非空的 emoji）。
  • 在支援狀態反應的頻道上，反應上的 trackToolCalls: true 讓執行階段在相同回合內使用該反應訊息進行後續的工具進度反應。

頻道行為

Section titled “頻道行為”
Discord 和 Slack
  • 空的 emoji 會移除機器人在該訊息上的所有反應。
  • remove: true 僅會移除指定的 emoji。
Google Chat
  • 空的 emoji 會移除應用程式在該訊息上的反應。
  • remove: true 僅會移除指定的 emoji。
Nextcloud Talk
  • 僅支援新增反應：emoji 為必填且必須非空。
  • 尚不支援移除反應；帶有 remove: true（或空 emoji） 的呼叫會被拒絕並傳回明確錯誤，而非靜默無效。
  • 需將 Talk 機器人註冊為具備 reaction 功能（請參閱 Nextcloud Talk 頻道文件）。
Telegram
  • 空的 emoji 會移除機器人的反應。
  • remove: true 也會移除反應，但仍需要非空的 emoji 進行工具驗證。
WhatsApp
  • 空的 emoji 會移除機器人的回應。
  • remove: true 在內部映射為空 emoji（在工具呼叫中仍然需要 emoji）。
  • WhatsApp 每則訊息只有一個機器人回應位置；狀態回應更新會取代該位置，而不是堆疊多個 emoji。
Zalo Personal (zalouser)
  • 需要非空的 emoji。
  • remove: true 會移除該特定的 emoji 回應。
Feishu/Lark
  • 使用帶有動作 add、remove 和 list 的 feishu_reaction 工具。
  • 新增/移除需要 emoji_type；移除也需要 reaction_id。
Signal
  • 傳入的回應通知由 channels.signal.reactionNotifications 控制："off" 會停用它們，"own"（預設）會在使用者對機器人訊息做出回應時發出事件，而 "all" 會針對所有回應發出事件。
iMessage
  • 傳出回應是 iMessage 點回（love、like、dislike、laugh、emphasize 和 question）。
  • 傳入的點回通知由 channels.imessage.reactionNotifications 控制："off" 會停用它們，"own"（預設）會在使用者對機器人發送的訊息做出回應時發出事件，而 "all" 會針對來自已授寄件者的所有點回發出事件。

回應層級

Section titled “回應層級”

各頻道的 reactionLevel 設定控制 Agent 使用反應的廣泛程度。數值通常是 off、ack、minimal 或 extensive。

在各個頻道上設定 reactionLevel，以調整 Agent 在各平台上對訊息做出反應的積極程度。

相關

Section titled “相關”