beeper

What This Skill Does

The beeper skill provides a powerful, read-only interface for your Beeper chat history directly within the OpenClaw agent environment. By integrating with your local Beeper SQLite databases, this skill allows the agent to navigate threads, retrieve specific message histories, and perform complex full-text searches across all your unified messaging platforms, including WhatsApp, Signal, Telegram, and iMessage. Because it operates locally on your machine, it maintains high performance and data privacy while enabling the agent to act as a personal assistant that understands your communications.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/krausefx/beeper

Ensure that the Beeper Desktop application is installed on your system, as this skill relies on the existing Beeper SQLite database path for data retrieval. Once installed, confirm the beeper-cli binary is available on your PATH. If you have a custom database location, you can point the skill to it using the BEEPER_DB environment variable or the --db flag.

Use Cases

This skill is ideal for users who need to surface historical information buried in long chat threads. Use it to find specific meeting notes, confirm invoice details from past discussions, or aggregate information from multiple messaging services without manually opening the Beeper app. It acts as an indexing layer for your digital life, allowing you to recall precise details from months of conversation history using natural language search or proximity-based query logic.

Example Prompts

1. "Search my recent Beeper messages for any mentions of 'invoice' or 'payment' from the last 7 days and summarize the findings."
2. "Find the thread titled 'Project Work' and list the last 10 messages so I can get up to speed."
3. "Did I mention the christmas party plans in any messages near the word 'catering' lately? Show me the context around those mentions."

Tips & Limitations

• Read-Only: This skill is strictly for data retrieval and cannot send messages, ensuring your personal chats remain secure from accidental automated responses.
• Performance: Always use the --json flag to ensure the agent receives machine-readable data, which minimizes parsing errors and improves response quality.
• Database Paths: If the CLI cannot find your database, manually set the path via the --db flag. This is particularly common if you have moved your Beeper installation to a non-standard directory.
• Full-Text Search: Leverage the FTS5 capabilities by using advanced syntax like NEAR/n for proximity searching to narrow down complex results quickly.