状态：稳定 (WhatsApp Web via Baileys)。网关拥有会话。

OpenClaw 使用 Baileys 库连接到 WhatsApp，模拟 WhatsApp Web 客户端。这允许您的代理直接在 WhatsApp 内回复消息、管理群组并充当个人助理。

1. 准备一个电话号码 如果可能，请使用单独的电话号码（推荐）或您的个人号码。

2. 配置 OpenClaw 将 WhatsApp 配置添加到 ~/.openclaw/openclaw.json。

   {
     channels: {
       whatsapp: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["+15551234567"] // 您的个人号码
       }
     }
   }

3. 启动网关 运行网关以初始化连接。

   openclaw gateway run

4. 扫描二维码 网关将向终端（或日志）打印一个二维码。

   • 在您的手机上打开 WhatsApp。
   • 转到 设置 > 链接设备 > 链接设备。
   • 扫描二维码。

在您的主设备上使用备用 Android 手机或 eSIM。

• 优点：路由清晰，没有“自聊”怪癖，身份独特。
• 设置：在备用设备/配置文件上安装 WhatsApp（或 WhatsApp Business）。将 OpenClaw 链接到此帐户。

在您自己的主号码上运行 OpenClaw。

• 优点：无需额外的硬件/SIM 卡。
• 缺点：您必须给自己发消息（给自己备注）才能与机器人交谈。
• 怪癖：您会看到机器人的回复，就像您发送了它们一样。

{
  channels: {
    whatsapp: {
      enabled: true,
      // 谁可以与机器人交谈？
      dmPolicy: "allowlist", // "allowlist" (严格) 或 "pairing" (开放)
      allowFrom: ["+15551234567"],

      // 管理员用户（可以运行特权命令）
      adminUsers: ["+15551234567"],

      // 会话存储（默认为 ~/.openclaw/workspace/sessions/whatsapp）
      sessionDir: "/path/to/custom/session"
    }
  }
}