本網站為獨立社群專案,與 OpenClaw 官方無任何關聯。內容僅供參考。 了解更多

翻譯文件

本頁為社群翻譯版本,可能與官方最新內容有出入。 查看官方英文原文 →

群組訊息

設定 OpenClaw 代理的 WhatsApp 群組聊天功能,支援提及觸發和獨立工作階段。

此文件涵蓋 OpenClaw 代理的 WhatsApp 群組聊天功能,讓代理在群組中保持待命狀態,直到被明確提及時才啟動,並維護與私訊分離的獨立工作階段。

啟動模式

系統支援兩種模式:

  • mention(預設)— 需要 @提及或正規表達式模式匹配才會觸發
  • always — 回應每一則訊息,無法有意義地回覆時傳回 NO_REPLY

群組策略控制

管理員可透過 channels.whatsapp.groupPolicy 設定接受層級:

  • open — 開放存取
  • disabled — 停用群組功能
  • allowlist — 僅允許特定群組

獨立工作階段

每個群組維護獨立的工作階段,使用以下格式的金鑰:

agent:<agentId>:whatsapp:group:<jid>

群組對話與個人私訊保持完全分離。

上下文管理

系統會注入最多 50 則未回覆的訊息作為上下文背景,並清楚標記當前需要回應的訊息。

發送者標示

每則訊息批次包含發送者資訊,格式如下:

[from: 發送者名稱 (+E164)]

特殊訊息處理

限時訊息和僅供查看一次的訊息會在處理前解除封裝,以保留提及偵測功能。

設定範例

設定檔可啟用顯示名稱模式匹配,並使用正規表達式自訂提及觸發器。

使用方式

  1. 將機器人帳號加入群組
  2. 明確提及機器人(除非啟動模式設為 always
  3. 使用工作階段專屬的指令,不會影響其他對話

測試指引

驗證方式包括傳送測試提及,確認適當的上下文回應,並測試歷史記錄注入和清除行為。

提示: 如需瞭解更多 WhatsApp 整合細節,請參閱 WhatsApp 頻道文件