WhatsApp Message Monitor Skill
Overview
This skill enables automated monitoring of WhatsApp conversations, filtering for specific keywords, and batch exporting matching messages to Feishu (Lark) multi-dimensional tables.
Core Features
- Target Monitoring: Configure WhatsApp contacts or groups to monitor
- Keyword Filtering: Define keywords or patterns to watch for
- Batch Collection: Accumulate messages until threshold is reached
- Scheduled Export: Periodically push collected messages to Feishu tables
- Real-time Alerts: Optional immediate notification for high-priority keywords
快速开始
1. 前提条件
使用此技能前，请确保：
- ✅ WhatsApp 访问权限：个人或商业账户
- ✅ 飞书/Lark 账户：具备 API 访问权限
- ✅ 飞书多维表格应用：已安装和配置
- ✅ OpenClaw WhatsApp 渠道：已配置并配对设备
2. OpenClaw 集成步骤
-
配置 WhatsApp 渠道
# 在 OpenClaw 中设置 WhatsApp 渠道
openclaw channels enable whatsapp
-
配对 WhatsApp 设备
- 打开浏览器访问 WhatsApp Web (web.whatsapp.com)
- 扫描二维码配对设备
- 确保设备状态显示为“已连接”
-
安装技能依赖
cd ~/whatsapp-monitor # 或你的克隆目录，例如 /opt/whatsapp-monitor
pip install -r requirements.txt
-
配置监控目标
# 编辑配置文件
python scripts/setup.py
-
配置飞书集成
- 获取飞书应用凭证 (App ID, App Secret)
- 创建多维表格并获取 Table Token
- 更新
config/feishu-settings.json
3. 首次运行
测试配置：
python scripts/monitor.py --test-config
启动监控：
python scripts/monitor.py --start
查看状态：
python scripts/monitor.py --status
2. Configuration Files
This skill uses two main configuration files:
config/whatsapp-targets.json - Define WhatsApp contacts/groups to monitorconfig/feishu-settings.json - Configure Feishu API and table settings
Configuration
WhatsApp Targets
Create config/whatsapp-targets.json:
{
"version": "1.0",
"targets": [
{
"name": "Project Team Chat",
"type": "group", // "contact" or "group"
"identifier": "1234567890-1234567890@g.us", // WhatsApp group ID
"enabled": true,
"keywords": ["urgent", "deadline", "blocker", "issue"],
"priority": "high"
},
{
"name": "Client Support",
"type": "contact",
"identifier": "+1234567890@c.us", // WhatsApp contact ID
"enabled": true,
"keywords": ["complaint", "escalation", "critical", "outage"],
"priority": "medium"
}
],
"monitoring": {
"scan_interval_minutes": 5,
"batch_size": 10,
"max_age_hours": 24,
"alert_on_high_priority": true
}
}
Feishu Settings
Create config/feishu-settings.json:
{
"feishu": {
"app_id": "YOUR_APP_ID",
"app_secret": "YOUR_APP_SECRET",
"table_app_token": "YOUR_TABLE_APP_TOKEN",
"table_token": "YOUR_TABLE_TOKEN"
},
"table": {
"name": "WhatsApp Monitor Log",
"fields": [
{"name": "timestamp", "type": "datetime"},
{"name": "source", "type": "text"},
{"name": "sender", "type": "text"},
{"name": "message", "type": "text"},
{"name": "keyword_matched", "type": "text"},
{"name": "priority", "type": "text"}
]
},
"export": {
"batch_threshold": 10,
"schedule": "every 30 minutes",
"retry_on_failure": true,
"max_retries": 3
}
}
使用工作流
设置阶段
-
初始化配置 - 设置监控目标和飞书凭证
python scripts/setup.py
-
测试连接 - 验证 WhatsApp 和飞书 API 连接
python scripts/monitor.py --test-config
-
启动监控 - 开始扫描配置的聊天
python scripts/monitor.py --start
OpenClaw Skill 集成
在 OpenClaw 中使用此技能：
# 加载技能（路径改为本机 Linux 上的技能目录）
openclaw skills load ~/whatsapp-monitor
# 或直接调用技能函数
openclaw skills run whatsapp-monitor --start
定时任务设置
通过 OpenClaw cron 设置定时监控：
# 创建定时任务
schedule:
kind: "cron"
expr: "*/5 * * * *" # 每5分钟运行一次
payload:
kind: "agentTurn"
message: "运行 WhatsApp 消息监控"
sessionTarget: "isolated"
实时通知配置
配置实时告警（当匹配到高优先级关键词时）：
- 在
config/whatsapp-targets.json 中设置：
{
"monitoring": {
"alert_on_high_priority": true
}
}
- 配置通知渠道（可选）：
Monitoring Phase
The system will:
- Periodically check configured WhatsApp chats
- Filter messages for keyword matches
- Store matching messages locally
- Export to Feishu when batch threshold is reached or on schedule
Export Phase
When ready to export, the system will:
- Format collected messages according to table schema
- Push to Feishu multi-dimensional table
- Clear local cache after successful export
- Log export status and any errors
Tools and Scripts
Core Monitoring Script
See scripts/monitor.py for the main monitoring logic.
Configuration Management
See scripts/config.py for handling configuration files.
Feishu API Integration
See scripts/feishu_client.py for Feishu table operations.
WhatsApp Web Automation
See scripts/whatsapp_web.py for WhatsApp Web interaction.
Advanced Features
Custom Filters
Beyond simple keywords, you can implement:
- Regular expression patterns
- Sentiment analysis
- Time-based rules
- Sender-specific filters
Alerting Options
Configure additional alert channels:
- Email notifications
- Slack/Teams messages
- SMS alerts
- Push notifications
Data Enrichment
Enhance collected messages with:
- Sentiment scores
- Entity extraction
- Topic classification
- Translation services
Troubleshooting
Common Issues
- WhatsApp Web Connection - Ensure browser automation is working
- Feishu API Permissions - Verify app has correct table permissions
- Keyword Matching - Check for case sensitivity and special characters
Monitoring Status
Check monitoring logs in logs/whatsapp-monitor.log for operational details and errors.
Integration Examples
Combine with Other Skills
This skill can be combined with:
- Calendar Integration - Trigger calendar events based on messages
- Task Management - Create tasks from important messages
- CRM Systems - Update customer records from support chats
Automated Reporting
Set up automated reports:
- Daily summary reports
- Weekly keyword trend analysis
- Monthly activity reports
Security Considerations
- Store sensitive credentials securely (use environment variables)
- Implement rate limiting for API calls
- Regularly audit access logs
- Consider data retention policies
Performance Optimization
For high-volume monitoring:
- Implement message deduplication
- Use batch API calls for Feishu
- Optimize keyword matching algorithms
- Consider distributed monitoring for multiple accounts
Maintenance
Regular maintenance tasks:
- Update keyword lists periodically
- Review export success rates
- Monitor API rate limits
- Backup configuration and logs
References
For detailed API documentation and additional resources, see:
Quick Commands
Start Monitoring
python scripts/monitor.py --start
Force Export
python scripts/monitor.py --export
View Status
python scripts/monitor.py --status
Test Configuration
python scripts/monitor.py --test-config
Support
For assistance or feature requests, refer to the troubleshooting section or contact the skill maintainer.
