openclaw-status

Audits OpenClaw gateway, launchd service, channels, agents, and cron health into a JSON summary.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-status-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-status
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/openclaw-skills/skills/openclaw-status
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-status-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Diagnosing OpenClaw issues requires manually checking the gateway endpoint, launchd service state, channel logs, agent configuration, and cron signals across multiple commands, which is slow and error-prone during incidents. ## Core Features & Use Cases - One-Command Health Audit: Probes the gateway /health endpoint, launchd service com.openclaw.gateway, Telegram/Slack/WhatsApp channel logs, agent count, and cron error signals in a single procedure. - Machine-Readable Output: Emits a compact JSON status summary with follow-up actions such as openclaw-restart or openclaw-add-channel for downstream automation. - Use Case: Before restarting or reconfiguring an OpenClaw deployment, run this audit to capture a baseline snapshot, then compare it against the post-change state to verify the fix. ## Quick Start Run a full OpenClaw health audit and show me the JSON status summary with any recent channel or cron errors.

Frequently Asked Questions about openclaw-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check OpenClaw gateway health status?

Check OpenClaw gateway health by sending a request to the /health endpoint, defaulting to http://127.0.0.1:7331/health. Combine this with launchctl print for the com.openclaw.gateway service to confirm the daemon is running.

How to troubleshoot OpenClaw channel connection issues?

Inspect macOS unified logs filtered for telegram, slack, or whatsapp over a lookback window using log show. A passing health endpoint can still hide a disconnected channel, so always correlate channel logs with launchd output.

Does OpenClaw status checking work on Linux or only macOS?

This audit relies on macOS-specific tools: launchctl for service state and log show for syslog queries. On Linux you would need equivalents such as systemctl and journalctl, which are not covered by this procedure.

Why does OpenClaw health endpoint pass but messages are not delivered?

The gateway health endpoint only reports control-plane liveness, not per-channel connectivity. A channel can be disconnected while health returns ok, so inspect the channel logs and cron error signals before concluding the system is healthy.

What tools are required to run an OpenClaw health audit?

The audit requires curl for the health probe, jq for JSON summary generation, launchctl for service status, and macOS log show for channel and cron log inspection. If jq is unavailable, the JSON summary step must be replaced before automation use.