群組訊息
設定 OpenClaw 代理的 WhatsApp 群組聊天功能,支援提及觸發和獨立工作階段。
此文件涵蓋 OpenClaw 代理的 WhatsApp 群組聊天功能,讓代理在群組中保持待命狀態,直到被明確提及時才啟動,並維護與私訊分離的獨立工作階段。
啟動模式
系統支援兩種模式:
mention(預設)— 需要 @提及或正規表達式模式匹配才會觸發always— 回應每一則訊息,無法有意義地回覆時傳回NO_REPLY
群組策略控制
管理員可透過 channels.whatsapp.groupPolicy 設定接受層級:
open— 開放存取disabled— 停用群組功能allowlist— 僅允許特定群組
獨立工作階段
每個群組維護獨立的工作階段,使用以下格式的金鑰:
agent:<agentId>:whatsapp:group:<jid>
群組對話與個人私訊保持完全分離。
上下文管理
系統會注入最多 50 則未回覆的訊息作為上下文背景,並清楚標記當前需要回應的訊息。
發送者標示
每則訊息批次包含發送者資訊,格式如下:
[from: 發送者名稱 (+E164)]
特殊訊息處理
限時訊息和僅供查看一次的訊息會在處理前解除封裝,以保留提及偵測功能。
設定範例
設定檔可啟用顯示名稱模式匹配,並使用正規表達式自訂提及觸發器。
使用方式
- 將機器人帳號加入群組
- 明確提及機器人(除非啟動模式設為
always) - 使用工作階段專屬的指令,不會影響其他對話
測試指引
驗證方式包括傳送測試提及,確認適當的上下文回應,並測試歷史記錄注入和清除行為。
提示: 如需瞭解更多 WhatsApp 整合細節,請參閱 WhatsApp 頻道文件。