error-guard
System safety and control-plane skill that prevents agent deadlocks and freezes. Provides non-LLM control commands to inspect task state, flush message queues, cancel long-running work, and recover safely without restarting the container. Use when implementing or operating long-running tasks, sub-agents, benchmarks, background monitors (e.g., Moltbook, PNR checks), or when the system becomes unresponsive and needs immediate recovery controls.
Packaged view
This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.
Install command
npx @skill-hub/cli install openclaw-skills-error-guard
Repository
Skill path: skills/amar1432/error-guard
System safety and control-plane skill that prevents agent deadlocks and freezes. Provides non-LLM control commands to inspect task state, flush message queues, cancel long-running work, and recover safely without restarting the container. Use when implementing or operating long-running tasks, sub-agents, benchmarks, background monitors (e.g., Moltbook, PNR checks), or when the system becomes unresponsive and needs immediate recovery controls.
Open repositoryBest for
Primary workflow: Ship Full Stack.
Technical facets: Full Stack.
Target audience: everyone.
License: Unknown.
Original source
Catalog source: SkillHub Club.
Repository owner: openclaw.
This is still a mirrored public skill entry. Review the repository before installing into production workflows.
What it helps with
- Install error-guard into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
- Review https://github.com/openclaw/skills before adding error-guard to shared team environments
- Use error-guard for development workflows
Works across
Favorites: 0.
Sub-skills: 0.
Aggregator: No.
Original source / Raw SKILL.md
---
name: error-guard
description: >
System safety and control-plane skill that prevents agent deadlocks and freezes.
Provides non-LLM control commands to inspect task state, flush message queues,
cancel long-running work, and recover safely without restarting the container.
Use when implementing or operating long-running tasks, sub-agents, benchmarks,
background monitors (e.g., Moltbook, PNR checks), or when the system becomes
unresponsive and needs immediate recovery controls.
---
# error-guard
⚠️ **System‑level skill (Advanced users)**
This skill defines the **control‑plane safety primitives** for OpenClaw.
It is intentionally minimal, non‑blocking, and designed to prevent agent freezes, deadlocks, and unrecoverable states when running long‑lived or high‑risk workloads.
## Design Principles
> **Warning:** This skill operates at the agent control‑plane level.
> It should be installed only by users who understand OpenClaw’s execution model and are running workloads that can block, hang, or run for extended periods.
- **Main agent never blocks**: no long exec, no external I/O, no LLM calls.
- **Event-driven**: workers emit events; the control plane listens.
- **Fail-safe first**: recovery commands must always respond.
- **Minimal state**: track only task metadata (never payloads).
## Command Surface (Phase 1)
### /status
Report current system health and task registry state.
Returns:
- Active tasks (taskId, type, state)
- Start time and last heartbeat
- Flags for stalled or overdue tasks
Constraints:
- Must run in constant time
- Must not call any model or external API
### /flush
Emergency stop.
Immediately:
- Cancel all active tasks
- Kill active exec/process sessions
- Clear pending message queue
- Reset in-memory task registry
Constraints:
- Must always respond
- No waiting on workers
- No model calls
### /recover
Safe recovery sequence.
Steps:
1. Execute `/flush`
2. Reset control-plane state
3. Optionally reload skills/state (no container restart)
## Future Extensions (Not Implemented Yet)
- Sub-agent runner helper (event-driven)
- Task watchdogs with TTL and silence detection
- Structured event protocol (task.started, task.heartbeat, task.completed, ...)
- Back-pressure and task classes (interactive / batch / background)
## Security & Privacy
- This skill **does not** store payloads, prompts, messages, or model outputs
- Only minimal task metadata is persisted (taskId, timestamps, state)
- No API keys, credentials, or user data are read or written
- Safe to publish and share publicly
## Non-Goals
- No business logic
- No background polling loops
- No user-facing features
- No LLM reasoning paths
This skill is the **last line of defense**. Keep it small, fast, and reliable.
---
## Skill Companion Files
> Additional files collected from the skill directory layout.
### _meta.json
```json
{
"owner": "amar1432",
"slug": "error-guard",
"displayName": "Error Guard — Control‑Plane Safety",
"latest": {
"version": "1.0.0",
"publishedAt": 1769934317761,
"commit": "https://github.com/clawdbot/skills/commit/76ca9833fa780f440b0af90e0670a1b956fd0043"
},
"history": []
}
```