wacli

WhatsApp CLI for AI agents. Read messages from groups and DMs via Baileys.

Install

git clone https://github.com/offloadmywork/wacli.git
cd wacli && npm install && npm run build && npm link

Setup (First Time)

wacli link --serve

Creates Cloudflare tunnel with QR code. User scans with WhatsApp → Settings → Linked Devices. QR expires in ~2 min.

Commands

wacli status                          # Check connection
wacli sync                            # Fetch message history
wacli chats [--groups|--dms] [--json] # List chats
wacli messages [options]              # Read messages
wacli search "query" [options]        # Search all chats
wacli download <messageId> [-o path]  # Download media from message
wacli unlink                          # Remove link

Message Filters

--since <time>    # 1h, 24h, 7d, 1m, or ISO date
--until <time>    # End time
--chat <id>       # Filter by chat ID/name
--sender <name>   # Filter by sender
--search <text>   # Search content
--groups          # Groups only
--dms             # DMs only
--limit <n>       # Max results (default: 100)
--include-media   # Download media attachments
--media-dir <dir> # Where to save media (default: ./media)
--json            # JSON output

Examples

wacli messages --since 3h
wacli messages --sender "Mom" --since 7d
wacli messages --groups --since 1h --json
wacli messages --since 1h --include-media    # Download all media
wacli download ABC123DEF -o ./downloads/     # Download specific media
wacli search "meeting" --since 7d

Storage

• Auth: ~/.config/wacli/auth/
• Data: ~/.config/wacli/data/

OpenClaw Skill

Symlink for agent access:

ln -sf /path/to/wacli/skill ~/.openclaw/skills/wacli

Troubleshooting

Issue	Fix
Not linked	wacli link --serve
Connection failed	wacli unlink && wacli link --serve
No messages	wacli sync
QR timeout	Re-run wacli link --serve, scan faster

License

MIT