AI-powered incident triage for PagerDuty. List active incidents, deep-dive with timeline and alert correlation, check on-call schedules, acknowledge, resolve, and annotate — all from your agent. Read-only by default; write operations require explicit --confirm.
AI-powered incident triage for PagerDuty. List active incidents, deep-dive with timeline and alert correlation, check on-call schedules, acknowledge, resolve, and annotate — all from your agent. Read-only by default; write operations require explicit --confirm.
[{"name":"pd_incidents","description":"List active PagerDuty incidents (triggered + acknowledged)"},{"name":"pd_incident_detail","description":"Get detailed incident info including timeline, alerts, and notes"},{"name":"pd_oncall","description":"Show current on-call schedules and escalation policies"},{"name":"pd_incident_ack","description":"Acknowledge an incident (requires --confirm)"},{"name":"pd_incident_resolve","description":"Resolve an incident (requires --confirm)"},{"name":"pd_incident_note","description":"Add a note to an incident (requires --confirm)"},{"name":"pd_services","description":"List PagerDuty services and their current status"},{"name":"pd_recent","description":"Show recent incidents for a service (last 24h/7d/30d)"}]
PagerDuty Incident Triage
AI-powered incident triage for PagerDuty. Read-only by default. Write operations require explicit confirmation.
When to Activate
Use this skill when the user:
Asks "what's firing?", "any incidents?", "what's on fire?", or anything about active alerts
Mentions PagerDuty, pager, on-call, or incidents
Asks "who's on call?" or "who's oncall right now?"
Wants to acknowledge, resolve, or add a note to an incident
Says "triage", "incident response", or "what happened last night?"
Asks about service health or recent incidents for a service
Quick Setup
1. Create a PagerDuty API Key
Go to PagerDuty → Settings → API Access Keys
Click "Create New API Key"
Name it OpenClaw Agent
Select Read-only (recommended for triage; choose Full Access only if you need ack/resolve)
Copy the key
2. Set Environment Variables
# Required — your PagerDuty REST API v2 tokenexport PAGERDUTY_API_KEY="u+your_key_here"# Optional — required only for write operations (ack, resolve, note)export PAGERDUTY_EMAIL="you@company.com"
3. Verify
Ask your agent: "What's firing on PagerDuty?"
Subcommands Reference
Read Operations (always safe, no confirmation needed)
incidents — List Active Incidents
Lists all triggered and acknowledged incidents, sorted by urgency.
pager-triage incidents
Example output:
{"tool":"pd_incidents"
,
"provider"
:
"pagerduty"
,
"timestamp"
:
"2026-02-16T03:45:00Z"
,
"total_incidents"
:
3
,
"incidents"
:
[
{
"id"
:
"P123ABC"
,
"incident_number"
:
4521
,
"title"
:
"High CPU on prod-web-03"
,
"status"
:
"triggered"
,
"urgency"
:
"high"
,
"service"
:
{
"id"
:
"PSVC123"
,
"name"
:
"Production Web"
}
,
"created_at"
:
"2026-02-16T03:00:00Z"
,
"assignments"
:
[
{
"name"
:
"Jane Doe"
,
"email"
:
"..."
}
]
,
"alert_count"
:
3
,
"escalation_level"
:
1
,
"last_status_change"
:
"2026-02-16T03:05:00Z"
}
]
,
"summary"
:
"3 active incident(s): high (triggered) x1, high (acknowledged) x1, low (triggered) x1"
}
detail <incident_id> — Incident Deep Dive
Full incident details including timeline (log entries), related alerts, notes, and automated analysis.
pager-triage detail P123ABC
Example output (abbreviated):
{"tool":"pd_incident_detail","incident":{"id":"P123ABC","title":"High CPU on prod-web-03","status":"triggered","urgency":"high","service":{"id":"PSVC123","name":"Production Web"},"escalation_policy":{"name":"Production Escalation"},"assignments":[{"name":"Jane Doe","escalation_level":1}]},"timeline":[{"type":"trigger_log_entry","created_at":"...","summary":"Incident triggered via Prometheus Alertmanager"},{"type":"escalate_log_entry","created_at":"...","summary":"Escalated to Jane Doe (Level 1)"}],"alerts":[{"id":"A456DEF","severity":"critical","summary":"CPU > 95% on prod-web-03","source":"Prometheus Alertmanager"}],"notes":[],"analysis":{"alert_count":3,"escalation_count":1,"acknowledged":false,"trigger_source":"Prometheus Alertmanager"}}
oncall — On-Call Schedules
Shows who's currently on call across all schedules and escalation policies.
pager-triage oncall
Example output:
{"tool":"pd_oncall","oncalls":[{"user":{"name":"Jane Doe","email":"jane@company.com"},"schedule":{"name":"Primary SRE","id":"PSCHED1"},"escalation_policy":{"name":"Production Escalation"},"escalation_level":1,"start":"2026-02-15T17:00:00Z","end":"2026-02-16T17:00:00Z"}],"summary":"2 on-call assignment(s). Primary SRE: Jane Doe. Secondary SRE: Bob Smith."}
services — List Services
Lists all PagerDuty services with their current operational status.
Shows recent incidents for a service or across all services with summary statistics.
pager-triage recent # All services, last 24h
pager-triage recent --service PSVC123 # Specific service
pager-triage recent --since 7d # Last 7 days
pager-triage recent --service PSVC123 --since 30d
These operations modify state in PagerDuty. They require the --confirm flag AND PAGERDUTY_EMAIL to be set. Without --confirm, the tool displays what it would do and exits.
Acknowledges a triggered incident, stopping further escalation.
pager-triage ack P123ABC --confirm
Without --confirm, displays:
{"error":"confirmation_required","message":"⚠️ ACKNOWLEDGE INCIDENT — --confirm flag is required to proceed.","incident":{"id":"P123ABC","title":"High CPU on prod-web-03","urgency":"high"},"hint":"Re-run with --confirm to acknowledge this incident."}
pager-triage note P123ABC --content "Root cause: memory leak in auth-service v2.14.3. Rolling back." --confirm
Flags:
Flag
Required
Description
--content <text>
Yes
The note text to add
--confirm
Yes
Confirmation gate
Example output:
{"tool":"pd_incident_note","incident_id":"P123ABC","note_id":"PNOTE456","content":"Root cause: memory leak in auth-service v2.14.3. Rolling back.","created_at":"2026-02-16T04:00:00Z","user":"Jane Doe"}
Incident Triage Workflow
When the user needs help triaging an incident, follow this workflow:
Step 1: Assess the Situation
→ pager-triage incidents
List all active incidents. Prioritize by urgency (high first) and duration (oldest first).
Step 2: Deep-Dive the Critical One
→ pager-triage detail <incident_id>
Get full timeline, alerts, and notes. Identify the trigger source and escalation history.
Step 3: Correlate with Other Skills
If available, use companion skills to investigate root cause:
prom-query → Query Prometheus for the underlying metrics (CPU, memory, latency, error rate)
kube-medic → Check pod health, restarts, OOMKills, node status in Kubernetes
log-dive → Search application logs for errors around the incident timeframe
Step 4: Act
→ pager-triage ack <incident_id> --confirm # Stop escalation while investigating
→ pager-triage note <incident_id> --content "..." --confirm # Document findings
→ pager-triage resolve <incident_id> --confirm # Mark as fixed
Agent Guidance
When the user says "what's wrong?" → start with incidents
When they mention a specific incident → use detail
When triaging → show incidents first, then detail on the most urgent
When correlating → suggest prom-query / kube-medic if installed
ALWAYS show the confirmation preview before executing write operations
NEVER ack/resolve without the user explicitly asking to do so
Discord v2 Delivery Mode (OpenClaw v2026.2.14+)
When the conversation is happening in a Discord channel:
Send a compact first response (active incident count, highest urgency incident, recommended next step), then ask if the user wants full detail.
Keep the first response under ~1200 characters and avoid full timeline dumps in the first message.
If Discord components are available, include quick actions:
Deep Dive Incident
Acknowledge Incident
Add Incident Note
If components are not available, provide the same follow-ups as a numbered list.
Prefer short follow-up chunks (<=15 lines per message) for incident timelines and alert lists.
Security Notes
API keys are read from environment variables only — never logged, displayed, or included in output
Read-only by default — 5 read commands work with any API key; 3 write commands require --confirm
Confirmation gates — Write operations show full incident context and refuse to proceed without --confirm
We recommend starting with a read-only PagerDuty API key for triage workflows
See SECURITY.md for the full threat model and RBAC recommendations
OpsGenie Support (Planned)
OpsGenie integration is planned for a future release. When OPSGENIE_API_KEY is set, the same subcommands will map to OpsGenie's REST API with normalized output schemas.
Powered by Anvil AI · Built for the engineer who gets paged at 3am
