beeper
Search chats, list/read messages, and send messages via Beeper Desktop using the beeper-cli.
Why use this skill?
Use the OpenClaw Beeper skill to search, manage, and send messages via Beeper Desktop. Automate your chat workflow and file sharing seamlessly.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/foeken/beeper-cliWhat This Skill Does
The beeper skill provides a seamless bridge between your OpenClaw AI agent and Beeper Desktop, enabling automated chat management and messaging capabilities. By leveraging the beeper-cli as a robust wrapper, this skill allows the agent to interact directly with the Beeper API without needing complex integrations or external middlewares. The agent can efficiently search for specific contacts, list and review message history, manage chat archives, and dispatch new messages. Furthermore, the skill supports advanced features like media attachments, message editing, and thread replies, making it a comprehensive communication engine for your agent.
Installation
To enable this skill, first ensure Beeper Desktop is installed and running with API access enabled via Settings > Developers. You must install the beeper-cli tool by running go install github.com/foeken/beeper-cli@latest in your terminal. Once installed, retrieve your API Access Token from the Beeper Desktop Developer settings and export it as an environment variable: export BEEPER_ACCESS_TOKEN="your_token_here". Finally, install the skill into your OpenClaw environment by running clawhub install openclaw/skills/skills/foeken/beeper-cli.
Use Cases
This skill is perfect for users who want to streamline their messaging workflow. It excels in professional scenarios such as retrieving specific project details from long chat histories, setting automated reminders on threads, or quickly sending status updates to team members across different platforms consolidated in Beeper. It is also highly effective for file management, allowing the agent to upload attachments and send them as part of a cohesive message thread without manual browser or app interaction.
Example Prompts
- "Find the last message from John regarding the project deadline and draft a reply thanking him for the update."
- "Search for the budget file I received in my chats last month and save it to my local downloads folder."
- "Send a message to the Team Alpha group saying the meeting has been rescheduled to 3 PM tomorrow."
Tips & Limitations
Always ensure the Beeper Desktop application is active; the CLI relies on the local API being reachable. Because the skill handles sensitive communication, treat your BEEPER_ACCESS_TOKEN with the highest level of security, storing it only in trusted environments or password managers. While the search functions are powerful, always double-check the recipient's chat ID before sending sensitive information to avoid accidental leaks. When performing batch operations, utilize the json output format if you are building complex logic flows within your agent's task planner.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-foeken-beeper-cli": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api
Related Skills
spots
Exhaustive Google Places search using grid-based scanning. Finds ALL places, not just what Google surfaces.
clippy
Microsoft 365 / Outlook CLI for calendar and email. Use when managing Outlook calendar (view, create, update, delete events, find meeting times, respond to invitations), sending/reading emails, or searching for people/rooms in the organization.