OpenClaw WhatsApp 整合指南

本文档记录如何将 OpenClaw 与 WhatsApp 整合，实现通过 WhatsApp 与 AI 助手对话。

---

前提条件

• 已安装 OpenClaw（版本 2026.2.23 或更高）
• 有一台可访问 OpenClaw 服务器的终端
• 有一个 WhatsApp 账号（建议使用独立号码，也可用个人号码）

---

步骤一：添加 WhatsApp 配置

编辑 ~/.openclaw/openclaw.json，添加 channels 配置块：

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+86你的手机号"]
    }
  }
}

字段说明：

• dmPolicy: 访问策略
  • pairing - 首次发消息需要审批配对
  • allowlist - 只允许 allowFrom 列表中的号码
  • open - 允许所有人（不推荐）
• allowFrom: 允许的手机号列表，E.164 格式（带国际区号，如 +86138xxxx）

---

步骤二：链接 WhatsApp

在服务器终端运行：

openclaw channels login --channel whatsapp

终端会显示一个 QR 码。

扫码步骤：

1. 打开 WhatsApp 手机应用
2. 点击右上角 ⋮（三个点）
3. 选择 关联的设备 / Linked devices
4. 点击 关联设备
5. 扫描终端显示的 QR 码

扫码成功后，终端会显示 WhatsApp gateway connected。

---

步骤三：启动 Gateway

如果 gateway 没有自动运行，手动启动：

openclaw gateway start

或者重启：

openclaw gateway restart

---

步骤四：验证连接状态

openclaw channels status

正常输出应包含：

- WhatsApp default: enabled, configured, linked, running, connected, ...

---

使用方式

Self-Chat 模式（个人号码）

如果你用的是个人 WhatsApp 号码：

1. 在 WhatsApp 中新建聊天
2. 输入你自己的手机号（如 +86138xxxx）
3. 给"自己"发消息
4. AI 助手会收到并回复

这就是 self-chat 模式 — OpenClaw 作为你账号的"关联设备"，你给自己发消息就等于跟 AI 聊天。

独立号码模式（推荐）

如果你有独立的 WhatsApp 号码给 OpenClaw 使用：

• 直接给该号码发消息即可
• 多人可以共享这个号码跟 AI 对话

---

常见问题

QR 码扫不上

• 确保终端窗口足够大，QR 码完整显示
• 尝试调大终端字体
• 如果通过 SSH 连接，确保终端支持 UTF-8

显示 "logged out"

重新登录：

openclaw channels login --channel whatsapp

消息没反应

检查 gateway 状态：

openclaw gateway status
openclaw channels status

确保显示 running, connected。

响应慢

首次连接 + 模型响应需要几秒，后续会快一些。如果持续慢，检查：

• 网络连接
• 模型 API 响应时间

---

配置参考

完整配置示例：

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+86138xxxxxxxx"],
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["+86138xxxxxxxx"],
      "sendReadReceipts": true,
      "ackReaction": {
        "emoji": "👀",
        "direct": true,
        "group": "mentions"
      }
    }
  }
}

更多配置选项参考：https://docs.openclaw.ai/channels/whatsapp

---

文件路径

• 主配置文件：~/.openclaw/openclaw.json
• WhatsApp 凭据：~/.openclaw/credentials/whatsapp/default/

---