Back to Registry
View Author Profile
Official Verified
Water Coach
Skill by oristides
skill-install — Terminal
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/oristides/water-coachOr
name: water-coach description: "Hydration tracking and coaching skill. Use when user wants to track water intake, get reminders to drink water, log body metrics, or get analytics on hydration habits." compatibility: "Requires python3, openclaw cron feature, heartbeat feature" metadata: {"clawdbot":{"emoji":"💧"} author: oristides
💧 Water Coach
First-time Setup
Follow the first setup here references/setup.md
🤖 How Other Agents Should Interact
First-time Setup Check
water setup
| is_setup | What to do |
|---|---|
| false | Ask: weight OR desired goal. Also ask: "What times do you want water reminders?" (let user configure their schedule). Then use water set_body_weight 80 or water set_goal 3000. Don't assume hardcoded times! |
| true | Skip setup. Just log water or show status. |
❌ Don't Ask
- Reminder schedules after first setup (user already configured)
✅ Do Ask
- "How much water did you drink?"
- Only weight/goal (first time)
CLI Structure
water_coach.py <namespace> <command> [options]
Namespaces: water | body | analytics
Data Format
CSV Format
logged_at,drank_at,date,slot,ml_drank,goal_at_time,message_id
| Column | Description |
|---|---|
| logged_at | When user told you (NOW) |
| drank_at | When user actually drank (user can specify past time) |
| date | Derived from drank_at |
| slot | morning/lunch/afternoon/evening/manual |
| ml_drank | Amount in ml |
| goal_at_time | Goal at that moment |
| message_id | Audit trail - link to conversation |
Key Rules:
- drank_at is MANDATORY - always required
- If user doesn't specify drank_at → assume drank_at = logged_at
- Cumulative is calculated at query time (not stored)
- Use drank_at to determine which day counts
Details at references/log_format.md
Audit Trail
Every water log entry captures:
- message_id: Links to the conversation message where user requested the log
- Auto-capture: CLI automatically gets message_id from session transcript
- Proof: Use
water audit <message_id>to get entry + conversation context
# Check proof of a water entry
water audit msg_123
# Returns: entry data + surrounding messages for context
Metadata
AI Skill Finder
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 skill Add to Configuration
Paste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-oristides-water-coach": {
"enabled": true,
"auto_update": true
}
}
}Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.