A specialized command-line interface and LLM-friendly wrapper that enables AI agents to read, search, and send messages across all chat networks connected to Beeper.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install beeper-api-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-api-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 API CLI?
The beeper-api-cli is a robust integration designed for Openclaw Skills that connects AI agents directly to the Beeper unified messaging platform. By interfacing with the Beeper Desktop local API, this skill allows users to manage conversations from WhatsApp, Telegram, Signal, iMessage, and more through a single, consistent interface. It is specifically optimized for developers and AI agents, providing structured data outputs that make chat automation and context retrieval seamless.
This skill serves as a critical bridge for those building automated workflows within Openclaw Skills, offering a secure way to interact with various messaging protocols. It prioritizes safety with a mandatory user-in-the-loop protocol for sending messages, ensuring that while the agent can draft and retrieve information, the user maintains final control over all outbound communication.
Beeper API CLI Use Cases
- Consolidating unread messages from multiple networks into a single AI-processed summary.
- Retrieving specific conversation context to help an AI agent answer questions about past chats.
- Searching for keywords or shared links across diverse platforms like Slack, Discord, and WhatsApp simultaneously.
- Drafting responses to incoming messages and presenting them for user approval.
- Monitoring specific chat groups for urgent updates using Openclaw Skills automation.
How Beeper API CLI Works
- The skill establishes a connection to the Beeper Desktop local API server running on the host machine.
- It authenticates requests using a secure Bearer token generated within the Beeper Desktop settings.
- The agent or user executes commands to list active chats, fetch message history, or perform searches.
- All retrieved data is formatted into LLM-optimized JSON, ensuring high accuracy for AI parsing and processing.
- For message delivery, the skill follows a strict approval workflow where the AI must display the draft and wait for explicit confirmation before the CLI executes the send command.
Beeper API CLI Setup
First, enable API access in Beeper Desktop under Settings -> Advanced -> API and copy your Bearer token. Then, configure your environment variables:
export BEEPER_TOKEN="your-copied-token-here"
# Optional: Override the default local URL if necessary
export BEEPER_API_URL="http://[::1]:23373"
You can then verify the installation by listing your chats:
~/clawd/skills/beeper-api-cli/beeper.sh chats list --output json
Beeper API CLI Data Schema & Taxonomy
The skill returns structured data objects for both chats and messages to ensure compatibility with Openclaw Skills workflows.
Chat Object Schema
| Field | Type | Description |
|---|---|---|
| id | String | The unique network-specific identifier for the chat |
| title | String | The display name of the contact or group |
| network | String | The source platform (e.g., Telegram, WhatsApp) |
| unreadCount | Integer | Number of pending unread messages |
Message Object Schema
| Field | Type | Description |
|---|---|---|
| senderName | String | The name of the person who sent the message |
| text | String | The actual message content |
| timestamp | String | ISO 8601 formatted time of message receipt |
| isSender | Boolean | Indicates if the message was sent by the user |
Beeper API CLI Advanced Features
- Multi-format output support including JSON for agents, Text for humans, and Markdown for documentation.
- Automatic discovery of the Beeper Desktop API endpoint for zero-config local connections.
- Remote access capabilities allowing the CLI to interact with Beeper Desktop across a local network via IP whitelisting.
- Seamless integration with Unix pipes and tools like jq for advanced message filtering and data extraction within Openclaw Skills.
- Support for network-specific ID formats across all Beeper-supported bridges.
SKILL.md
Loading
Related Openclaw Skills
FTdesign HTML Generator
An automated interface builder that generates standardized HTML preview pages for lists, forms, and details using the FTdesign system.
NewsHelp Content Navigator
A navigation-first approach to accessing structured news data and global topic archives efficiently.
Deepgram CLI Skill
A powerful command-line interface for transcribing local audio files, remote URLs, and live microphone input using Deepgram's AI models.
PR Risk Analyzer
Automatically evaluate GitHub pull requests for security vulnerabilities, exposed secrets, and structural merge risks.
Drafts CLI
A macOS-native command-line interface for the Drafts app that enables programmatic note management and workflow automation.
Openclaw Feeds: RSS News Aggregator
A lightweight RSS aggregator that fetches real-time headlines across news, gaming, and finance categories without requiring external API keys.
Featured*
