PB-Runner 跑步教练

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install pb-runner
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 pb-runner。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

PB-Runner 是一个适用于 iPhone、Apple Watch、Android 和 Garmin 设备的 OpenClaw 跑步教练集成。通过其 MCP 服务端，代理可以读取跑步、分段、心率、恢复指标、睡眠、HRV、静息心率、个人最好成绩、目标、计划训练和教练笔记。
该技能将这些数据转化为基础的教练对话和拟议的训练计划。它可以推荐在手表或手机上播放并带有实时提示的训练，但只有在跑者明确批准草稿后，它才会写入训练、个人资料更新、手动跑步或教练笔记。作为 Openclaw Skills 的健康和健身补充，它将可穿戴设备数据访问与基于同意的 AI 自动化结合在一起。

应用场景

查看最近的跑步、分段、配速、心率、海拔和姿势指标。
使用静息心率、HRV、睡眠和计划日程评估恢复情况。
根据跑者的目标、进度、校准配速和当前恢复情况创建 AI 支持的训练计划。
准备包含今日训练和恢复知情调整建议的早间打卡。
通过将新跑步与跑者基线进行比较来生成跑步后总结。
在每个写入步骤获得明确批准的情况下，刷新每周计划和教练笔记。
当路线和分段详情不可用时，从 CSV 导入较旧的 Garmin 历史记录。
使用集成的帮助工具帮助排查 Apple Health、Garmin Connect IQ、应用同步和账号连接问题。

工作原理

跑者安装 PB-Runner 并在 iPhone 上使用 Apple 登录或在 Android 上使用 Google 登录。
根据跑者的设备和历史记录，通过 Apple Health、PB-Runner 应用、Garmin Connect IQ 或 Garmin CSV 导入连接跑步数据。
OpenClaw 通过流式 HTTP 注册 PB-Runner MCP 服务端并开始 OAuth 登录。
跑者使用 PB-Runner 应用中使用的相同账号完成 OAuth，确保代理访问正确的训练历史记录。
在教练开始时，代理读取运动员资料和教练笔记，然后使用跑者的单位和校准的工作配速。
代理仅检索回答请求所需的相关的训练、恢复、目标、日程或帮助数据。
对于任何更改，代理都会调用建议工具，用通俗易懂的语言解释草稿，并等待明确的是（yes）。
批准后，代理提交最新的建议令牌；无人看管或计划中的运行从不自动提交更改。
计划工作流可以按合理的间隔提供早间打卡、跑步后总结或每周规划。
OAuth 令牌在正常使用期间会自动刷新，但如果刷新窗口在未使用七天后过期，跑者必须重新登录。

配置指南

1. 准备 PB-Runner 在跑者的设备上安装 PB-Runner，并使用应连接到 OpenClaw 的账号登录。配置合适的数据源：
   iPhone：允许 PB-Runner 读取 Apple Health。Apple Watch、通过 Apple Health 的 Garmin、Strava 以及其他兼容来源都可以贡献跑步数据。
   Android：在 PB-Runner 应用中记录跑步。
   Garmin：安装 PB-Runner Connect IQ 应用，在 PB-Runner 设置下生成连接码，并通过 Garmin Connect IQ 链接手表。
   较旧的 Garmin 历史记录：从 Garmin Connect 将活动导出为 CSV，并在 https://pb-runner.com/import 上上传。
2. 检查现有的 MCP 连接 openclaw mcp status --verbose
   如果 pbrunner 已列出并已登录，则无需进行额外的连接设置。
3. 将 PB-Runner 添加到 OpenClaw 在修改 OpenClaw 配置之前征得跑者的同意。PB-Runner 服务端需要流式 HTTP，而不是默认的 SSE 传输：
   openclaw mcp add pbrunner --url https://mcp.pb-runner.com/mcp --transport streamable-http --auth oauth
   openclaw mcp login pbrunner
   OpenClaw 文档可能要求在这些命令运行期间停止网关。该技能不应自行停止或重新启动网关。如果命令失败，请将其提供给跑者以便他们执行。
4. 完成 OAuth 将由 openclaw mcp login pbrunner 打印的登录链接发送给跑者。他们必须使用连接到 PB-Runner 的同一个 Apple 或 Google 账号。如果在另一台设备上进行登录且回调页面无法加载，请提取一次性 code= 值并运行：
   openclaw mcp login pbrunner --code
   该代码在 10 分钟后过期，并且只能使用一次。要重新连接过期的会话，请重新开始登录过程。
5. 验证数据访问 openclaw mcp status --verbose
   如果 get_runs 返回没有跑步记录或返回的跑步记录明显少于预期，请在根据不完整的数据提供教练指导之前，使用 PB-Runner 的帮助资源排查同步问题。

数据架构

已连接的数据
数据领域 示例 用途
跑步 距离、时间、配速、心率、分段、海拔、手表姿势指标 最近分析、跑步总结和跑步后总结
恢复 静息心率、HRV、睡眠 训练就绪度上下文和训练调整
运动员资料 年龄、性别、心率设置、最大摄氧量、单位 个性化和正确展示测量值
表现 个人最好成绩、基线比较、目标进度 进度追踪和计划决策
规划 计划日程、草稿训练、教练笔记 训练计划生成和已批准的更新
支持 同步、Garmin、手表和设置指导 通过 get_help 进行产品故障排查
工具和提案生命周期
读取工具包括 get_athlete_profile、get_coach_note、get_runs、get_run、get_recovery_context、get_training_summary、get_goal_progress 和 get_planned_schedule。
分析工具包括 compare_to_baseline 和相关的 PB-Runner 帮助查询。
写入操作使用两阶段模式：先使用 propose_planned_sessions、propose_coach_note 或其他提案工具，仅在明确批准后才使用提交工具。
提案确认令牌在五分钟后过期，且不得重复使用。
存储与隐私
该技能不添加单独的本地数据存储，也不存储任何 API 密钥。
OpenClaw 为 PB-Runner MCP 服务端存储 OAuth 连接（包括访问令牌和刷新令牌）。
PB-Runner 数据可以包括跑步和恢复信息，但集成不公开 GPS 路线和坐标。
OAuth 使用 openid、profile、email 和 offline_access 作用域。
可以使用 openclaw mcp logout pbrunner 注销。
导入的 Garmin CSV 历史记录包含摘要字段，例如距离、时间、配速和心率，但不包含路线或分段详情。

高级特性

基于同意的写保护要求在保存计划、教练笔记、个人资料更新或手动跑步之前提供最新的提案和明确的批准。
支持来自 Apple Watch、iPhone、Android、Garmin Connect IQ、Apple Health 和 Garmin CSV 导入的多设备训练数据。
可用时使用校准的教练笔记配速，而不是通用的配速表。
为个人资料、教练笔记和草稿训练摘要保留跑者特定的单位，同时转换原始指标有效负载以便展示。
以合理的频率限制提供定期的早间打卡、跑步后总结和每周规划工作流。
支持批准后在兼容的手表或手机上播放的实时提示训练。
使用 OAuth，无需 API 密钥或密码。
维护自动令牌刷新，并清晰处理过期的会话和缺失的 MCP 工具。
包含注意隐私的教练指导，并在出现疼痛、受伤、头晕、胸痛或异常心脏症状时引导跑者去看临床医生。
提供用于同步和产品问题的权威
get_help
路径，而不是发明应用菜单指令。
将可穿戴设备分析、MCP 连接和感知批准的自动化结合在 Openclaw Skills 的实用健康导向补充中。

name: pb-runner description: Connect your running data to OpenClaw and your AI running coach. Works with Apple Watch, Garmin, iPhone and Android. Your agent reads your runs, recovery (resting heart rate, HRV, sleep), personal bests and goal, and drafts a training plan whose sessions play on your watch or phone with live cues, which it is asked to save only after you say yes. OAuth sign-in (Apple or Google); no keys or passwords. version: 1.0.2