Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Read-only CLI tool for searching and browsing your local Beeper chat history. Queries the SQLite database maintained by the Beeper desktop app using full-text search (FTS5). Never sends messages or modifies data.
Lets you search across all unified Beeper networks (WhatsApp, Telegram, iMessage, Discord, Signal, etc.) in a single query instead of switching between apps.
When to use it
- Find an invoice someone sent over WhatsApp last month
- Search across all chat networks for a specific project name
- Pull recent threads to review weekend messages
- Locate a shared link from a Signal conversation
- Extract conversation data from a specific contact or group
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: find messages about the Q1 budget from the last two weeks
- 1Run beeper-cli threads list --days 14 --json to identify relevant threads
- 2Run beeper-cli search 'Q1 budget' --limit 20 --json to find matching messages
- 3Run beeper-cli messages list --thread <thread-id> --limit 50 --json on matched threads
- 4Use --context flag to retrieve surrounding messages for fuller conversation context
List of messages mentioning Q1 budget with thread names, timestamps, and surrounding context
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.