OpenClaw从入门到应用——频道：群消息

通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》激活模式支持mention默认或always两种激活模式。mention模式需要 提及通过mentionedJids实现的真实 WhatsApp 提及、正则表达式匹配或消息文本中任意位置包含机器人的 E.164 格式号码才能触发。always模式下每条消息都会唤醒智能体但智能体仅当能提供有意义的价值时才回复否则返回静默标记NO_REPLY。可在配置文件channels.whatsapp.groups中设置默认值并可通过/activation命令按群组覆盖默认设置。当设置了channels.whatsapp.groups时该配置还充当群组白名单包含*表示允许所有群组。群组策略channels.whatsapp.groupPolicy控制是否接受群组消息可选值open|disabled|allowlist。allowlist模式使用channels.whatsapp.groupAllowFrom回退选项显式设置的channels.whatsapp.allowFrom。默认值为allowlist在添加发送者之前消息将被阻止。按群组隔离的会话会话键格式为agent::whatsapp:group:因此像/verbose on或/think high以独立消息形式发送这样的命令仅作用于该群组个人私聊状态不受影响。群组线程会跳过心跳检测。上下文注入仅待处理的群组消息默认最多50条即未触发智能体运行的消息会以[自您上次回复以来的聊天消息 - 供上下文参考]为前缀注入触发运行的消息行则置于[当前消息 - 请回复此条]下。已经存在于会话中的消息不会被重复注入。发送者信息展示每个群组批次的消息末尾现在都会附加[from: 发送者姓名 (E164)]以便 Pi 知道是谁在发言。临时/单次消息处理在提取文本/提及之前我们会解包临时消息和单次查看消息因此其中的提及仍能触发智能体。群组系统提示在群组会话的第一轮交互中以及每当/activation更改模式时我们会在系统提示中注入一段简短说明例如您正在 WhatsApp 群组“”中回复。群组成员Alice (44...), Bob (43...), … 激活模式仅触发… 请回复消息上下文中指明的特定发送者。如果元数据不可用我们仍会告知智能体当前处于群聊环境。配置示例 (WhatsApp)在~/.openclaw/openclaw.json中添加groupChat配置块以便即使 WhatsApp 在文本正文中去掉了视觉上的符号显示名称的提及也能正常工作theme{theme:{light:min-light,dark:min-dark}} { channels: { whatsapp: { groups: { *: { requireMention: true } } } }, agents: { list: [ { id: main, groupChat: { historyLimit: 50, mentionPatterns: [?openclaw, \\?15555550123] } } ] } }注意正则表达式不区分大小写它们覆盖了类似openclaw的显示名称提及以及带或不带/空格的原始号码。当有人通过联系人选择进行提及操作时WhatsApp 仍会通过mentionedJids发送规范的提及因此号码回退机制很少需要但作为一个有用的安全网。激活命令 (仅限所有者)在群聊中使用以下命令/activation mention/activation always只有所有者号码来自channels.whatsapp.allowFrom或未设置时的机器人自身 E.164 号码可以更改此设置。在群组中以独立消息形式发送/status可查看当前的激活模式。使用方法将您的 WhatsApp 账号运行 OpenClaw 的账号添加到群组中。发送openclaw …或包含该号码。除非您设置了groupPolicy: open否则只有白名单中的发送者才能触发智能体。智能体提示将包含最近的群组上下文以及末尾的[from: …]标记以便它能针对正确的人进行回复。会话级别的指令/verbose on、/think high、/new或/reset、/compact仅应用于该群组的会话请将它们作为独立消息发送以便注册。您的个人私聊会话保持独立。测试/验证手动冒烟测试在群组中发送一条openclaw的提及确认机器人回复中引用了发送者姓名。发送第二条提及验证历史消息块被包含然后在下一轮被清除。检查网关日志使用--verbose运行查看inbound web message条目其中包含from:和[from: …]后缀。已知注意事项群组会故意跳过心跳检测以避免产生嘈杂的广播。回声抑制使用组合的批次字符串如果您连续发送两次相同文本且没有提及只有第一条会获得回复。会话存储条目会以agent::whatsapp:group:的形式出现在会话存储中默认位于~/.openclaw/agents/agent_id/sessions/sessions.json缺少条目仅表示该群组尚未触发过运行。群组中的输入指示器遵循agents.defaults.typingMode设置默认值未提及时为message。基于 Mintlify 构建