A command-line interface for the Beeper Desktop API that enables unified messaging across platforms like Telegram, WhatsApp, and Slack.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install beepctl
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 beepctl 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 beepctl?
beepctl is a versatile CLI tool designed for the Beeper Desktop API, allowing developers and power users to interact with multiple messaging platforms through a single, unified interface. By integrating this tool into your workflow, you can handle conversations across Telegram, WhatsApp, Slack, and iMessage without leaving your terminal. This Openclaw Skills entry highlights how the tool simplifies cross-platform communication through structured commands.
The skill provides deep integration with Beeper, enabling actions such as searching chat histories, managing unread messages, and automating reminders. It is built to bridge the gap between various messaging protocols and the command line, making it an essential utility for those who prefer a keyboard-centric approach to digital communication.
beepctl Use Cases
- Search for specific keywords across all connected messaging accounts simultaneously.
- Send quick replies or automated messages to chats using custom aliases.
- Monitor unread notifications and manage inbox priorities from the terminal.
- Archive old conversations or set reminders for follow-ups without opening a GUI.
- Access and download attachments or media files directly via MXC URLs.
How beepctl Works
- The user authenticates with their Beeper Desktop API token to establish a secure connection.
- The CLI communicates with the Beeper local bridge to fetch chat metadata and message histories.
- Users execute commands to list accounts, search messages, or manage chat aliases for faster access.
- When sending messages, the tool routes the request through the specified messaging protocol via Beeper.
- Advanced actions like focus interact with the Beeper Desktop application to bring specific conversations to the foreground.
beepctl Setup
To get started with this tool as part of your Openclaw Skills collection, install the package via npm:
npm install -g beepctl
After installation, configure your API token:
beepctl auth set <your-beeper-api-token>
Verify your connection by listing your accounts:
beepctl accounts
beepctl Data Schema & Taxonomy
The skill organizes communication data into several key entities to streamline interaction within Openclaw Skills:
| Entity | Description | Key Attributes |
|---|---|---|
| Accounts | Connected messaging platforms | ID, Service Name, Status |
| Chats | Conversation threads | Chat-ID, Name, Type (Group/Single), Inbox Status |
| Messages | Individual entries | Msg-ID, Sender, Content, Timestamp, Media Type |
| Aliases | Custom shortcuts | Alias Name, Target Chat-ID |
| Reminders | Scheduled notifications | Chat-ID, Due Time |
| Media | File attachments | MXC URL, Local Path |
beepctl Advanced Features
- Powerful multi-filter search combining chat type, media type, sender, and time-based parameters.
- Custom chat aliasing to replace complex IDs with human-readable names like work or family.
- Deep linking capabilities using the focus command to jump directly to specific messages or pre-fill drafts.
- Comprehensive inbox management including filtering by unread status, low-priority, or archived states.
- Support for downloading media attachments directly to a specified local directory.
SKILL.md
Loading
Related Openclaw Skills
PixelDojo
A professional-grade integration for generating AI images and videos via PixelDojo's unified creative API.
Crypto Daily Report Skill
An automated AI agent skill that aggregates, filters, and formats comprehensive daily cryptocurrency market reports for Telegram distribution.
Metaplex Genesis Token Launch
A protocol-driven skill for launching Solana tokens with fair distribution and automated Raydium liquidity graduation.
Voice Call
A versatile skill that enables AI agents to initiate, manage, and interact through voice calls using leading telephony providers.
mm-easy-voice
A high-performance text-to-speech tool for Openclaw Skills that converts text to natural audio using the MiniMax Voice API.
MiniMax Music Expert
An advanced AI music generation skill that transforms text prompts and lyrics into professional-grade audio tracks using MiniMax models.
Featured*
