VitalClawVitalClawv0.1
ElizaOS Plugin·Open Source

Health data,
aggregated.

TypeScript SDK that unifies wearable health data into a single queryable layer. Vitals monitoring, trend analysis, alerts, and FHIR interop — built as an ElizaOS plugin.

Get StartedAPI Reference
$npm install @vitalclaw/sdk
CA0x0000000000000000000000000000000000000000
Vitals DashboardLive
Heart Rate
72bpm
Resting: 62 bpm
SpO2
97%
Normal range
Steps
8,432
Goal: 10,000
Sleep
7.5h
Score: 82/100
Wellness Score0
Capabilities

Everything your health agent needs

A complete health data layer — from raw wearable readings to actionable wellness insights, all type-safe and privacy-first.

📊

24+ Health Metrics

Heart rate, HRV, blood pressure, SpO2, glucose, sleep stages, steps, weight, temperature, VO2 max — all in a unified data model.

🚨

Smart Alert Engine

Threshold-based alerts with severity levels, cooldown windows, and custom rules. Ships with defaults for cardiac, respiratory, and metabolic anomalies.

📈

Trend Analysis

Linear regression-based trend detection over 7, 14, 30, or 90 days. Classifies each metric as improving, stable, declining, or insufficient data.

🏥

FHIR R4 Interop

Convert between VitalClaw data points and FHIR Observations using LOINC codes. Export full FHIR Bundles for healthcare system integration.

🔒

Privacy-First

Configurable data retention, anonymized exports, consent-based sharing, and local-first processing. Your health data stays under your control.

💯

Wellness Scoring

Composite 0-100 score computed from cardiac, activity, sleep, stress, and body composition data with auto-generated insights.

Integrations

Connect your devices

Seven provider adapters out of the box. Unified data model across all devices.

Fitbit
Fitbit
18 metrics
Garmin
Garmin
17 metrics
Withings
Withings
10 metrics
Apple Health
Apple Health
20 metrics
Google Fit
Google Fit
12 metrics
Oura Ring
Oura Ring
13 metrics
Manual
Manual
10 metrics
Architecture

From raw data to insights

⌚
Wearable Providers
Data synced from Fitbit, Garmin, Oura, Apple Health, or manual entry via unified HealthDataProvider interface.
🔄
Ingestion Engine
Raw readings normalized into VitalDataPoint format. Deduplication, unit conversion, and timestamp alignment.
🧠
Analysis Layer
Alert engine evaluates thresholds. Trend analyzer runs linear regression. Wellness scorer computes composite 0-100 scores.
📋
Summary Builder
Generates DailySummary and WeeklySummary with wellness scores, category breakdowns, and auto-generated insights.
🤖
ElizaOS Plugin
6 actions, 1 context provider, 1 safety evaluator. Agent answers "check my vitals" and "show trends" naturally.
ElizaOS Integration

Drop-in health agent

Plugin with actions, context provider, safety evaluator, and three pre-built agent characters.

Actions

CHECK_VITALS Latest vital signs with wellness score
DAILY_SUMMARY Comprehensive daily health report
WEEKLY_SUMMARY Weekly report with trends and insights
LOG_VITALS Parse and record manual measurements
HEALTH_TRENDS Trend analysis over configurable periods
SET_ALERT Custom threshold alert creation

Agent Characters

🩺
Vita
Health Companion

General-purpose health companion. Calm, precise, covers all metrics. Always disclaims medical advice.

🏋️
Rex
Fitness Coach

Energetic fitness tracker. Focuses on steps, calories, active minutes, VO2 max. Celebrates milestones.

🌙
Luna
Sleep Analyst

Gentle sleep specialist. Analyzes duration, stages, efficiency, consistency. Evidence-based sleep hygiene guidance.

Give your agent a pulse.

Install VitalClaw, connect your wearables, and let your ElizaOS agent understand your health data.

Read the Docs Star on GitHub
$ npm install @vitalclaw/sdk