Health-Mate

Health-Mate is an executable OpenClaw skill, not a prompt-only package.

It reads structured Markdown logs from MEMORY_DIR, generates localized PDF reports, and can optionally deliver the final message to external services.

What It Does

• - Parses meals, hydration, exercise, symptoms, medication, and custom monitoring sections
• Generates daily reports with scoring, detail sections, AI insight, risk alerts, and next-day actions
• Generates weekly reports with rings, paired trend charts, audience-specific insight modules, weekly review, and next-week plan
• Generates monthly reports with radar, branch-aware heatmaps, 30-day weight and BMR trend, specialty charts, follow-up reminders, and clinic suggestions
• Supports explicit report routing through report_preferences.population_branch, while the setup wizard still auto-suggests lifestyle vs disease mode from the primary goal
• Switches balanced / fat_loss reports into a lifestyle-review path with activity heatmaps, energy-balance, habit-progression, and lean-mass/fat-mass charts while skipping hospital lookup
• Supports multi-condition management in both LLM and local fallback paths
• Keeps core parsing, scoring, and PDF rendering local

Installation

CODEBLOCK0

Dependencies:

• - INLINECODE4
• INLINECODE5
• INLINECODE6

Required Runtime Setup

Required:

• - INLINECODE7

Optional:

• - INLINECODE8
• INLINECODE9
• INLINECODE10
• INLINECODE11
• INLINECODE12
• INLINECODE13
• INLINECODE14
• INLINECODE15
• INLINECODE16
• INLINECODE17
• INLINECODE18
• INLINECODE19

For ClawHub manual folder upload:

• - config/.env.example may be missing from the uploaded package
• use the top-level env block inside config/user_config.example.json as the upload-safe reference template
• the setup wizard can create a commented project-local config/.env template if the file does not already exist
• runtime scripts still read project-local INLINECODE24
• keep only the keys you intend this skill to read inside project-local INLINECODE25

Upgrade And Backup Notice

Before upgrading or reinstalling this skill, back up:

• - INLINECODE26
• INLINECODE27
• any local font file you manually placed under INLINECODE28

Important:

• - some platform upgrade or reinstall flows may overwrite, reset, or remove local configuration files
• after an upgrade, re-check MEMORY_DIR, report preferences, scoring modules, webhook settings, and Tavily settings before running scheduled jobs again
• if needed, also verify report_preferences.population_branch in INLINECODE31

Local And Network Behavior

Expected local file I/O:

• - reads Markdown logs from INLINECODE32
• reads project-local config/.env when shell runners are used and the file exists
• the setup wizard may create a commented project-local config/.env template when the file is missing
• may rely on config/user_config.example.json as the upload-safe env reference during manual installation
• writes PDFs into INLINECODE36
• writes logs into INLINECODE37
• may create a temporary English memory mirror for rendering fallback

Expected network I/O:

• - Tavily only when TAVILY_API_KEY is configured
• webhook delivery only when the matching delivery credentials are configured
• runtime font download only when INLINECODE39

Important:

• - there is no implicit default MEMORY_DIR fallback in the shell runners
• the skill exits if MEMORY_DIR is missing
• shell runners use NVM_DIR and CRON_PATH from the environment or project-local config/.env, with built-in defaults when those keys are missing
• the Python local-LLM resolver uses OPENCLAW_BIN first and then tries common install paths without hardcoding a single fixed cron INLINECODE46

Commands

• - INLINECODE47

• - INLINECODE48

• - INLINECODE49

Memory Write Protocol

When writing into MEMORY_DIR, the model must act like a strict recorder.

Hard rules:

1. 1. Never write commentary, advice, summaries, emoji, or chat filler into the file.
2. Meals, hydration, medication events, and exercise events must use level-3 headings with time markers.
3. Hydration blocks must remain minimal and structured.
4. Step totals must stay in one dedicated level-2 block.
5. Monitoring modules must use stable level-2 headings.
6. Use one language per block.

Core template:

CODEBLOCK1

Chinese core template:

CODEBLOCK2

Chinese monitoring-module constraints:

• - ## 血压记录 / ## 血糖记录 / ## 体成分 / ## 生化记录 must stay as stable level-2 titles
• numeric monitoring blocks should use stable item labels such as - 血压：128/82 mmHg, - 血糖：7.1 mmol/L, INLINECODE57
• do not mix commentary into monitoring blocks
• do not turn monitoring blocks into tables
• do not rename the same monitoring module on different days unless the user intentionally changed the module name

Recommended LLM instruction:

• - paste the English or Chinese template above directly into your system prompt, soul.md, or memory-write policy so the model stays inside the parser-safe structure
• if custom modules are enabled in user_config.json, add their exact section titles to the LLM write protocol and keep those titles stable across days

Expandable monitoring modules:

CODEBLOCK3

Forbidden content:

• - INLINECODE60
• INLINECODE61
• INLINECODE62
• motivational filler
• debug notes
• system logs
• tables inside daily memory files

Monthly Report Expectations

The monthly report now includes:

• - macro adherence radar
• healthy-day donut chart based on the full calendar month
• symptom and medication heatmap
• 30-day weight and BMR trend
• condition-specific specialty charts
• lifestyle-mode specialty charts for balanced / fat_loss: energy balance, four-week habit progression, and lean-mass/fat-mass composition
• AI monthly review
• follow-up reminders or periodic screening suggestions, depending on the active monthly mode
• residence-aware hospital-and-doctor suggestions with grouped recommendations, grades, booking hints, and optional fee / schedule fields for disease-management modes

If the user manages multiple conditions, the monthly report should combine them instead of collapsing to a single narrow perspective.

Font Fallback

Preferred CJK font paths:

• - INLINECODE65
• INLINECODE66

If one of them is missing:

• - the skill may switch to an English-compatible rendering path
• the output adds a rendering notice
• users who need Chinese PDF output should place NotoSansSC-VF.ttf into INLINECODE68
• users who need Japanese PDF output should place NotoSansJP-VF.ttf into INLINECODE70

Changelog

v1.5.4 - 2026-04-01

• - Enhanced PDF visual styling with refined layout and improved readability
• Fixed minor formatting issues in daily, weekly, and monthly report generators
• Optimized symbol rendering for better cross-platform compatibility

v1.5.3 - 2026-03-29

• - Sanitized local-LLM stdout before AI commentary is embedded into push text or PDFs, preventing OpenClaw plugin-registration logs from leaking into reports
• Added a second daily-PDF commentary filter as a defensive fallback for unexpected plugin log fragments
• Aligned direct Python execution with the shell runners by auto-loading project-local config/.env when variables are not already exported

v1.5.2 - 2026-03-25

• - Updated the upload-safe env example with OpenClaw default MEMORY_DIR, sanitized web-publish placeholders, and the shared LOG_FILE example
• Extended init_config.py so first-time setup can create a commented project-local config/.env template without overwriting an existing one
• Clarified SKILL metadata and runtime notes around project-local .env, cron PATH helpers, and optional-network behavior
• Verified that the setup wizard really creates the commented config/.env template when the file is missing
• Added a monthly lifestyle-review split for balanced / fat_loss, including new charts, renamed section titles, screening suggestions, and hospital-lookup bypass

v1.5.1 - 2026-03-24

• - Optimized Cron environment configuration for reliable LLM invocation in scheduled tasks
• Embedded the upload-safe env reference into INLINECODE79
• Kept daily_health_report_pro.sh, weekly_health_report_pro.sh, and monthly_health_report_pro.sh loading environment variables from INLINECODE83
• Changed all shell script comments to English for better internationalization
• Ensures scheduled daily/weekly/monthly reports can successfully call local LLM for AI insights

v1.5.0 - 2026-03-23

• - Removed the legacy scripts/health_report_pro.py and scripts/pdf_generator.py wrappers
• Extended init_config.py to cover INLINECODE87
• Clarified env-first local LLM resolution through OPENCLAW_BIN and common-path auto-discovery
• Added explicit Japanese font fallback guidance and English-fallback notice behavior

v1.4.0 - 2026-03-21

• - Added monthly reporting
• Added weekly and monthly symptom and medication heatmaps
• Added monthly weight and BMR trend output
• Added residence-aware monthly medical planning
• Refreshed README, README_ZH, SKILL metadata, and package metadata