roadrunner
Beeper Desktop CLI for chats, messages, contacts, connect info, websocket events, search, and reminders.
Why use this skill?
Integrate Beeper Desktop into OpenClaw with the roadrunner skill. Manage chats, messages, and contacts securely via the Beeper local API.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/johntheyoung/roadrunnerWhat This Skill Does
The roadrunner (rr) skill integrates the Beeper Desktop CLI directly into your OpenClaw agent workflow. It provides a programmatic interface for interacting with your cross-platform messaging environment. By using the Beeper local API, this skill allows for searching across various messaging protocols, listing chat histories, managing contact information, and monitoring websocket events. Designed for high-utility automation, it supports structured JSON outputs that the agent can interpret to provide concise, context-aware summaries of your communication streams.
Installation
To begin using the skill, ensure you have the Beeper Desktop application installed and authenticated locally. Once configured, you can install the skill via the ClawHub terminal command:
clawhub install openclaw/skills/skills/johntheyoung/roadrunner
After installation, verify your environment with rr doctor. It is highly recommended to set your authentication credentials using rr auth set --stdin to ensure the agent has persistent access to your chat data without requiring manual token entry for every request.
Use Cases
- Efficient Communication Management: Quickly query unread messages across all platforms, search through chat archives for specific keywords, or retrieve contact details without leaving the terminal interface.
- Automation of Routine Queries: Programmatically fetch status updates on connection info or resolve contact IDs to initiate new conversations without searching through cluttered UIs.
- Monitoring and Notifications: Use the event stream features to keep tabs on incoming alerts or messages, which the agent can then summarize for you.
- Support for Power Users: Managing multiple accounts (e.g., iMessage, WhatsApp, Telegram) from a single source of truth, enabling quick switching and filtering of chats by account or activity timestamp.
Example Prompts
- "List my unread chats and summarize the most recent message from Jamie."
- "Search for any messages from yesterday regarding the project deadline and tell me the chat ID."
- "Send a message to Alice saying I will be five minutes late, but confirm the message details with me before you actually execute the command."
Tips & Limitations
- Safety First: Always use the
--agentflag for automated interactions. This forces JSON formatting and safe defaults like read-only mode to prevent accidental mutations. - Data Privacy: Treat all output from
rras private. The skill is designed to prevent leaking raw JSON dumps into outgoing messages. Instead, ask your agent to extract only the necessary information. - Ambiguity: If a chat ID or contact is ambiguous, the skill is configured to pause and ask for clarification. Do not force actions if you are unsure which thread is being targeted.
- Escaping: When passing message text through the shell, avoid using special characters that might trigger expansion. Use the
--stdinmethod to pass message bodies safely to avoid shell interpolation errors.
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-johntheyoung-roadrunner": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, external-api