WhatsApp（Web 渠道）

适用范围

这里用于把 Clawdbot 通过 WhatsApp Web 接入 WhatsApp。

前置条件

• 一个可以通过“已关联设备（Linked Devices）”扫码登录的 WhatsApp 账号
• 网关已在本机或远程运行

快速接入

1. 写入最小配置（示例）：

{
  channels: {
    whatsapp: {
      enabled: true,
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"]
    }
  }
}

2. 扫码登录：

clawdbot channels login

3. 验证：

clawdbot status
clawdbot health

DM 配对（pairing）

当 dmPolicy 为 pairing 时，未知私聊不会被直接处理，需要你先批准。

clawdbot pairing list whatsapp
clawdbot pairing approve whatsapp <CODE>

常见排障

• 扫码失败/反复掉线：在 WhatsApp 里重新关联设备，再重跑 channels login。
• 私聊没有回复：优先检查是否还未批准配对。

进一步阅读

• 配对：/docs/start/pairing/
• 渠道排障：/docs/channels/troubleshooting/