Tencent SkillHub · Developer Tools

Withings Family

Fetches health data from the Withings API for multiple family members including weight, body composition (fat, muscle, bone, water), activity, and sleep. Use this skill when the user asks about their or their family's Withings data, weight history, body metrics, daily steps, sleep quality, or any health measurement from Withings devices.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: SKILL.md, scripts/withings.py, scripts/withings_oauth_local.py

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

Download the package from Yavira.
Extract it into a folder your agent can access.
Paste one of the prompts below and point your agent at the extracted folder.

New install

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.

Upgrade existing

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.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.1.2

Provenance

Publisher: odrobnik
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 18 sections Open source page

Multi-User Support

This skill natively supports multiple users with per-user token files: tokens-alice.json tokens-bob.json tokens-charlie.json Each family member authenticates once via OAuth. Their tokens are stored separately and refreshed automatically. No token copying or switching required — just pass the user ID as the first argument. python3 scripts/withings.py alice weight python3 scripts/withings.py bob sleep python3 scripts/withings.py charlie activity

When to Use This Skill

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 or their family's health progress over time

Setup: Creating a Withings Developer App

Before using this skill, you need to create a free Withings developer application to get your API credentials.

Step 1: Create a Withings Developer Account

Go to Withings Developer Portal Click Sign Up or Log In if you already have a Withings account Accept the Developer Terms of Service

Step 2: Create Your Application

Navigate to My Apps → Create an Application Fill in the application details: Application Name: Choose a name (e.g., "My Moltbot Health") Description: Brief description of your use case Contact Email: Your email address Callback URL: http://localhost:18081 (required for OAuth) Application Type: Select "Personal Use" or appropriate type Submit the application

Step 3: Get Your Credentials

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

Step 4: Configure Environment Variables

Add these to your Moltbot environment: export WITHINGS_CLIENT_ID="your_client_id_here" export WITHINGS_CLIENT_SECRET="your_client_secret_here" Or create a .env file in ~/.openclaw/withings-family/.env (legacy: ~/.moltbot/withings-family/.env): WITHINGS_CLIENT_ID=your_client_id_here WITHINGS_CLIENT_SECRET=your_client_secret_here

Configuration

The skill provides two scripts (in scripts/): scripts/withings_oauth_local.py — Automatic OAuth with local callback server (recommended) scripts/withings.py — Main CLI + manual OAuth Credentials location: ~/.openclaw/withings-family/ (legacy: ~/.moltbot/withings-family/) .env — Client ID/Secret (optional, can use ENV vars instead) tokens-<userId>.json — OAuth tokens per user (mode 600) 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 for that specific user.

Method A: Automatic OAuth (Recommended)

Uses a local callback server to capture the code automatically: python3 {baseDir}/scripts/withings_oauth_local.py <userId> Example: python3 {baseDir}/scripts/withings_oauth_local.py alice The script will: Print the authorization URL Start a local server on localhost:18081 Wait for the redirect Automatically capture the code and exchange for tokens Save tokens to tokens-<userId>.json

Method B: Manual OAuth

Traditional two-step flow (see "Authentication" command below).

Available Commands

All commands follow the format: python3 {baseDir}/scripts/withings.py <userId> <command> [options]

1. Authentication

First-time setup for a user — generates the OAuth URL: python3 {baseDir}/scripts/withings.py alice auth After the user visits the URL and gets the authorization code: python3 {baseDir}/scripts/withings.py alice auth YOUR_CODE_HERE Repeat for each family member who needs access.

2. Get Weight

Retrieve the latest weight measurements: python3 {baseDir}/scripts/withings.py alice 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" } ]

3. Get Body Composition

Retrieve comprehensive body metrics (fat, muscle, bone, water, BMI): python3 {baseDir}/scripts/withings.py alice 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%" } ]

4. Get Activity

Retrieve daily activity data (steps, distance, calories): python3 {baseDir}/scripts/withings.py alice activity Optionally specify the number of days (default: 7): python3 {baseDir}/scripts/withings.py alice 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" } ]

5. Get Sleep

Retrieve sleep data and quality: python3 {baseDir}/scripts/withings.py alice sleep Optionally specify the number of days (default: 7): python3 {baseDir}/scripts/withings.py alice 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 } ]

Error Handling

Common errors and how to resolve them: ErrorCauseSolution"No token found"User not authenticatedRun python3 scripts/withings.py <userId> auth and follow the OAuth flow"Failed to refresh token"Token expired and refresh failedRe-authenticate with python3 scripts/withings.py <userId> 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

Notes

Multi-user: Each family member has their own token file (tokens-{userId}.json) Token refresh: Tokens are automatically refreshed when they expire Scopes: Withings API scopes used: user.metrics, user.activity Device support: Data availability depends on which Withings devices the user owns Body composition: Requires a compatible smart scale (e.g., Body+, Body Comp)

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

2 Scripts1 Docs

SKILL.md Primary doc
scripts/withings_oauth_local.py Scripts
scripts/withings.py Scripts