Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Fetches health data from the Withings API including weight, body composition (fat, muscle, bone, water), activity, and sleep. Use this skill when the user asks about their Withings data, weight history, body metrics, daily steps, sleep quality, or any health measurement from Withings devices.
Fetches health data from the Withings API including weight, body composition (fat, muscle, bone, water), activity, and sleep. Use this skill when the user asks about their Withings data, weight history, body metrics, daily steps, sleep quality, or any health measurement from Withings devices.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Use this skill when the user: Asks about their weight or weight history Wants to see their body composition (fat %, muscle mass, bone mass, hydration) Requests their daily activity (steps, distance, calories burned) Asks about their sleep data (duration, quality, deep sleep, REM) Mentions "Withings" or any Withings device (Body+, Sleep Analyzer, ScanWatch, etc.) Wants to track their health progress over time
Before using this skill, you need to create a free Withings developer application to get your API credentials.
Go to Withings Developer Portal Click Sign Up or Log In if you already have a Withings account Accept the Developer Terms of Service
Navigate to My Apps โ Create an Application Fill in the application details: Application Name: Choose a name (e.g., "My Clawdbot Health") Description: Brief description of your use case Contact Email: Your email address Callback URL: http://localhost:8080 (required for OAuth) Application Type: Select "Personal Use" or appropriate type Submit the application
Once your application is created: Go to My Apps and select your application You'll find: Client ID โ Set as WITHINGS_CLIENT_ID environment variable Client Secret โ Set as WITHINGS_CLIENT_SECRET environment variable
Add these to your Clawdbot environment: export WITHINGS_CLIENT_ID="your_client_id_here" export WITHINGS_CLIENT_SECRET="your_client_secret_here" Or create a .env file in the skill directory (this file will be ignored by git): WITHINGS_CLIENT_ID=your_client_id_here WITHINGS_CLIENT_SECRET=your_client_secret_here
The skill uses a wrapper.js script located in {baseDir}. Before any data retrieval, check if the user is authenticated. If an error mentions "No token found", guide the user through the initial authentication process.
First-time setup - generates the OAuth URL: node {baseDir}/wrapper.js auth After the user visits the URL and gets the authorization code: node {baseDir}/wrapper.js auth YOUR_CODE_HERE
Retrieve the latest weight measurements: node {baseDir}/wrapper.js weight Returns the 5 most recent weight entries in JSON format. Example output: [ { "date": "2026-01-17T08:30:00.000Z", "weight": "75.40 kg" }, { "date": "2026-01-16T08:15:00.000Z", "weight": "75.65 kg" } ]
Retrieve comprehensive body metrics (fat, muscle, bone, water, BMI): node {baseDir}/wrapper.js body Returns the 5 most recent body composition measurements. Example output: [ { "date": "2026-01-17T08:30:00.000Z", "weight": "75.40 kg", "fat_percent": "18.5%", "fat_mass": "13.95 kg", "muscle_mass": "35.20 kg", "bone_mass": "3.10 kg", "hydration": "55.2%" } ]
Retrieve daily activity data (steps, distance, calories): node {baseDir}/wrapper.js activity Optionally specify the number of days (default: 7): node {baseDir}/wrapper.js activity 30 Example output: [ { "date": "2026-01-17", "steps": 8542, "distance": "6.23 km", "calories": 2150, "active_calories": 450, "soft_activity": "45 min", "moderate_activity": "22 min", "intense_activity": "8 min" } ]
Retrieve sleep data and quality: node {baseDir}/wrapper.js sleep Optionally specify the number of days (default: 7): node {baseDir}/wrapper.js sleep 14 Example output: [ { "date": "2026-01-17", "start": "23:15", "end": "07:30", "duration": "8h 15min", "deep_sleep": "1h 45min", "light_sleep": "4h 30min", "rem_sleep": "1h 30min", "awake": "30min", "sleep_score": 82 } ]
Common errors and how to resolve them: ErrorCauseSolution"No token found"First time use, not authenticatedRun node wrapper.js auth and follow the OAuth flow"Failed to refresh token"Token expired and refresh failedRe-authenticate with node wrapper.js auth"API Error Status: 401"Invalid or expired credentialsCheck your CLIENT_ID and CLIENT_SECRET, re-authenticate"API Error Status: 503"Withings API temporarily unavailableWait and retry laterEmpty dataNo measurements in the requested periodUser needs to sync their Withings device
Tokens are automatically refreshed when they expire Withings API scopes used: user.metrics, user.activity Data availability depends on which Withings devices the user owns Some metrics (like body composition) require a compatible smart scale
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.