WhatsApp 集成
通过 WhatsApp 控制你的 AI 助手
概述
WhatsApp 是全球最流行的即时通讯应用之一。通过 ClawdBot 的 WhatsApp 集成， 你可以直接在 WhatsApp 中与 AI 助手对话，就像和朋友聊天一样自然。
这是 ClawdBot 最推荐的使用方式之一 - 你的手机始终在身边， 随时随地都可以发送指令给 AI 助手。
工作原理
ClawdBot 使用 WhatsApp Web 协议（通过 Baileys 库）来连接你的 WhatsApp 账号。 这与你在浏览器中使用 WhatsApp Web 的方式相同。
- ClawdBot 作为一个 "已连接设备" 运行
- 消息通过端到端加密传输
- 不需要商业 API 或付费账号
- 使用你的个人 WhatsApp 号码
注意：你可以给自己发消息来触发 ClawdBot， 也可以在群组中 @mention 来使用。
配置步骤
步骤 1: 确保 ClawdBot 已安装
# 检查安装状态
clawdbot doctor
# 如果未安装，运行安装命令
curl -fsSL https://clawd.bot/install.sh | bash步骤 2: 启动登录流程
clawdbot channels login这将在终端显示一个 QR 码。
步骤 3: 扫描 QR 码
- 打开手机上的 WhatsApp
- 点击右上角的 ⋮ 菜单（Android）或 设置（iOS）
- 选择 已关联的设备
- 点击 关联设备
- 扫描终端中显示的 QR 码
步骤 4: 验证连接
# 检查连接状态
clawdbot channels list
# 应该显示 WhatsApp 已连接步骤 5: 发送测试消息
打开 WhatsApp，给自己发送一条消息：
Hello ClawdBot!ClawdBot 应该会在几秒内回复你！
功能特性
支持的消息类型
- 文本消息 - 普通对话、命令、问题
- 图片 - 发送图片让 ClawdBot 分析
- 语音消息 - 语音转文字后处理
- 文件 - 发送和接收各种文件
- 位置 - 分享位置信息
- 联系人 - 发送联系人卡片
群组功能
ClawdBot 也可以在群组中使用：
- 默认只响应 @mention 消息
- 可以配置为响应所有消息
- 支持群组管理命令
激活模式
# 总是响应（适合私聊）
/activation always
# 只响应 @mention（适合群组）
/activation mention
# 只响应特定前缀
/activation prefix !安全须知
使用 WhatsApp 集成时的安全考虑：
数据安全
- 消息通过 WhatsApp 的端到端加密传输
- ClawdBot 在本地处理消息，不上传到第三方服务器
- 会话凭证存储在本地
~/.clawdbot/目录
账号安全
- ClawdBot 使用官方的多设备协议
- 建议定期检查 WhatsApp 中的 "已关联设备"
- 如需断开，可在 WhatsApp 设置中移除设备
限制与风险
- WhatsApp 可能会限制异常活动的账号
- 避免短时间内发送大量消息
- 遵守 WhatsApp 的使用条款
故障排查
QR 码扫描失败
- 确保终端窗口足够大，能完整显示 QR 码
- 尝试调小字体或放大终端
- QR 码会在一段时间后过期，重新运行
clawdbot channels login
连接后无响应
- 检查 Gateway 是否运行：
clawdbot doctor - 确认给自己发消息（而不是其他联系人）
- 查看日志：
clawdbot logs
频繁断开连接
- 确保网络稳定
- 手机 WhatsApp 需要保持登录状态
- 检查是否有其他设备冲突
重新连接
# 断开当前连接
clawdbot channels logout --platform whatsapp
# 重新连接
clawdbot channels login