OpenClaw原生支持WhatsApp频道，底层使用Baileys库通过QR码配对连接。除了基本的一对一私聊功能外，WhatsApp群组功能是许多用户关注的重点。本文将详细介绍如何在WhatsApp群聊中配置和优化AI助手的行为。
WhatsApp群聊的基本原理
当OpenClaw连接到WhatsApp后，Bot账户（实际上就是你扫码登录的WhatsApp号码）可以被添加到群组中，或者由Bot主动创建群组。在群聊环境中，Bot会接收到群里的所有消息，但默认情况下不会回复每条消息——这是一个明智的默认设定。
群聊触发模式
OpenClaw为WhatsApp群聊提供了灵活的触发机制。你可以在 openclaw.json 中配置：
{
"channels": {
"whatsapp": {
"enabled": true,
"groups": {
"triggerMode": "mention",
"mentionKeywords": ["@ai", "@bot"],
"replyToBot": true
}
}
}
}
提及模式（mention）：只有当消息中包含特定关键词时才触发AI回复。由于WhatsApp群聊不像Telegram那样有原生的@提及功能，OpenClaw通过检测消息文本中的关键词来模拟这一行为。用户发送包含 @ai 或 @bot 的消息时，AI会被触发回复。
引用回复模式（replyToBot）：当 replyToBot 设为true时，用户引用（回复）Bot之前发送的消息也会触发AI回复。这形成了一个自然的对话线程。
全部响应模式：将 triggerMode 设为 all 会让Bot响应群里的每条消息。这只适合小型的专用AI群组，不建议在普通群聊中使用。
群组白名单
为了控制Bot只在特定群组中运行，可以配置群组白名单：
{
"channels": {
"whatsapp": {
"groups": {
"allowedGroups": [
"[email protected]",
"[email protected]"
]
}
}
}
}
WhatsApp群组的ID格式为 数字@g.us。你可以在OpenClaw的日志中查看Bot加入的群组ID。如果不配置 allowedGroups，Bot会在所有被添加的群组中响应（受触发模式限制）。
群组内用户权限
在群聊场景中，你可能希望限制只有特定用户可以触发AI。OpenClaw支持群组级别的用户allowlist：
{
"channels": {
"whatsapp": {
"groups": {
"userAllowlist": ["[email protected]"],
"adminOnly": false
}
}
}
}
设置 adminOnly 为true时，只有群管理员可以触发AI回复。这在大型群组中很有用，可以防止普通成员滥用AI资源。
上下文管理
群聊中的对话上下文比私聊更复杂。多个用户同时与AI交互，消息交错出现。OpenClaw采用以下策略处理群聊上下文：
基于回复链的上下文：当用户通过引用回复与AI交互时，OpenClaw会沿着回复链构建上下文，确保对话的连贯性。
基于用户的上下文隔离：每个用户在群组中与AI的对话上下文默认是独立的。用户A的对话不会影响用户B的对话历史。
共享上下文模式：如果你希望所有用户共享同一个对话上下文，可以设置 "contextMode": "shared"。这适合团队协作场景，所有人可以看到并基于之前的对话继续交互。
{
"channels": {
"whatsapp": {
"groups": {
"contextMode": "per_user",
"maxContextMessages": 20
}
}
}
}
消息格式注意事项
WhatsApp支持基本的文本格式化（粗体、斜体等），但不支持Markdown的全部语法。OpenClaw会自动将AI回复中的Markdown格式转换为WhatsApp兼容的格式。例如 **粗体** 会保留，但代码块和表格会被简化为纯文本格式。
群聊中的私信配对
OpenClaw的私信配对功能在群聊场景中特别有用。你可以要求群组中的用户先通过私信与Bot完成身份验证，验证通过后才能在群聊中使用AI功能。这提供了一层额外的安全保障：
{
"channels": {
"whatsapp": {
"groups": {
"requirePairing": true
}
}
}
}
启用后，未配对的用户在群聊中触发AI时，Bot会发送一条私信引导用户完成配对流程。
最佳实践
在WhatsApp群组中部署AI助手时，建议使用提及模式而非全部响应模式，以避免消息洪水。为群组设置合理的速率限制，防止个别用户过度使用。定期清理对话上下文以控制内存使用。同时，确保Bot的显示名称和头像清楚地表明它是一个AI助手，避免用户混淆。