beeperSearch and browse local Beeper chat history (threads, messages, full-text search).
Install via ClawdBot CLI:
clawdbot install KrauseFx/beeperInstall beeper-cli (go install):
Install beeper-cli (go install)Requires:
Beeper is a universal chat app that unifies messages from WhatsApp, Telegram, Signal, iMessage, Discord, and more in a single inbox.
This skill provides read-only access to your local Beeper chat history. Browse threads, search messages, and extract conversation data.
beeper-cli binary on PATHThe CLI auto-detects:
~/Library/Application Support/BeeperTexts/index.db (macOS)~/Library/Application Support/Beeper/index.db (macOS)Override with:
--db /path/to/index.dbBEEPER_DB=/path/to/index.dbbeeper-cli threads list --days 7 --limit 50 --jsonbeeper-cli threads show --id "!abc123:beeper.local" --jsonbeeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json# Simple search
beeper-cli search 'invoice' --limit 20 --json
# Phrase search
beeper-cli search '"christmas party"' --limit 20 --json
# Proximity search
beeper-cli search 'party NEAR/5 christmas' --limit 20 --json
# With context window (messages before/after match)
beeper-cli search 'meeting' --context 6 --window 60m --jsonbeeper-cli db info --json--json for structured output agents can parse--no-bridge)go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latestgit clone https://github.com/krausefx/beeper-cli.git
cd beeper-cli
go build ./cmd/beeper-cli
# Move beeper-cli to PATH, e.g., /usr/local/binSearch for work-related messages from last week:
beeper-cli threads list --days 7 --json | jq '.threads[] | select(.name | contains("work"))'
beeper-cli search 'project deadline' --limit 10 --jsonFind messages about invoices with context:
beeper-cli search 'invoice' --context 3 --jsonGenerated Mar 1, 2026
Support agents can search past chat histories to quickly find relevant conversations, such as previous troubleshooting steps or invoice details, enabling faster ticket resolution. This reduces response times and improves customer satisfaction by providing consistent, informed support.
Legal teams can use full-text search to locate specific messages or threads related to contracts, disputes, or regulatory compliance across integrated chat platforms. This aids in e-discovery processes and ensures thorough documentation for audits without manual data collection.
Project managers can browse threads and search for keywords like 'deadline' or 'meeting' to track project updates and decisions across team chats. This helps in monitoring progress, identifying bottlenecks, and maintaining organized records for post-project reviews.
Sales professionals can search for terms like 'invoice' or 'proposal' to review client interactions and follow-ups across messaging apps. This enables better pipeline management, ensures timely follow-ups, and helps in analyzing sales patterns for forecasting.
Researchers can use proximity search to find discussions on specific topics within collaborative chat groups, aiding in literature review or data sharing. This streamlines information retrieval from informal communications, supporting academic writing and team coordination.
Offer a cloud-based version of the skill with enhanced search analytics and team collaboration features, charging a monthly fee per user. This model targets businesses needing centralized chat history access, with revenue from recurring subscriptions and premium support tiers.
Provide custom integration services to help organizations deploy and customize the skill for specific use cases, such as compliance or CRM systems. Revenue is generated through one-time project fees and ongoing maintenance contracts, targeting enterprises with complex needs.
Distribute the skill as a free open-source tool with basic functionality, while offering premium features like advanced search filters, API access, or priority support for a fee. This model attracts individual users and small teams, converting them to paid plans as needs grow.
💬 Integration Tip
Ensure the Beeper Desktop app is installed and the database path is correctly set; always use the --json flag for structured output to facilitate easy parsing by other tools or scripts.
iMessage/SMS CLI for listing chats, history, watch, and sending.
Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
Use when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).
OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).