Channels

Clawdbot WhatsApp 集成指南

将 Clawdbot AI 助手连接到 WhatsApp,实现自动消息回复、智能对话和全天候 AI 驱动的 WhatsApp 聊天体验。

Clawdbot WhatsApp 集成概述

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

为什么选择 Clawdbot WhatsApp?

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

功能Clawdbot WhatsApp 优势
智能回复Clawdbot 自动生成智能 WhatsApp 回复
全天候服务您的 Clawdbot WhatsApp 助手永不休息
消息自动化使用 Clawdbot 自动处理重复的 WhatsApp 对话
隐私优先Clawdbot 本地运行,保护您的 WhatsApp 数据隐私
多账户支持将多个 WhatsApp 账户连接到 Clawdbot

设置 Clawdbot WhatsApp

前置条件

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

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

步骤 1:初始化 Clawdbot WhatsApp 频道

运行 Clawdbot WhatsApp 设置命令:

clawdbot channels add whatsapp

步骤 2:扫描二维码

Clawdbot 将显示用于 WhatsApp Web 认证的二维码:

clawdbot channels login whatsapp

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

步骤 3:验证 Clawdbot WhatsApp 连接

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

clawdbot channels status whatsapp

预期输出:

WhatsApp 频道状态:
- 连接: 已连接
- 账户: +1234567890
- 消息: 就绪
- Clawdbot: 活跃

Clawdbot WhatsApp 功能特性

智能消息处理

Clawdbot WhatsApp 处理收到的消息并生成上下文相关的回复。AI 理解对话历史并提供相关答案。

群组消息支持

Clawdbot WhatsApp 支持群组对话。配置 Clawdbot 应该响应哪些群组:

clawdbot configure whatsapp --groups "家庭,工作团队"

输入指示器

Clawdbot WhatsApp 在生成回复时显示输入指示器,使对话感觉更自然。

媒体支持

Clawdbot WhatsApp 可以处理和回复:

  • 文本消息
  • 图片(配合视觉 AI)
  • 语音消息(配合转录功能)
  • 文档

Clawdbot WhatsApp 配置

白名单配置

控制谁可以与您的 Clawdbot WhatsApp 助手互动:

{
  "whatsapp": {
    "allowlist": ["+1234567890", "+0987654321"],
    "groups": ["家庭", "工作"],
    "autoReply": true
  }
}

回复设置

自定义 Clawdbot 在 WhatsApp 上的回复方式:

设置描述
responseDelay在 Clawdbot WhatsApp 回复前添加自然延迟
maxLengthClawdbot WhatsApp 回复的最大消息长度
languageClawdbot WhatsApp 的首选语言

Clawdbot WhatsApp 凭证存储

Clawdbot 安全存储 WhatsApp 凭证:

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

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

Clawdbot WhatsApp 故障排除

连接断开

如果 Clawdbot WhatsApp 断开连接:

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

消息发送失败

如果 Clawdbot WhatsApp 无法发送消息:

  1. 验证账户状态:clawdbot channels status whatsapp
  2. 检查白名单配置
  3. 确保 Clawdbot 网关正在运行

二维码过期

如果 Clawdbot WhatsApp 二维码过期:

clawdbot channels logout whatsapp
clawdbot channels login whatsapp

Clawdbot WhatsApp 最佳实践

  1. 设置明确边界:配置白名单控制 Clawdbot WhatsApp 访问
  2. 监控使用情况:定期查看 Clawdbot WhatsApp 日志
  3. 定期更新:保持 Clawdbot 更新以获得最新 WhatsApp 兼容性
  4. 备份凭证:定期备份您的 Clawdbot WhatsApp 凭证

下一步