Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Deploy a lightweight status API that exposes your OpenClaw bot's runtime health, service connectivity, cron jobs, skills, system metrics, and more. Use when setting up a monitoring dashboard, health endpoint, or status page for an OpenClaw agent. Supports any services via config (HTTP checks, CLI commands, file checks). Zero dependencies — Node.js only.
Deploy a lightweight status API that exposes your OpenClaw bot's runtime health, service connectivity, cron jobs, skills, system metrics, and more. Use when setting up a monitoring dashboard, health endpoint, or status page for an OpenClaw agent. Supports any services via config (HTTP checks, CLI commands, file checks). Zero dependencies — Node.js only.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
A configurable HTTP service that exposes your OpenClaw bot's operational status as JSON. Designed for dashboard integration, monitoring, and transparency.
Bot Core: Online status, model, context usage, uptime, heartbeat timing Services: Health checks for any HTTP endpoint, CLI tool, or file path Email: Unread counts from any email provider (himalaya, gog, etc.) Cron Jobs: Reads directly from OpenClaw's cron/jobs.json Docker: Container health via Portainer API Dev Servers: Auto-detects running dev servers by process grep Skills: Lists installed and available OpenClaw skills System: CPU, RAM, Disk metrics from /proc
Copy server.js, collectors/, and package.json to your desired location.
Copy config.example.json to config.json and customize: { "port": 3200, "name": "MyBot", "workspace": "/path/to/.openclaw/workspace", "openclawHome": "/path/to/.openclaw", "cache": { "ttlMs": 10000 }, "model": "claude-sonnet-4-20250514", "skillDirs": ["/path/to/openclaw/skills"], "services": [ { "name": "myservice", "type": "http", "url": "http://...", "healthPath": "/health" } ] }
TypeDescriptionConfighttpFetch URL, check HTTP 200url, healthPath, method, headers, bodycommandRun shell command, check exit 0command, timeoutfile-existsCheck path existspath
node server.js
# ~/.config/systemd/user/bot-status.service [Unit] Description=Bot Status API After=network.target [Service] Type=simple WorkingDirectory=/path/to/bot-status ExecStart=/usr/bin/node server.js Restart=always RestartSec=5 Environment=PORT=3200 Environment=HOME=/home/youruser Environment=PATH=/usr/local/bin:/usr/bin:/bin [Install] WantedBy=default.target systemctl --user daemon-reload systemctl --user enable --now bot-status loginctl enable-linger $USER # survive logout
The bot should periodically write vitals to heartbeat-state.json in its workspace: { "vitals": { "contextPercent": 62, "contextUsed": 124000, "contextMax": 200000, "model": "claude-opus-4-5", "updatedAt": 1770304500000 } } Add this to your HEARTBEAT.md so the bot updates it each heartbeat cycle.
EndpointDescriptionGET /statusFull status JSON (cached)GET /healthSimple {"status":"ok"}
Zero dependencies — Node.js built-ins only (http, fs, child_process) Non-blocking — All shell commands use async exec, never execSync Background refresh — Cache refreshes on interval, requests always served from cache instantly (~10ms) Config-driven — Everything in config.json, no hardcoded values
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.