pager-triage

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

1. Go to PagerDuty → Settings → API Access Keys
2. Click "Create New API Key"
3. Name it OpenClaw Agent
4. Select Read-only (recommended for triage; choose Full Access only if you need ack/resolve)
5. Copy the key

2. Set Environment Variables

# Required — your PagerDuty REST API v2 token
export PAGERDUTY_API_KEY="u+your_key_here"

# Optional — required only for write operations (ack, resolve, note)
export PAGERDUTY_EMAIL="[email protected]"

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"
}