Beeper桌面命令行工具

技能简介

roadrunner（简称 rr）是 Beeper Desktop 的本地 API 命令行客户端，支持通过终端操作聊天、消息、联系人、提醒事项及 WebSocket 事件。

能做什么

• 列出、搜索、获取聊天与会话信息
• 发送、搜索、监听消息，支持反应表情与附件下载
• 管理联系人，按账户维度查询与解析
• 预填草稿、聚焦会话窗口
• 订阅实时 WebSocket 事件流
• 以 JSON 格式输出，便于脚本集成

使用说明

安装方式（二选一）

# Homebrew
brew install johntheyoung/tap/roadrunner

# Go 直接安装
go install github.com/johntheyoung/roadrunner/cmd/rr@v0.16.2

首次配置

rr auth set --stdin    # 粘贴 token，保存至 ~/.config/beeper/config.json
rr auth status --check
rr doctor

常用命令示例

# 安全只读模式（推荐用于自动化）
rr --agent --readonly chats list --json

# 搜索聊天
rr chats search "项目群" --json

# 列出某聊天最近消息
rr messages list "!chatid:beeper.com" --json

# 发送消息（需显式指定聊天 ID 与内容）
echo "会议改到三点" | rr messages send "!chatid:beeper.com" --stdin --json

输入与输出

见下方输入与输出表格。

风险提示

• 默认只读：除非用户本轮明确请求修改操作，否则使用 --readonly
• 禁止外泄：不得将原始 JSON 输出直接粘贴到对外消息中，需摘要后呈现
• 令牌保护：不在对话中请求、展示或存储原始认证令牌；缺失时引导用户本地配置
• 注入防护：通过 shell 传递消息文本时避免变量扩展，优先使用 --stdin <<'EOF' 包裹字面量
• 模糊确认：聊天 ID 存在歧义时，先询问用户确认再执行发送

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/johntheyoung/roadrunner/SKILL.md
来源类型：GitHub 仓库