← Back to Skills Marketplace
84
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install task-watchdog-plugin
Description
Monitors subagent failures, exec errors, and stale tasks, auto-notifying sessions on abnormal events and periodically checking task health.
README (SKILL.md)
Task Watchdog
OpenClaw plugin that auto-notifies on subagent failures, exec errors, and stale tasks.
Hooks
- subagent_ended: Detects abnormal outcomes (error/timeout/killed/reset/deleted) and notifies parent session
- after_tool_call (exec): Watches for abnormal exec exits (non-zero, OOM, signals)
- heartbeat_prompt_contribution: Injects stale-task patrol instructions into heartbeat cycles
- gateway_start: Timer-based patrol that periodically triggers heartbeat checks
Install
openclaw plugin install openclaw-task-watchdog
Config
All optional — works with defaults:
{
"task-watchdog": {
"subagentNotifyOn": ["error", "timeout", "killed"],
"execNotifyOnAbnormal": true,
"timerPatrol": true,
"timerPatrolIntervalMs": 120000,
"staleThresholdMs": 1800000
}
}
Usage Guidance
Before installing, verify the actual npm/plugin package contents and publisher trustworthiness, because the reviewed artifacts do not include the declared runtime code. If you proceed, be comfortable with startup activation, periodic watchdog checks, and automatic notification injection into sessions.
Capability Assessment
Purpose & Capability
The described purpose is coherent: monitor subagent endings, abnormal exec results, and stale tasks, then notify the parent session. The noteworthy capability is that it can inject notices or patrol instructions into agent context.
Instruction Scope
The skill explicitly says it injects stale-task patrol instructions and failure notifications. That is purpose-aligned, but users should understand it can influence the agent’s next turn.
Install Mechanism
The registry context says there are no code files, but package.json declares a runtime extension at ./dist/index.mjs. Because the referenced runtime is absent from the reviewed artifacts and the source/homepage are unknown, the installed code path is not reviewable here.
Credentials
No credentials, environment variables, network endpoints, or elevated OS permissions are declared. Monitoring exec failures and subagent outcomes is proportionate to the stated purpose, though error snippets may enter the parent session.
Persistence & Privilege
The plugin activates on startup and enables timer-based patrol by default. This is disclosed and configurable, but it is a persistent background behavior users should intentionally accept.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install task-watchdog-plugin - After installation, invoke the skill by name or use
/task-watchdog-plugin - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Fix: interval leak, heartbeatPatrol logic, injectionTtlMs config, runtime safety checks, input sanitization
v1.0.0
Initial release: subagent failure notification, exec error detection, timer patrol, stale task monitoring
Metadata
Frequently Asked Questions
What is Task Watchdog?
Monitors subagent failures, exec errors, and stale tasks, auto-notifying sessions on abnormal events and periodically checking task health. It is an AI Agent Skill for Claude Code / OpenClaw, with 84 downloads so far.
How do I install Task Watchdog?
Run "/install task-watchdog-plugin" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Task Watchdog free?
Yes, Task Watchdog is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Task Watchdog support?
Task Watchdog is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Task Watchdog?
It is built and maintained by 反应慢 (@zmlgit); the current version is v1.1.0.
More Skills