A CLI-based bridge for Beeper Desktop that allows AI agents to search, read, and manage messages across multiple chat platforms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install beeper-cli
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-cli 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?
The Beeper skill is a robust CLI wrapper designed to interact directly with the Beeper Desktop API. It provides a seamless way for developers and AI agents to manage unified messaging without needing complex MCP or curl setups. By utilizing Openclaw Skills, users can integrate their Beeper-connected networks—such as Telegram, WhatsApp, and Signal—directly into their automated workflows.
This skill focuses on efficiency, offering commands for chat discovery, message retrieval, and asset management. It is built to work in tandem with Beeper Desktop, ensuring that all actions taken via the CLI are reflected in the user's primary messaging interface.
Beeper Use Cases
- Searching for specific information or past conversations across multiple chat networks.
- Automating routine message replies or sending notifications through Beeper.
- Managing chat organization by archiving conversations or setting reminders via CLI.
- Handling file uploads and sharing attachments programmatically within a unified chat environment.
How Beeper Works
- The skill interfaces with the Beeper Desktop API using a secure access token.
- Users or agents perform discovery by searching for specific chats or listing recent accounts.
- Content is retrieved by listing messages in a specific chat ID or performing a global search for keywords.
- Actions such as sending a message, replying to a specific thread, or editing a previous post are executed via CLI commands.
- The skill handles asset management by uploading files to Beeper's servers and referencing the resulting IDs in messages.
Beeper Setup
To get started with this Beeper integration for Openclaw Skills, follow these steps:
- Enable the API in Beeper Desktop: Navigate to Settings > Developers and enable the API.
- Install the beeper-cli:
go install github.com/foeken/beeper-cli@latest
- Obtain your
BEEPER_ACCESS_TOKENfrom Beeper Desktop (Settings > Developers). - Set the environment variable:
export BEEPER_ACCESS_TOKEN="your_token_here"
Beeper Data Schema & Taxonomy
The skill organizes data primarily through JSON outputs, though table views are available for human readability.
| Object | Key Fields |
|---|---|
| Chat | chatID, account-id, type (dm/group), last activity |
| Message | messageID, sender, media-type, timestamp |
| Asset | uploadID, mxc:// URI, output path |
| Reminder | chatID, time (ISO 8601) |
Beeper Advanced Features
- Global search across all synchronized messaging accounts.
- Support for message replies using specific parent message IDs.
- Granular search filters for messages, including sender, date ranges, and media types.
- Ability to programmatically focus the Beeper Desktop window on specific conversations.
- Full asset lifecycle management including uploads and downloads of file attachments.
SKILL.md
Loading
Related Openclaw Skills
agentcash-wallet
A specialized tool for managing a crypto-wallet to automate pay-per-use API calls without the need for API keys or monthly subscriptions.
DOCX Management and Rendering Skill
A comprehensive tool for creating, editing, and visually validating high-fidelity DOCX documents using Python and system utilities.
Vendor Performance Audit
A structured quarterly review system for AI agents to evaluate vendor performance through weighted KPI scoring and automated improvement planning.
VendorGate System: Vendor Onboarding Workflow
A 5-gate structured framework to automate and professionalize the vendor onboarding lifecycle for mid-market operations teams.
spots
A high-precision CLI tool that uses grid-based scanning to find every business and location within a radius, bypassing standard search limitations.
OpenClaw Self Analyzer
A professional diagnostic and extension tool for analyzing OpenClaw architecture and generating automated hooks.
Featured*
