Back to skills
SKILL.md
Openclaw Health Guardian
DSecurityAuto-monitor and recover OpenClaw Gateway with intelligent rate limiting.
- 3 stars
- 0 votes
- 0 copies
- 3 views
- Added September 9, 2026
Works with
Security analysis
43/100- Performs destructive filesystem operations
- Modifies startup scripts or system services for persistence
- Modifies startup scripts or system services for persistence
npx -y skills add Lord1Egypt/awesome-skill-forge --skill openclaw-health-guardian --agent claude-codeAre you the author of Openclaw Health Guardian?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/lord1egypt-openclaw-health-guardian)---
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
Related skills
View all in tools โComments
Loading commentsโฆ
Newsletter
Get the weekly list of safe new skills, and the ones we pulled.