claw-guard
System-level watchdog for OpenClaw gateway restarts and sub-agent task PIDs. Monitors registered PIDs and optional log/directory freshness. Auto-reverts config on failed gateway restarts. Requires explicit registration — does NOT auto-discover. Use when running long background tasks or before gateway restarts.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/camopel/openclaw-claw-guardWhat This Skill Does
ClawGuard is a robust, system-level watchdog designed specifically for OpenClaw gateway stability and background task management. It operates as a background service that actively monitors registered PIDs (Process IDs) and provides a safety net for system configuration during gateway restarts. Unlike auto-discovery tools, ClawGuard requires explicit registration, ensuring that it only consumes resources for processes you specifically want to track. It prevents "zombie" processes by killing tasks that stop responding, alerts users when logs go stale, and performs automated configuration reverts if a gateway restart fails.
Installation
To install ClawGuard, navigate to your designated skill directory and execute the installation script:
cd <skill-dir> && bash scripts/install.sh
This will configure a systemd (Linux) or launchd (macOS) service to ensure ClawGuard starts automatically on boot. The CLI utility claw-guard will be placed in your ~/.local/bin/ path, and its internal data directory will be initialized at ~/.openclaw/workspace/tools/claw-guard/.
Use Cases
ClawGuard is essential for users running long-lived background tasks, such as automated data processing, web scraping sessions, or model training sub-agents. It is also critical for maintaining the health of the OpenClaw gateway. If you frequently update your gateway configuration, ClawGuard ensures that a faulty config doesn't leave your system in a broken state by attempting an automated revert and notifying the user. It is the primary tool for "fire-and-forget" task management.
Example Prompts
- "Register my current data processing script as a sub-agent task with ID 'data-cruncher' and log file at /tmp/proc.log."
- "Check the status of all registered background tasks and verify if any have timed out."
- "Configure the gateway restart protection so that my current workspace config is backed up before any reboot attempt."
Tips & Limitations
ClawGuard does not perform auto-discovery for processes. You must manually invoke the registration command or integrate it into your automated sub-agent spawning flow. Always define a sensible timeout when registering background tasks; if the log remains static beyond this duration, ClawGuard will terminate the process to prevent hanging. For gateway stability, ensure the ExecStartPre hook is correctly configured in your service files. Using ClawGuard allows your main agent to stay responsive while delegating heavy I/O tasks to monitored sub-agents.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-camopel-openclaw-claw-guard": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, code-execution
Related Skills
ddgs-search
Free multi-engine web search via ddgs CLI (DuckDuckGo, Google, Bing, Brave, Yandex, Yahoo, Wikipedia) + arXiv API search. No API keys required. Use when user needs web search, research paper discovery, or when other skills need a search backend. Drop-in replacement for web-search-plus.
finviz-crawler
Continuous financial news crawler for finviz.com with SQLite storage, article extraction, and query tool. Use when monitoring financial markets, building news digests, or needing a local financial news database. Runs as a background daemon or systemd service.
arxivkb
Local arXiv paper manager with semantic search. Crawls arXiv categories, downloads PDFs, chunks content, and indexes with FAISS + Ollama embeddings. No cloud API keys required — everything runs locally.
privateapp
Personal PWA dashboard server with plugin apps. Use when: (1) installing or setting up PrivateApp, (2) starting/stopping/restarting the service, (3) building frontends after changes, (4) adding new app plugins, (5) configuring push notifications. Requires Python 3.9+, Node.js 18+. Runs as systemd user service or launchd plist.
storage-cleanup
One-command disk cleanup for macOS and Linux — trash, caches, temp files, old kernels, snap revisions, Homebrew, Docker, and Xcode artifacts. Use when user asks to free storage, clean up disk, reclaim space, reduce disk usage, or encounters low disk / "disk full" warnings. Safe by default with dry-run mode. No dependencies beyond bash and awk.