什么是 Garmin 技能？

Garmin 技能允许 AI 代理通过 Transition 平台直接与 Garmin Connect 数据交互。通过将此技能集成到 Openclaw Skills，开发者和运动员可以将原始活动日志转化为对话式智能层。它在可穿戴硬件和大语言模型之间架起了一座桥梁，允许用户使用简单的语言询问关于其生理状态、训练历史和表现趋势的复杂问题。

此技能由 Transition 提供支持，负责同步 Garmin 数据并提供专门的 AI 教练端点。无论您是追踪最大摄氧量趋势、分析心率区间，还是计算训练压力平衡 (TSB)，此技能都为构建先进的健身助手和自动化教练工作流提供了必要的端点。

下载入口:https://github.com/openclaw/skills/tree/main/skills/nftechie/garmin-skill

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Garmin 技能 应用场景

• 分析月度跑步或骑行量与往期相比的趋势。
• 通过检查 TSB（训练压力平衡）和疲劳程度来监测恢复情况，以避免过度训练。
• 即时生成跑步、游泳或力量训练的结构化训练方案 (WOD)。
• 将计划好的训练直接推送到 Garmin 设备以便立即执行。
• 使用自然语言查询特定表现指标，如 FTP、阈值步速或心率区间。

1. AI 代理使用请求头中传递的各种安全 X-API-Key 进行 Transition API 身份验证。
2. 当用户提问时，代理将消息发送到拥有用户 Garmin 历史记录完整上下文的 AI 教练端点。
3. 对于定量分析，代理从 PMC（表现管理图表）或表现统计等端点检索结构化数据。
4. 代理处理 CTL（体能）、ATL（疲劳）和 TSB（状态）值，以提供科学的训练建议。
5. 如果达成训练协议，代理可以触发 POST 请求，将该特定训练直接推送到用户连接的 Garmin 硬件。

Garmin 技能 配置指南

要在 Openclaw Skills 中开始使用此技能，请按照以下步骤操作：

1. 下载 Transition 应用程序并关联您的 Garmin Connect 账号。
2. 在 Transition 应用中导航至 设置 > API 密钥，然后选择 生成新密钥。
3. 设置环境变量以验证您的请求：

export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

4. 对于每日训练 (WOD) 功能的免验证测试，您可以使用：

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

Garmin 技能 数据架构与分类体系

Garmin 技能将数据组织为几个逻辑领域，以帮助 Openclaw Skills 代理高效解析信息：

name: garmin-skill
description: Talk to your Garmin data — ask questions about your activities, training load, VO2 Max, heart rate zones, and more using AI.
homepage: https://www.transition.fun

Garmin Skill

Chat with your Garmin Connect data using AI. Ask about your runs, rides, swims, training load, VO2 Max, heart rate zones, and performance trends. Powered by Transition, which syncs with Garmin Connect to give AI agents access to your training data.

Setup

1. Download Transition and connect your Garmin account
2. Go to Settings > API Keys and tap Generate New Key
3. Set the environment variable:

export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

No Auth Required

Workout of the Day

Generate a random structured workout — no account needed.

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

Parameters:

• sport — run, bike, swim, or strength (default: run)
• duration — minutes, 10-300 (default: 45)

Authenticated Endpoints

Base URL: https://api.transition.fun Auth: Pass X-API-Key header on every request.

AI Coach Chat

Ask questions about your Garmin data. The AI coach has full context on your activities, training load, and performance.

curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" r
  -H "Content-Type: application/json" r
  -d '{"message": "How has my running volume changed this month compared to last?"}' r
  "https://api.transition.fun/api/v1/coach/chat"

Example questions:

• "What was my longest run this week?"
• "How is my VO2 Max trending?"
• "Am I overtraining based on my recent Garmin data?"
• "Compare my cycling power this month vs last month"
• "What does my heart rate data say about my fitness?"

Get Workouts

Retrieve scheduled workouts for a date range.

curl -H "X-API-Key: $TRANSITION_API_KEY" r
  "https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15"

Parameters:

• start — Start date (YYYY-MM-DD, required)
• end — End date (YYYY-MM-DD, required)
• Maximum range between start and end is 90 days.

Performance Management Chart (PMC)

Get CTL (fitness), ATL (fatigue), and TSB (form) calculated from your Garmin activities.

curl -H "X-API-Key: $TRANSITION_API_KEY" r
  "https://api.transition.fun/api/v1/performance/pmc"

Performance Stats

Get FTP, threshold paces, heart rate zones, and other metrics derived from your Garmin data.

curl -H "X-API-Key: $TRANSITION_API_KEY" r
  "https://api.transition.fun/api/v1/performance/stats"

Athlete Profile

curl -H "X-API-Key: $TRANSITION_API_KEY" r
  "https://api.transition.fun/api/v1/profile"

Chat History

curl -H "X-API-Key: $TRANSITION_API_KEY" r
  "https://api.transition.fun/api/v1/coach/history"

Push Workout to Garmin

Send a scheduled workout directly to your Garmin device.

curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" r
  "https://api.transition.fun/api/v1/workouts/123/push-garmin"

Rate Limits

Tips for Agents

1. Use coach chat as the primary interface. It has full context on the user's Garmin activities, training load, and performance — just ask natural questions.

2. Check fatigue before recommending hard workouts. Call GET /api/v1/performance/pmc and look at TSB. If TSB is below -20, the athlete is fatigued.

3. Use the free WOD endpoint for quick workouts. No auth needed — great for users who just want a workout suggestion.

4. Date format is always YYYY-MM-DD for all date parameters.