核心用法
peloton-stats 是一款面向 Peloton 骑行用户的轻量级数据聚合工具,通过直接调用官方 API(api.onepeloton.com)提取过去 7 天的骑行训练数据,生成结构化的 Markdown 周报。用户需预先配置 OpenClaw 凭据系统存储账号密码,随后执行 Python 脚本即可输出:本周骑行次数、总时长、消耗卡路里、输出功率(kJ)、平均功率(瓦)、平均阻力百分比及踏频(RPM),并附带近期课程明细表(日期、课程名、教练、各项数据)。
显著优点
1. 零依赖架构:仅使用 Python 标准库实现 HTTP 请求与 JSON 解析,无第三方包维护负担,部署极度轻量。
2. 数据维度完整:覆盖能量消耗、功率输出、阻力、踏频等骑行核心指标,满足严肃训练者的量化分析需求。
3. 本地优先:凭据存储于本地配置文件(~/.openclaw/agents/main/agent/auth-profiles.json),配合 OpenClaw 的加密机制,避免云端托管敏感信息。
4. 输出友好:自动生成 Markdown 表格,便于粘贴至笔记软件、博客或分享给教练。
潜在缺点与局限性
- 非官方 API 风险:
api.onepeloton.com为未公开文档的端点,Peloton 可能随时变更接口、增加鉴权限制或封禁非官方客户端。 - 账号安全依赖配置:虽然 OpenClaw 提供凭据管理,但明文配置文件路径暴露仍存在被其他进程读取的风险;用户若误操作权限设置可能导致凭证泄露。
- 功能单一:仅支持骑行数据,不包含跑步、力量、瑜伽等其他 Peloton 内容;时间窗口固定为 7 天,不支持自定义区间。
- 需要有效订阅:若用户会员到期,API 将返回空数据或鉴权失败。
适合人群
- 已订阅 Peloton、习惯量化训练的骑行爱好者
- 希望脱离官方 App 复杂界面、快速生成周报的极简主义用户
- 需要将训练数据导入个人知识库(Notion/Obsidian)或向教练汇报的进阶玩家
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 变动 | 非官方端点稳定性无保障,可能出现突然失效 |
| 凭证泄露 | 本地存储的密码文件若权限配置不当,存在被恶意软件读取可能 |
| 数据隐私 | 训练数据经 Peloton 服务器传输,虽无第三方中转,但仍受 Peloton 隐私政策约束 |
| 脚本执行 | 用户需手动运行 Python 脚本,存在误操作或环境配置错误导致执行失败的可能 |