A comprehensive CLI tool for Beeper Desktop that enables programmatic access to chats, messages, and contact management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install roadrunner
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 roadrunner 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 roadrunner?
roadrunner (rr) is a robust command-line interface designed to interact with the local Beeper Desktop API. It provides developers and power users with the ability to list chats, send messages, search archives, and manage reminders across all bridged networks from a single terminal environment. By integrating roadrunner into Openclaw Skills, users can bridge their unified inbox with automated workflows, enabling seamless communication management without leaving the command line or their agent environment.
The tool is built with a focus on safety and structured data, offering an agent-specific mode that forces JSON output and read-only defaults. This makes it an ideal choice for building reliable Openclaw Skills that require interaction with platforms like iMessage, WhatsApp, Slack, and Discord through the Beeper ecosystem.
roadrunner Use Cases
- Automating responses to specific incoming messages across multiple chat networks.
- Performing global searches for text or media across all unified Beeper accounts via terminal.
- Programmatically managing focus modes and chat reminders to improve productivity.
- Extracting and summarizing chat history for research or data logging purposes.
- Uploading and sending files or media attachments through a unified messaging interface.
How roadrunner Works
- The user installs the roadrunner binary and authenticates using their Beeper Desktop token via the auth set command.
- The CLI establishes a connection with the local Beeper Desktop API running on the host machine.
- Commands are executed to query data (read) or perform actions (write) such as sending a message or archiving a chat.
- For automation, the tool utilizes flags like --agent to ensure the output is structured for machine parsing.
- The tool handles pagination and cursor management to navigate through large volumes of message history efficiently.
- All interactions are logged and can be audited, ensuring secure communication within the local environment.
roadrunner Setup
Installation
Install via Homebrew:
brew install johntheyoung/tap/roadrunner
Or install via Go:
go install github.com/johntheyoung/roadrunner/cmd/[email protected]
Configuration
Set up your authentication token:
rr auth set --stdin
Verify the installation:
rr doctor
rr auth status --check
roadrunner Data Schema & Taxonomy
roadrunner processes and returns data in structured formats, primarily JSON and JSONL, which are highly compatible with various Openclaw Skills.
| Object Type | Key Fields |
|---|---|
| Chat | id, display_name, unread_count, last_activity_at, is_archived |
| Message | id, text, sender_id, message_type, attachments, reactions |
| Contact | id, full_name, emails, phone_numbers, account_id |
| Account | id, network, is_connected, username |
Configuration is stored locally in ~/.config/beeper/config.json, maintaining a persistent state for authentication and default account settings.
roadrunner Advanced Features
- Support for --agent mode to enforce JSON structures and read-only safety for automated agents.
- Idempotent write operations using --request-id and --dedupe-window to prevent message duplication.
- Media management capabilities for downloading and streaming message attachments directly to stdout.
- Live event monitoring with rr events tail for real-time interaction within Openclaw Skills.
- Deep filtering for message searches by sender, date, and media type to pinpoint specific data.
- Command-specific help and discovery via rr capabilities and rr describe flags.
SKILL.md
Loading
Related Openclaw Skills
comfy-cli
A comprehensive command-line interface for installing, configuring, and scaling ComfyUI instances and their ecosystem of nodes and models.
Claw Conductor
An always-on autonomous development orchestrator that triages requests, decomposes complex tasks, and manages multi-model parallel execution.
last30days
A powerful research skill that scrapes the last 30 days of social media and web data to turn you into an instant expert on any topic.
Markdown Browser
A specialized orchestration layer that processes web fetch results into privacy-compliant, normalized markdown for AI agents.
Casely: AI-Powered QA Test Case Generator
Casely is an intelligent QA assistant for Openclaw Skills that transforms fragmented project documentation into structured, style-consistent test suites.
foodpanda-cli
A command-line tool for searching, browsing menus, and ordering food from foodpanda.ph with structured JSON output.
METADATA
Featured*
