介绍
# Ultrahuman (OpenClaw)
通过 **Ultrahuman MCP** 和 **mcporter** 获取 Ultrahuman 指标并进行汇总。
## Setup (one-time)
你需要：
1) **Ultrahuman Developer/Partner credentials**
你需要来自 Ultrahuman Developer Portal 的个人身份验证令牌： - https://vision.ultrahuman.com/developer
然后设置： - `ULTRAHUMAN_USER_EMAIL` - `ULTRAHUMAN_AUTH_TOKEN`（你的个人令牌） - （如果提供/需要，还需要在 Ultrahuman 应用中设置你的 Partner ID）
2) **Ultrahuman MCP server**
代码仓库： - https://github.com/Monasterolo21/Ultrahuman-MCP
构建它（示例）： - `bun install && bun run build` - 你应该会得到一个入口文件，例如：`dist/main.js`
3) **mcporter config**，用于定义一个名为 `ultrahuman` 的 MCP server
示例 `config/mcporter.json`（请调整到你构建的 `main.js` 的路径）：
```json { "mcpServers": { "ultrahuman": { "transport": "stdio", "command": "node", "args": ["/absolute/path/to/Ultrahuman-MCP/dist/main.js"], "env": { "ULTRAHUMAN_AUTH_TOKEN": "${ULTRAHUMAN_AUTH_TOKEN}", "ULTRAHUMAN_USER_EMAIL": "${ULTRAHUMAN_USER_EMAIL}" } } } } ```
## Quick start
### Daily summary (recommended)
从你的 OpenClaw 工作区运行（以便能找到 `./config/mcporter.json`）：
```bash cd /path/to/your/openclaw/workspace python3 skills/local/ultrahuman-openclaw/scripts/ultrahuman_summary.py --yesterday ```
特定日期：
```bash python3 skills/local/ultrahuman-openclaw/scripts/ultrahuman_summary.py --date YYYY-MM-DD ```
如果你的 mcporter 配置不在 `./config/mcporter.json`，请显式指定：
```bash python3 skills/local/ultrahuman-openclaw/scripts/ultrahuman_summary.py \ --date YYYY-MM-DD \ --mcporter-config /path/to/mcporter.json ```
### Raw JSON
```bash mcporter --config /path/to/mcporter.json \ call ultrahuman.ultrahuman_metrics date=YYYY-MM-DD --output json ```
## What to report (default)
除非有特别要求，否则保持摘要简短：
- Sleep score（睡眠评分） + total sleep（总睡眠） + efficiency（效率） + restorative sleep（恢复性睡眠） + deep/REM（深度/快速眼动睡眠） - Steps total（总步数） - Recovery index（恢复指数），movement index（活动指数），active minutes（活动分钟数） - VO2 max，sleep HRV（睡眠心率变异性），RHR（静息心率）
如果睡眠评分/总睡眠处于“Needs attention”（需关注）状态，请明确指出。