WhatsApp 问题

编号格式 #NNNNN 对应 GitHub issue，可直接搜索去重。

显示 Connected 但消息发送失败

来源：GitHub #38734（2026-03）

现象：openclaw channels 显示 WhatsApp 状态为 Connected，但实际发送消息时报错 No active WhatsApp Web listener，消息无法送达。

原因：WhatsApp Web 会话在后台静默断开，但连接状态没有及时同步，UI 显示正常而实际已断连。

解决方法：

bash

openclaw channels disconnect whatsapp
openclaw channels login   # 重新扫码

建议：WhatsApp Web 会话有时效性，手机重启或长时间不活动后容易断连。频繁出现时考虑开启自动重连配置。

来源：GitHub #53386（2026-03）

现象：在 WhatsApp 群组中，Agent 发出回复后，自己发出的消息又被接收并再次处理，形成无限循环。

原因：WhatsApp 会将 fromMe=true 的出站消息 echo 回 Gateway，Gateway 的"隐式提及检测"把这条 echo 识别为 was_mentioned=true，再次触发 Agent 回复。

解决方法：

json5

{
  channels: {
    whatsapp: {
      filterOwnMessages: true,     // 过滤 fromMe echo
      groupReplyPolicy: "explicit" // 只响应明确 @提及
    }
  }
}

如果当前版本没有上述配置项，临时将 Agent 绑定改为私信（DM）而非群组，等待官方修复。

来源：GitHub #53729（2026-03）

现象：AI 发送给用户的回复消息，又作为"用户发来的消息"出现在对话中，每条消息看起来被复制了一遍。

原因：WhatsApp 插件没有正确过滤 fromMe=true 的出站消息，导致 Agent 自己发出的消息被重新路由进入 inbound 队列。

解决方法：

升级到修复版本（官方正在追踪此问题）。临时规避：限制 WhatsApp 只响应白名单用户：

json5

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+8613800138000"]
    }
  }
}