Skip to content
Back to skills

Openclaw Health Guardian

DSecurity

Auto-monitor and recover OpenClaw Gateway with intelligent rate limiting.

  • 3 stars
  • 0 votes
  • 0 copies
  • 3 views
  • Added September 9, 2026
toolsbashnode

Works with

  • terminal

Security analysis

D43/100
  • highPerforms destructive filesystem operations
  • criticalModifies startup scripts or system services for persistence
  • criticalModifies startup scripts or system services for persistence

Pro shows the line behind each finding and how to fix it

Scanned September 9, 2026

npx -y skills add Lord1Egypt/awesome-skill-forge --skill openclaw-health-guardian --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Openclaw Health Guardian?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Openclaw Health Guardian
[![Security: D โ€” Skills Directory](https://www.skillsdirectory.com/api/skills/lord1egypt-openclaw-health-guardian/badge)](https://www.skillsdirectory.com/skills/lord1egypt-openclaw-health-guardian)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
metadata:
  {
    "openclaw":
      {
        "emoji": "๐Ÿ› ๏ธ",
        "requires": { "bins": ["node"] }
      },
  }
---
name: openclaw-health-guardian
description: Deploy OpenClaw health monitoring with auto-restart, cooldown (180s), and rate limiting (5/hour). Use when: (1) setting up OpenClaw health checks, (2) auto-restarting failed Gateway, (3) monitoring OpenClaw status, (4) deploying health daemon on macOS.
---
metadata:
  {
    "openclaw":
      {
        "emoji": "๐Ÿ› ๏ธ",
        "requires": { "bins": ["node"] }
      },
  }
---

# OpenClaw Health Guardian

Auto-monitor and recover OpenClaw Gateway with intelligent rate limiting.

## Quick Start

**Install health guardian:**
```bash
bash ~/.openclaw/skills/openclaw-health-guardian/scripts/install.sh
```

**Verify installation:**
```bash
launchctl list | grep openclaw
```

## When to Use

- Gateway frequently stops responding
- Need automatic recovery without manual intervention
- Running OpenClaw on macOS with LaunchAgent support
- Want cooldown protection against restart loops

## Features

| Feature | Value | Description |
|---------|-------|-------------|
| Check Interval | 5 minutes | LaunchAgent StartInterval |
| Cooldown | 180 seconds | Minimum between restarts |
| Rate Limit | 5/hour | Max restarts per hour |
| HTTP Timeout | 5 seconds | curl --max-time |
| Auto Notify | Terminal popup | AppleScript alert on failure |

## Workflow

1. **Install guardian**
   ```bash
   bash ~/.openclaw/skills/openclaw-health-guardian/scripts/install.sh
   ```

2. **Verify service running**
   ```bash
   launchctl list | grep com.openclaw.healthcheck
   ```

3. **Monitor logs**
   ```bash
   tail -f ~/.openclaw/logs/health-check.log
   ```

4. **Test manually** (optional)
   ```bash
   bash ~/.openclaw/scripts/openclaw-health-check.sh
   ```

## Commands

| Command | Purpose |
|---------|---------|
| `launchctl list \| grep openclaw` | Check service status |
| `tail -f ~/.openclaw/logs/health-check.log` | View real-time logs |
| `bash ~/.openclaw/scripts/openclaw-health-check.sh` | Manual check |
| `launchctl unload ~/Library/LaunchAgents/com.openclaw.healthcheck.plist` | Stop service |
| `launchctl load ~/Library/LaunchAgents/com.openclaw.healthcheck.plist` | Start service |

## File Structure

After installation:
```
~/.openclaw/
โ”œโ”€โ”€ scripts/
โ”‚   โ””โ”€โ”€ openclaw-health-check.sh    # Main script
โ”œโ”€โ”€ state/
โ”‚   โ”œโ”€โ”€ last_restart                # Timestamp
โ”‚   โ”œโ”€โ”€ restart_count               # Hourly counter
โ”‚   โ””โ”€โ”€ hour_marker                 # Hour tracking
โ””โ”€โ”€ logs/
    โ”œโ”€โ”€ health-check.log            # Main log
    โ”œโ”€โ”€ health-check-daemon.log     # Daemon stdout
    โ””โ”€โ”€ health-check-daemon-error.log # Daemon stderr

~/Library/LaunchAgents/
โ””โ”€โ”€ com.openclaw.healthcheck.plist  # LaunchAgent config
```

## Log Examples

**Normal:**
```
[2026-03-16 10:28:47] No issues found. OpenClaw is healthy!
```

**Cooldown triggered:**
```
[2026-03-16 10:30:05] ๅ†ทๅดๆœŸๅ†… (120s/180s)๏ผŒ่ทณ่ฟ‡้‡ๅฏๆ“ไฝœ
```

**Rate limit triggered:**
```
[2026-03-16 10:30:05] ๆœฌๅฐๆ—ถๅทฒ่พพ้‡ๅฏไธŠ้™(5ๆฌก)๏ผŒ่ทณ่ฟ‡
```

**Restart executed:**
```
[2026-03-16 10:30:02] ๅทฒ่ฎฐๅฝ•้‡ๅฏไบ‹ไปถ (ๅ†ทๅด: 180s, ้™ๆต: 5/ๅฐๆ—ถ)
[2026-03-16 10:30:05] Gateway restart completed successfully
```

## Uninstall

```bash
# Stop and remove service
launchctl unload ~/Library/LaunchAgents/com.openclaw.healthcheck.plist
rm ~/Library/LaunchAgents/com.openclaw.healthcheck.plist

# Remove scripts and logs
rm ~/.openclaw/scripts/openclaw-health-check.sh
rm -rf ~/.openclaw/state/
rm ~/.openclaw/logs/health-check*.log
```

## Requirements

- macOS 10.14+
- OpenClaw installed
- User home directory write permissions

## References

- `references/technical-details.md` - Implementation details
- `references/troubleshooting.md` - Common issues

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in tools โ†’

Comments

Loading commentsโ€ฆ

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.