Clawdbot WhatsApp 集成指南

Clawdbot WhatsApp 集成概述

Clawdbot WhatsApp 集成让您可以将个人 AI 助手直接连接到全球最流行的即时通讯平台 WhatsApp。Clawdbot 通过 Baileys 使用 WhatsApp Web，由网关管理会话。这使您可以自动化对话、获得智能回复，并通过 AI 驱动的自动化管理您的 WhatsApp 消息。

为什么选择 Clawdbot WhatsApp？

WhatsApp 在全球拥有超过 20 亿用户。将 Clawdbot 与 WhatsApp 集成，您将解锁强大的 AI 功能：

快速设置（初学者）

1. 如果可能，使用单独的手机号码（推荐）
2. 在 ~/.clawdbot/clawdbot.json 中配置 WhatsApp
3. 运行 clawdbot channels login 扫描二维码（关联设备）
4. 启动网关

最小配置：

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

获取手机号码

WhatsApp 需要真实的手机号码进行验证。VoIP 和虚拟号码通常会被屏蔽。有两种支持的方式在 WhatsApp 上运行 Clawdbot：

专用号码（推荐）

为 Clawdbot WhatsApp 使用单独的手机号码。这提供最佳用户体验，路由清晰，没有自聊天问题。

理想设置：备用/旧 Android 手机 + eSIM。保持 Wi-Fi 和电源连接，通过二维码关联。

WhatsApp Business 提示：您可以在同一设备上使用不同号码的 WhatsApp Business，以保持个人 WhatsApp 分离。

个人号码（备选）

快速备选：在您自己的号码上运行 Clawdbot。使用"给自己发消息"功能进行测试。

配置示例（个人号码，自聊天）：

{
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

号码获取提示

• 本地运营商的 eSIM（最可靠）
• 预付费 SIM 卡 — 便宜，只需接收一条验证短信
• 避免：TextNow、Google Voice、大多数"免费短信"服务 — WhatsApp 会积极屏蔽这些

提示：号码只需接收一条验证短信。之后，WhatsApp Web 会话通过 creds.json 持久化。

设置 Clawdbot WhatsApp

前置条件

在将 Clawdbot 连接到 WhatsApp 之前，请确保您已具备：

• 设备上已安装 Clawdbot
• 拥有活跃手机号的 WhatsApp 账户
• Node.js 22 或更高版本

步骤 1：配置 WhatsApp 频道

将 WhatsApp 配置添加到 ~/.clawdbot/clawdbot.json：

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

步骤 2：使用二维码登录

运行 Clawdbot WhatsApp 登录命令：

clawdbot channels login

打开手机上的 WhatsApp，进入 设置 > 已关联的设备 > 关联设备，扫描 Clawdbot 显示的二维码。

多账户登录：

clawdbot channels login --account <id>

步骤 3：启动网关

clawdbot gateway --port 18789

步骤 4：验证连接

确认您的 Clawdbot WhatsApp 集成正常工作：

clawdbot channels status whatsapp

Clawdbot WhatsApp 功能特性

智能消息处理

Clawdbot WhatsApp 处理收到的消息并生成上下文相关的回复。AI 理解对话历史并提供相关答案。模型可以看到足够的上下文来理解引用回复。

DM 策略选项

群组消息支持

Clawdbot WhatsApp 支持群组对话。私聊使用代理的主会话；群组保持隔离。

媒体支持

Clawdbot WhatsApp 可以处理和回复：

• 文本消息
• 图片（配合视觉 AI）
• 语音消息（PTT 音频，配合转录）
• 文档
• 位置消息

Clawdbot WhatsApp 配置

完整配置示例

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

配置写入

默认情况下，WhatsApp 允许通过 /config set|unset 触发配置更新。禁用方式：

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

Clawdbot WhatsApp 凭证存储

Clawdbot 安全存储 WhatsApp 凭证：

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

• 备份副本在 creds.json.bak（损坏时恢复）
• 旧版兼容：旧安装直接在 ~/.clawdbot/credentials/ 中存储 Baileys 文件

您的 WhatsApp 会话数据保留在本地机器上，确保隐私安全。

Clawdbot WhatsApp 故障排除

连接断开

如果 Clawdbot WhatsApp 断开连接：

1. 检查网络连接
2. 重新认证：clawdbot channels login
3. 查看日志：cat /tmp/clawdbot/whatsapp.log

消息发送失败

如果 Clawdbot WhatsApp 无法发送消息：

1. 验证账户状态：clawdbot channels status whatsapp
2. 检查白名单配置
3. 确保 Clawdbot 网关正在运行
4. 出站发送需要活跃的监听器

二维码过期

如果 Clawdbot WhatsApp 二维码过期：

clawdbot channels logout
clawdbot channels login

Clawdbot WhatsApp 最佳实践

1. 使用专用号码：单独的手机号码提供最佳体验
2. 设置明确边界：配置白名单控制 Clawdbot WhatsApp 访问
3. 监控使用情况：定期查看 Clawdbot WhatsApp 日志
4. 定期更新：保持 Clawdbot 更新以获得最新 WhatsApp 兼容性
5. 备份凭证：定期备份您的 Clawdbot WhatsApp 凭证

为什么不用 Twilio？

WhatsApp Business 号码不适合个人助手：

• Meta 强制执行 24 小时回复窗口
• 高频使用会触发积极屏蔽
• 商业账户不适用于个人助手消息

下一步

• Clawdbot Telegram 集成 - 将 Clawdbot 连接到 Telegram
• Clawdbot Discord 集成 - 在 Discord 上设置 Clawdbot
• Clawdbot 设置指南 - 完整安装指南