ultrahuman-openclaw

💍 智能戒指健康数据一键洞察

基于 Ultrahuman MCP 的健康数据查询工具,可获取智能戒指/CGM 的睡眠、心率、运动等核心指标,帮助用户快速掌握每日健康状态。

收藏
3.1k
安装
1.1k
版本
v0.1.2
CLS 安全性认证2026-05-12
点击查看完整报告 >

使用说明

核心用法

Ultrahuman (OpenClaw) 是一个专为 OpenClaw 环境设计的健康数据查询 Skill,通过调用 Ultrahuman MCP 服务器获取用户的智能戒指或 CGM 设备数据。用户需先完成三方配置:获取 Ultrahuman 开发者认证令牌、部署 Ultrahuman-MCP 服务、配置 mcporter 桥接工具。日常使用时,通过 ultrahuman_summary.py 脚本即可生成指定日期的健康摘要,支持 --yesterday 快捷查询和自定义日期参数。输出涵盖睡眠评分、睡眠阶段分布、静息心率、HRV、步数、恢复指数、VO2 max 等 10 余项核心指标,默认以简洁文本呈现,异常状态会自动高亮提示。

显著优点

数据整合度高:一次性聚合睡眠、运动、恢复、心血管四大维度的健康数据,避免用户在多个 App 间切换查看。本地化执行:所有数据处理在本地完成,原始 JSON 可通过 mcporter 直接获取,满足进阶用户的二次分析需求。配置灵活:支持环境变量、配置文件、命令行参数三种凭证注入方式,适配不同安全策略的工作环境。异常感知:内置"Needs attention"状态检测,自动标记需关注的睡眠或恢复指标,降低用户解读门槛。

潜在缺点与局限性

部署门槛较高:需要用户自行搭建 Node.js 环境、编译 MCP 服务器、配置 mcporter,对非技术用户不够友好。硬件依赖严格:必须拥有 Ultrahuman Ring 或配套 CGM 设备才能产生数据,无法服务更广泛的健康追踪用户。数据时效受限:仅支持历史日期查询,无法获取实时流数据,运动中的即时反馈场景不适用。生态封闭性:深度绑定 Ultrahuman 私有 API 和 OpenClaw 运行时,迁移至其他平台需重新开发适配层。

适合的目标群体

量化健康爱好者:已佩戴 Ultrahuman Ring、追求数据驱动健康管理的早期采用者。生物黑客与研究者:需要批量导出原始健康 JSON 进行自定义分析的技术型用户。OpenClaw 生态用户:已在该环境中构建个人工作流、希望将健康数据融入日常效率系统的开发者。睡眠优化关注者:对睡眠评分、恢复指数、HRV 趋势有持续追踪需求的高性能人群。

使用风险

依赖链脆弱性:mcporter 或 Ultrahuman-MCP 的版本更新可能导致接口不兼容,建议锁定版本并监控上游变更。凭证管理责任:ULTRAHUMAN_AUTH_TOKEN 需用户自行安全存储,硬编码在共享配置中存在泄露风险。数据准确性边界:Skill 仅做数据透传和格式化,不验证传感器原始数据的医学准确性,重大健康决策应咨询专业医师。子进程开销:每次查询触发 mcporter 子进程,高频调用可能产生性能瓶颈,批量分析场景建议直接调用底层 API。

安全解读

核心功能

Ultrahuman (OpenClaw) 是一个用于获取和分析 Ultrahuman Ring/智能戒指健康数据的本地工具 Skill。它通过调用 mcporter 与社区维护的 Ultrahuman MCP 服务器通信,获取用户的睡眠评分、睡眠阶段、心率变异性(HRV)、静息心率(RHR)、步数、恢复指数、运动指数、VO2 max 等关键健康指标,并以简洁的格式汇总输出。

显著优点

1. 本地化数据处理:数据获取和处理完全在本地执行,仅通过官方 Ultrahuman API 端点通信,不涉及第三方云端中转
2. 零依赖轻量化:仅使用 Python 标准库实现,无第三方包依赖,供应链攻击面极小

3. 安全配置:认证信息(ULTRAHUMAN_AUTH_TOKEN、ULTRAHUMAN_USER_EMAIL)通过环境变量管理,无硬编码密钥风险

4. 灵活查询:支持指定日期查询(--date YYYY-MM-DD)和昨日快速汇总(--yesterday),适配日常健康追踪场景

5. 健康状态提醒:当睡眠评分或总睡眠处于"需关注"状态时自动高亮提示

潜在局限

1. 外部 MCP 依赖:核心功能依赖社区开发者维护的 Ultrahuman MCP 服务器(非官方项目),存在维护中断或安全更新的不确定性
2. 需前置配置:用户需自行注册 Ultrahuman 开发者账号、获取个人授权令牌,并部署 MCP 服务器,上手门槛较高

3. 网络依赖:完全依赖 mcporter 子进程与 Ultrahuman API 通信,无法离线使用

4. 功能边界:仅支持数据读取与汇总,无数据写入、设备控制或长期趋势分析功能

适合人群

  • Ultrahuman Ring 用户,希望脱离官方 App 进行数据汇总或集成到本地工作流
  • 隐私敏感型用户,希望健康数据在本地处理而非同步至第三方服务
  • 开发者或技术用户,熟悉环境变量配置和命令行工具使用
  • 需要定期生成健康日报、周报的用户

常规风险

  • MCP 服务器代码需自行审查,社区项目可能存在未及时发现的安全漏洞
  • 开发者令牌(ULTRAHUMAN_AUTH_TOKEN)具备 API 访问权限,泄露后可被用于获取个人健康数据
  • 健康数据属于敏感个人信息,需确保运行环境安全,避免日志或命令历史中留存凭据

ultrahuman-openclaw 内容

scripts文件夹
手动下载zip · 4.6 kB
ultrahuman_summary.pytext/plain
请选择文件