← 返回 Skills 市场
johntheyoung

Roadrunner

作者 johntheyoung · GitHub ↗ · v0.17.0
cross-platform ✓ 安全检测通过
5194
总下载
4
收藏
6
当前安装
30
版本数
在 OpenClaw 中安装
/install roadrunner
功能描述
Beeper Desktop CLI for chats, messages, contacts, connect info, websocket events, search, and reminders.
安全使用建议
Install this only if you trust the Roadrunner rr CLI and are comfortable giving it access to your Beeper account. Keep requests narrow, prefer readonly/agent modes for lookups, and only allow sends or edits when the recipient and message content are explicit.
功能分析
Type: OpenClaw Skill Name: roadrunner Version: 0.17.0 The roadrunner skill is a CLI tool for interacting with Beeper Desktop, providing capabilities to manage chats, messages, and contacts. The SKILL.md file contains extensive safety instructions for the AI agent, explicitly directing it to use read-only modes by default, avoid leaking raw authentication tokens or large data dumps, and use structured error handling. The tool's capabilities (e.g., reading messages, downloading media to ./media) are entirely consistent with its stated purpose as a messaging client, and no evidence of malicious intent or obfuscation was found.
能力评估
Purpose & Capability
The skill’s stated purpose is to operate Beeper Desktop through the rr CLI, and the documented abilities to list/search chats and messages, manage contacts, download/upload assets, send/edit messages, and manage reminders fit that purpose.
Instruction Scope
Runtime instructions default to read-only use, prefer agent/readonly/allowlisted command modes, require explicit recipient and message text for sending, warn on ambiguous chat IDs, and instruct the agent not to expose raw chat output or auth tokens.
Install Mechanism
Installation depends on an external rr binary from a Homebrew tap or a pinned Go module, which is expected for this integration but means users must trust that upstream CLI.
Credentials
Access to local Beeper Desktop, chats, contacts, media, and the Beeper API token is sensitive but proportionate to a Beeper messaging automation skill and is clearly disclosed.
Persistence & Privilege
No hidden background worker or persistence is present in the skill artifact; the main persistent element is the documented Beeper token saved in the local config file for continued authenticated CLI use.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install roadrunner
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /roadrunner 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.17.0
- Updated underlying CLI install version to v0.17.0. - Added command examples for `describe` (to show flag/command info) and new `--jsonl` (JSON Lines) output for chat and message lists/searches. - Added example of using `--dry-run` to validate mutating requests without actual API changes. - Minor clarifications and expanded examples for several commands and flags.
v0.16.2
roadrunner 0.16.2 adds new commands and updates for Beeper Desktop CLI. - Added `connect info` command for connect metadata. - Added `events tail` for experimental live websocket event streaming. - Added `contacts list` command. - Added message reaction commands: `messages react` and `messages unreact`. - Added chat start command using merged contact hints: `chats start`. - Updated install instructions and examples for the new features and API changes. - Improved OAuth introspection handling in `auth status --check`.
v0.14.4
- Updated installation and usage instructions to prefer `rr auth set` for authentication, removing the requirement for environment variables and config setup in metadata. - Bumped Go module and Homebrew formula to version 0.14.4. - Revised setup and notes to clarify token storage and override behavior. - Removed unused environment/config requirements from metadata for a simpler setup experience.
v0.14.3
roadrunner 0.14.3 - Updated install instructions to use rr version 0.14.3 for Go installation. - Added a new safety guideline: never paste raw rr command output (such as JSON or chat lists) into outgoing messages—summarize or extract only what’s needed. - No other user-facing changes noted.
v0.14.2
- Added a note under "Safety" about avoiding shell interpolation/expansion when sending message text (e.g. to prevent issues with `$`, `!`, or similar characters). - Suggested using `--stdin <<'EOF' ... EOF` for safely sending literal message text via the shell.
v0.14.1
- Updated skill metadata to explicitly require the BEEPER_TOKEN environment variable and the config file ~/.config/beeper/config.json. - Added required env and config under the "clawdbot" metadata for improved setup clarity. - No changes to CLI usage, commands, or documentation content.
v0.14.0
- Updated Go module installation to use version 0.14.0. - No functional or usage changes in documentation or features.
v0.13.0
roadrunner 0.13.0 - Simplified and tightened configuration: removed some config and state requirements; now only requires `BEEPER_TOKEN`. - Improved safety: defaults to read-only unless the user explicitly requests a mutation; never request or accept raw auth tokens in chat. - Mutating commands clearly separated; only allowed by explicit user request, with new guidance for safely handling retries. - Installation instructions updated with version pinning for Go installs. - Added more detailed error reporting: envelope errors include possible next-step hints. - Documentation and examples reworked for better clarity and safer usage.
v0.12.0
roadrunner 0.12.0 - Added detailed metadata about required config files, environment variables, and state directories for improved integration and discovery. - Documented new chat and message pagination options, including `--all`, `--max-items`, and automatic multi-page retrieval. - Added/expanded usage examples for sending attachments, uploading files, and editing messages. - Noted new options for bounding participants, streaming attachments, and uploading with metadata overrides. - Improved documentation structure and clarity while expanding command examples.
v0.9.0
roadrunner 0.9.0 changelog: - Added new `--agent` flag for agent-safe defaults (enables JSON, envelope errors, no-input, and readonly). - Introduced `rr capabilities --json` command for full CLI capability metadata. - Now supports default account selection with `--account` and the `BEEPER_ACCOUNT` environment variable. - Added account alias features (`accounts alias set`). - Enhanced contact and chat search/resolve commands with flag-based alternatives. - Updated documentation with new safety practices and improved sample usages.
v0.8.0
Version 0.8.0 introduces new global options for safer and more controlled command usage. - Added `--readonly` flag to block write operations. - Introduced `--enable-commands` to allowlist specific commands. - Added `--envelope` option for structured error responses in JSON. - Expanded documentation, including details on error codes and the `rr version --json` feature array.
v0.7.3
Version 0.7.3 of roadrunner - No file changes detected in this release. - No updates to functionality or documentation.
v0.7.2
Fix display name
v0.7.1
- Added note: The message JSON field `downloaded_attachments` is only populated when `--download-media` is used. - No other changes to usage or interfaces.
v0.7.0
No user-facing changes detected for version 0.7.0 (no file changes).
vv0.7.0
roadrunner v0.7.0 - Added `rr messages list --download-media --download-dir` option to download message media while listing. - Added `rr messages context` command to fetch context messages around a specific message. - Added `rr status --by-account` and `rr unread` commands. - Message JSON now includes `is_sender`, `is_unread`, `attachments`, and `reactions`.
v0.6.2
Version 0.6.2 of the "roadrunner" skill - No file or documentation changes detected in this release. - All functionality and usage remain unchanged from the previous version.
vv0.6.2
v0.6.2 - Updated documentation to clarify that rr contacts resolve is strict and fails on ambiguous names. - Now recommends resolving by ID after a contacts search if the contact name is ambiguous. - No functional changes to commands or APIs; documentation update only.
vv0.6.1
v0.6.1 — No changes detected - No file or documentation changes in this version. - The skill remains functionally and descriptively identical to the previous release.
vv0.6.0
Version v0.6.0 - Added new "resolve" commands: `rr contacts resolve` and `rr chats resolve`. - Introduced `rr messages wait` to wait for a message matching specific criteria. - Added `rr status --json` for status summaries. - Documentation updates for new commands and usage examples.
元数据
Slug roadrunner
版本 0.17.0
许可证
累计安装 196
当前安装数 6
历史版本数 30
常见问题

Roadrunner 是什么?

Beeper Desktop CLI for chats, messages, contacts, connect info, websocket events, search, and reminders. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 5194 次。

如何安装 Roadrunner?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install roadrunner」即可一键安装,无需额外配置。

Roadrunner 是免费的吗?

是的,Roadrunner 完全免费(开源免费),可自由下载、安装和使用。

Roadrunner 支持哪些平台?

Roadrunner 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Roadrunner?

由 johntheyoung(@johntheyoung)开发并维护,当前版本 v0.17.0。

💬 留言讨论