编程

AgentOps Guardrails

试用

Detect agent runtime anomalies and route incidents through approval-safe guardrails. Use when you need deterministic checks for cron failures, context pressu...

它能做什么

Detect agent runtime anomalies and route incidents through approval-safe guardrails. Use when you need deterministic checks for cron failures, context pressu...

技能文档

ops-detection-incident-routing

Run deterministic operations checks and route incidents with guardrails.

This skill ships a small toolkit for:

  1. detecting runtime anomalies from local state/log files
  2. applying in-flight + cooldown guards
  3. emitting structured incident actions for investigator/remediator flows

Use This Skill

Use this skill when you need a production-safe ops loop for agent systems and do not want ad-hoc prompt-only monitoring.

Files

  • scripts/ops-threshold-detector.sh reads session/cron/snapshot state and appends detector JSONL events
  • scripts/incident-guard-check.sh checks in-flight/cooldown guard status for a check id
  • scripts/incident-state-update.sh updates guard state for start/complete/fail transitions
  • scripts/ops-incident-router.sh converts detector alerts into structured actions
  • scripts/ops-detector-cycle.sh detector + router cycle runner
  • scripts/setup.sh dependency checks + local example scaffold
  • scripts/clean-generated.sh removes generated .jsonl and lock artifacts before republishing from a used folder

Setup

bash scripts/setup.sh

Quick Start

Run one full dry-run cycle:

bash scripts/ops-detector-cycle.sh \
  --workspace "$(pwd)/examples/workspace" \
  --state-file "$(pwd)/examples/incident-state.json" \
  --detector-out "$(pwd)/examples/ops-detector.jsonl" \
  --router-out "$(pwd)/examples/router-actions.jsonl"

Run live mode (router also acquires in-flight locks):

bash scripts/ops-detector-cycle.sh \
  --workspace "$(pwd)/examples/workspace" \
  --state-file "$(pwd)/examples/incident-state.json" \
  --detector-out "$(pwd)/examples/ops-detector.jsonl" \
  --router-out "$(pwd)/examples/router-actions.jsonl" \
  --live

Output Contract

Detector writes one JSON line per run:

{
  "ts": "2026-02-24T02:30:00Z",
  "status": "ALERT",
  "checks": 5,
  "alerts": [{"sev":"Sev-2","trigger":"cron_failure","value":2,"threshold":0}],
  "gaps": []
}

Router emits one JSON action per alert decision:

{"action":"spawn","check_id":"cron_failure","severity":"Sev-2","mode":"dry-run","task":"Investigate incident: cron_failure"}

Operational Pattern

  1. schedule ops-threshold-detector.sh (every 5-15 min)
  2. feed the latest detector line to ops-incident-router.sh
  3. spawn investigator/remediator only from router output
  4. keep remediation behind explicit owner approval

For details, read references/architecture.md.

相关技能

Always On Agent Ops

Keep an OpenClaw agent running 24/7 — loopback gateway blocks inbound webhooks, OAuth expires silently, strict config. Use when crons stop firing. Trigger on...

1 次安装

Agent Cron Service

Run a hosted agent on a cron schedule — daily digests, uptime monitors, recurring scrapes, periodic reports — that fire on their own and bill exactly-once wi...

1 次安装

Agent Health

Monitor agent endpoints, check liveness, collect metrics, alert on failures

1 次安装

Agent Tests

Define, run, and track tests for agent behavior. Test cases, assertions, regression tracking, and performance benchmarking. Zero external dependencies.

2 次安装

Cron Health Monitor

Proactive cron job health monitoring, failure detection, and auto-repair delegation. Triggers: 'cron failed', 'cron health', 'fix cron', 'consecutive errors

2 次安装

agent-cognitive-states

Agent self-awareness of cognitive states — context fatigue, attention drift, memory debt, confidence erosion, and skill staleness. Detect, report, and mitigate degrading conditions before they cause failures.