设置要求
WhatsApp集成需要快速初始化步骤和最小配置即可开始使用。确保你的环境满足基本要求，然后按照步骤进行配置。
快速初始化
简化的配置流程，几分钟内即可启动运行
最小配置
仅需必要的参数设置，无需复杂的配置文件
手机号码选项
| 选项 | 推荐度 | 说明 |
|---|---|---|
| 专用号码 | ⭐ 推荐 | 独立的电话号码，最佳安全性和稳定性 |
| 个人号码 | 备选 | 使用现有号码，方便但需注意隐私 |
⚠️ 注意事项
- 需要使用真实的手机号码
- VoIP号码会被WhatsApp封禁
- 建议使用专用的SIM卡号码
访问控制
私信策略支持三种访问模式，可根据安全需求灵活配置：
配对（Pairing）
通过配对码验证，只允许已配对设备访问
允许列表（Allowlist）
仅白名单内的号码可以与助手交互
开放（Open）
任何人都可以与助手对话，不推荐用于生产环境
多账户支持
OpenClaw支持同时管理多个WhatsApp账户，实现更灵活的部署方案。
登录语法
bash
# 添加WhatsApp账户
openclaw channel add whatsapp --name account1
# 查看所有账户
openclaw channel list凭证存储位置
账户凭证安全存储在状态目录中，默认位置为 ~/.openclaw/credentials/
群组聊天功能
提及模式
在群组中@提及机器人即可触发响应
上下文注入
支持群组聊天上下文的智能处理
消息处理
引用回复
支持对特定消息的引用回复功能
纯媒体消息
处理图片、视频等媒体内容
出站文本分块
长消息自动分块发送，避免截断
确认功能
自动表情回应配置，让交互更加直观友好。
💡 提示
可以配置自动发送✅、👍等表情回应，表示消息已收到和处理中。
媒体处理
支持格式
| 类型 | 格式 | 说明 |
|---|---|---|
| 图片 | JPG, PNG, WEBP | 支持发送和接收 |
| 音频 | MP3, OGG, OPUS | 语音消息支持 |
| 视频 | MP4 | 短视频处理 |
| 文档 | PDF, DOC, TXT | 文件传输支持 |
GIF处理
支持GIF动图的发送和接收，自动优化文件大小。
大小限制
单个文件最大支持 100MB，超过限制会自动提示。
配置示例
完整的JSON配置示例：
json
{
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["allowlist"],
"phoneNumber": "+1234567890",
"acknowledgeMessages": true,
"groupChats": {
"enabled": true,
"mentionMode": true
},
"media": {
"maxSize": "100MB",
"autoDownload": true
}
}
}
}监控与故障排除
Gateway心跳
监控连接状态，确保服务稳定运行
重连机制
自动重连和错误恢复
关键检查点
日志记录和状态检查工具
bash
# 查看Gateway状态
openclaw status
# 查看日志
openclaw logs --channel whatsapp
# 重启服务
openclaw gateway restart