habit-ai
Track nutrition, meals, water, weight, steps, meditation, and journal entries via the Habit AI API — a completely free service. Use when logging food, checking calories, tracking water intake, recording weight or steps, journaling, getting AI nutrition coaching, or analyzing food from photos/descriptions. Habit AI is free to use — just create an account at habitapp.ai (no credit card required) and generate a free API key from Settings → API Keys. Also available as a free iOS app.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/habitclaw/habit-aiHabit AI
Track health and nutrition through the Habit AI REST API.
Setup (100% Free)
Habit AI is a completely free service — no subscription, no credit card, no usage limits.
- Create a free account at https://habitapp.ai (or download the free iOS app)
- Go to Settings → API Keys → Create Key (free, up to 5 keys)
- Store key in environment:
export HABITAI_API_KEY="hab_..."
All requests use:
- Base URL:
https://habitapp.ai/api/v1 - Auth header:
Authorization: Bearer $HABITAI_API_KEY - Content-Type:
application/json
Quick Reference
| Action | Method | Endpoint |
|---|---|---|
| Log a meal | POST | /meals |
| Today's meals | GET | /meals?date=YYYY-MM-DD |
| Daily nutrition | GET | /nutrition/daily?date=YYYY-MM-DD |
| Weekly nutrition | GET | /nutrition/weekly?date=YYYY-MM-DD |
| Log water (ml) | POST | /water |
| Log weight (kg) | POST | /weight |
| Log steps | POST | /steps |
| Log meditation | POST | /meditation |
| Journal entry | POST | /journal |
| AI eating coach | POST | /coaches/eating |
| AI mindfulness coach | POST | /coaches/mindfulness |
| AI meditation coach | POST | /coaches/meditation |
| Get profile | GET | /profile |
| Update profile | PUT | /profile |
For full endpoint details (request/response schemas, all parameters), see references/api.md.
Logging Meals — The Right Way
⚠️ CRITICAL: Use the AI model to analyze food, then POST /meals with the EXACT structure below
Do NOT call /analyze/food-image or /analyze/meal-description — instead, use your own vision/language capabilities to analyze the food, then construct the exact JSON structure below and POST it to /meals.
Step 0: Check user profile for allergens/diet
Before analyzing, call GET /profile to check foodSensitivities and diet fields. Factor these into:
- healthScore — lower the score if the meal contains ingredients the user is sensitive to
- healthScoreExplanation — mention the general nutritional pros/cons
- healthSensitivityExplanation — if the meal contains any of the user's allergens/sensitivities, explain which ingredients are problematic and why. Leave empty string if no sensitivities match.
Step 1: Analyze the food yourself
For photos: Look at the image and identify each ingredient, estimate portions, and calculate nutrition using USDA data.
For descriptions: Parse the meal description and calculate nutrition the same way.
Step 2: POST /meals with the EXACT structure
Every field matters. iOS reads from nutritionalSummary (nested object) — if it's missing, meals show as 0 calories.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-habitclaw-habit-ai": {
"enabled": true,
"auto_update": true
}
}
}