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 集成步骤

1. 1. 配置 WhatsApp 渠道

1. 2. 配对 WhatsApp 设备

1. 3. 安装技能依赖

1. 4. 配置监控目标

1. 5. 配置飞书集成

3. 首次运行

测试配置：
CODEBLOCK3

启动监控：
CODEBLOCK4

查看状态：
CODEBLOCK5

2. Configuration Files

This skill uses two main configuration files:

• - config/whatsapp-targets.json - Define WhatsApp contacts/groups to monitor
• INLINECODE2 - Configure Feishu API and table settings

Configuration

WhatsApp Targets

Create config/whatsapp-targets.json:

CODEBLOCK6

Feishu Settings

Create config/feishu-settings.json:

CODEBLOCK7

使用工作流

设置阶段

1. 1. 初始化配置 - 设置监控目标和飞书凭证

1. 2. 测试连接 - 验证 WhatsApp 和飞书 API 连接

1. 3. 启动监控 - 开始扫描配置的聊天

OpenClaw Skill 集成

在 OpenClaw 中使用此技能：

CODEBLOCK11

定时任务设置

通过 OpenClaw cron 设置定时监控：

CODEBLOCK12

实时通知配置

配置实时告警（当匹配到高优先级关键词时）：

1. 1. 在 config/whatsapp-targets.json 中设置：

1. 2. 配置通知渠道（可选）：

Monitoring Phase

The system will:

1. 1. Periodically check configured WhatsApp chats
2. Filter messages for keyword matches
3. Store matching messages locally
4. Export to Feishu when batch threshold is reached or on schedule

Export Phase

When ready to export, the system will:

1. 1. Format collected messages according to table schema
2. Push to Feishu multi-dimensional table
3. Clear local cache after successful export
4. 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

1. 1. WhatsApp Web Connection - Ensure browser automation is working
2. Feishu API Permissions - Verify app has correct table permissions
3. 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:

• - Feishu Open Platform API Reference
• WhatsApp Web Automation Guide
• Advanced Filtering Patterns

Quick Commands

Start Monitoring

Force Export

View Status

Test Configuration

Support

For assistance or feature requests, refer to the troubleshooting section or contact the skill maintainer.