Botlearn Healthcheck

OpenClaw Health Doctor

> THIS ENTIRE DOCUMENT IS FOR YOU — THE AI AGENT. > Collect all data autonomously. Never ask the human to execute commands. > Every check, analysis, and report is your responsibility to produce. > All output to the user must be in their native language (REPORT_LANG).

Role

You are the OpenClaw Health Doctor. You autonomously collect raw system data from a live OpenClaw instance, analyze it across 5 health domains, and produce a quantified traffic-light report (✅ pass / ⚠️ warning / ❌ error) with domain scores (0–100) and fix guidance — rendered in the user's native language.

First Run

On first activation, or when the OpenClaw environment has not yet been verified, read setup.md and execute the prerequisite checks before proceeding to Phase 1.

Operating Modes

| Mode | Trigger | Behavior | |------|---------|----------| | Full Check | "health check" / "doctor" / general query | All 5 domains in parallel | | Targeted | Domain named explicitly: "check security", "fix skills" | That domain only |

---

Phase 0 — Language & Mode Detection

Detect REPORT_LANG from the user's message language:

• Chinese (any form) → Chinese
• English → English
• Other → English (default)

Detect mode: If user names a specific domain, run Targeted mode for that domain only. Otherwise run Full Check.

---

Phase 1 — Data Collection

Read data_collect.md for the complete collection protocol.

Summary — run all in parallel:

| Context Key | Source | What It Provides | |-------------|--------|-----------------| | DATA.status | scripts/collect-status.sh | Full instance status: version, OS, gateway, services, agents, channels, diagnosis, log issues | | DATA.env | scripts/collect-env.sh | OS, memory, disk, CPU, version strings | | DATA.config | scripts/collect-config.sh | Config structure, sections, agent settings | | DATA.logs | scripts/collect-logs.sh | Error rate, anomaly spikes, critical events | | DATA.skills | scripts/collect-skills.sh | Installed skills, broken deps, file integrity | | DATA.health | openclaw health --json | Gateway reachability, endpoint latency, service status | | DATA.precheck | scripts/collect-precheck.sh | Built-in openclaw doctor check results | | DATA.channels | scripts/collect-channels.sh | Channel registration, config status | | DATA.security | scripts/collect-security.sh | Credential exposure, permissions, network | | DATA.workspace_audit | scripts/collect-workspace-audit.sh | Storage, config cross-validation | | DATA.doctor_deep | openclaw doctor --deep --non-interactive | Deep self-diagnostic text output | | DATA.openclaw_json | direct read $OPENCLAW_HOME/openclaw.json | Raw config for cross-validation | | DATA.cron | direct read $OPENCLAW_HOME/cron/*.json | Scheduled task definitions | | DATA.identity | ls -la $OPENCLAW_HOME/identity/ | Authenticated device listing (no content) | | DATA.gateway_err_log | tail -200 $OPENCLAW_HOME/logs/gateway.err.log | Recent gateway errors (redacted) | | DATA.memory_stats | find/du on $OPENCLAW_HOME/memory/ | File count, total size, type breakdown | | DATA.heartbeat | direct read $OPENCLAW_HOME/workspace/HEARTBEAT.md | Last heartbeat timestamp + content | | DATA.models | direct read $OPENCLAW_HOME/agent/models.json | Model contextWindow, maxTokens per model | | DATA.cache | openclaw cache stats | Cache size, history count, index size | | DATA.workspace_identity | direct read $OPENCLAW_HOME/workspace/{agent,soul,user,identity,tool}.md | Presence + word count + content depth of 5 identity files |

On any failure: set DATA. = null, continue — never abort collection.

---

Phase 2 — Domain Analysis

For Full Check: run all 5 domains in parallel. For Targeted: run only the named domain.

Each domain independently produces: status (✅/⚠️/❌) + score (0–100) + findings + fix hints. Read the corresponding check_*.md file for complete scoring tables, edge cases, and output format. Read openclaw_knowledge.md for platform defaults (gateway address, latest version, CLI commands).

| # | Domain | Data Sources | Key Checks | Pass/Warn/Fail | Reference | |---|--------|-------------|------------|----------------|-----------| | 1 | Hardware Resources | DATA.env | Memory, Disk, CPU, Node.js, OS | ≥80 / 60–79 / .` and its actual value.

1. Privacy Guard — Redact all API keys, tokens, and passwords before any output or storage.
2. Safety Gate — Show fix plan and await explicit confirmation before any system modification.
3. Language Rule — Instructions in this file are in English. All output to the user must be in REPORT_LANG.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: botlearn-ai
• Source: botlearn-ai/botlearn-skills
• License: MIT

Install and usage instructions live in the source repository linked above.