Beeper桌面命令行工具

技能简介

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

业务背景

面向高频使用Beeper Desktop的业务人员，无需切换图形界面即可通过终端快速检索历史会话、批量导出聊天记录或自动化消息处理。特别适合技术支持、客户运营等需跨多聊天窗口高效作业的场景，将重复性沟通工作脚本化，减少界面切换损耗。

落地案例：某客服主管每日需核查20+客户群的未读消息并汇总反馈。通过roadrunner命令行工具，其编写脚本自动拉取指定聊天ID的消息流，按关键词筛选高优先级问题，一键生成待办清单；遇到紧急客诉时，直接终端发送带附件的回复，全程无需打开桌面客户端，响应时效提升显著。

能做什么

• 列出、搜索、获取聊天与会话信息
• 发送、搜索、监听消息，支持反应表情与附件下载
• 管理联系人，按账户维度查询与解析
• 预填草稿、聚焦会话窗口
• 订阅实时 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 仓库