A command-line tool for local Beeper chat history extraction, offering read-only access to threads, messages, and advanced full-text search.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install beeper
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install beeper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Beeper CLI?
The Beeper skill for Openclaw Skills provides a robust interface for interacting with the local SQLite database of the Beeper Desktop application. By consolidating messages from WhatsApp, Telegram, Signal, iMessage, and Discord into a single inbox, this tool allows users to query their entire communication history from a unified terminal interface.
Built for developers and power users who need fast access to their data, this skill ensures data privacy by operating locally and in a read-only capacity. It is an essential component for anyone looking to integrate their multi-platform chat logs into automated workflows or personal search engines powered by Openclaw Skills.
Beeper CLI Use Cases
- Finding specific project discussions or instructions buried across multiple chat platforms.
- Extracting invoice details or shared documents using full-text search commands.
- Auditing recent communication threads by filtering for activity within a specific number of days.
- Developing automated summaries of chat history by piping JSON output into other processing tools.
How Beeper CLI Works
- The skill detects the local Beeper database path automatically on macOS and Linux systems.
- It utilizes the beeper-cli binary to execute queries against the Beeper index.db file.
- The skill leverages SQLite's FTS5 extension to perform high-speed full-text, phrase, and proximity searches.
- Structured JSON output is returned, providing metadata like thread IDs, timestamps, and message content for further analysis.
Beeper CLI Setup
To get started with this skill, you must have the Beeper Desktop app installed and the beeper-cli binary available in your system PATH. Install the CLI using Go:
go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest
Ensure your local database is located at the default path or set the BEEPER_DB environment variable to point to your index.db file.
Beeper CLI Data Schema & Taxonomy
The skill manages data extracted from the Beeper SQLite schema, primarily focusing on three data structures:
| Entity | Description |
|---|---|
| Threads | Metadata including unique IDs, display names, and last activity timestamps. |
| Messages | Individual message records with sender information, text content, and sequence IDs. |
| Search Context | Extended message windows providing 3-6 messages of context around search hits. |
Beeper CLI Advanced Features
- Support for complex SQLite FTS5 queries including NEAR proximity operators.
- Contextual search windows that provide surrounding messages for better situational awareness.
- DM name resolution which pulls contact names from bridge-specific databases.
- Fully structured JSON output designed for seamless integration with Openclaw Skills agents.
- Environment variable overrides for custom database locations and configurations.
SKILL.md
Loading
Related Openclaw Skills
KDP Publisher
A comprehensive AI agent skill for automating the end-to-end creation, formatting, and uploading of books to Amazon Kindle Direct Publishing.
Polymarket BTC 15m Trading Skill
A professional-grade trading skill for Polymarket Bitcoin 15-minute markets featuring automated signal processing and dynamic position sizing.
Polymarket BTC 15m Trading
An automated trading tool for Polymarket Bitcoin 15-minute markets featuring dynamic risk management and signal-based execution.
Polymarket BTC 15m Trading Skill
A high-frequency trading skill for Polymarket Bitcoin 15-minute markets with automated signal execution and risk management.
Homey CLI
A robust CLI tool designed for AI agents to securely control Homey home automation hubs and manage smart devices.
Austrian Post (post.at) CLI
A powerful CLI tool to manage Austrian Post deliveries, including tracking, listing, and setting delivery preferences.
Featured*
