π¦ ClawHub
PagerDuty On-Call
by @fr3kstyle
Manage PagerDuty incidents, on-call schedules, escalation policies, and services via the PagerDuty REST API. Use when you need to: (1) List or acknowledge ac...
TERMINAL
clawhub install pagerduty-oncallπ About This Skill
name: pagerduty-oncall description: "Manage PagerDuty incidents, on-call schedules, escalation policies, and services via the PagerDuty REST API. Use when you need to: (1) List or acknowledge active incidents, (2) Trigger or resolve incidents, (3) Check who is on-call right now, (4) View escalation policies, (5) Manage PagerDuty services, (6) Get incident timelines or notes, (7) Snooze or reassign incidents, (8) Run PagerDuty operations from the agent. Requires PAGERDUTY_API_KEY env var."
PagerDuty On-Call Skill
Manage incidents and on-call operations via the PagerDuty REST API (v2).
Setup
export PAGERDUTY_API_KEY="your-api-key-here"
Optional: set default email for actions that require it
export PAGERDUTY_FROM_EMAIL="oncall@yourcompany.com"
Get your API key: PagerDuty β User Icon β My Profile β User Settings β API Access Keys β Create New API Key
Core Workflows
List Active Incidents
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py incidents --status triggered,acknowledged
Acknowledge an Incident
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py acknowledge --id P1234AB
Resolve an Incident
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py resolve --id P1234AB
Trigger a New Incident
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py trigger \
--service-key "your-service-integration-key" \
--description "Database is down" \
--severity critical
Who is On-Call Right Now?
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py oncall
With schedule filter:
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py oncall --schedule-id PABC123
Get Incident Details
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py get --id P1234AB
List Services
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py services
List Escalation Policies
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py escalations
Add Note to Incident
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py note --id P1234AB --message "Investigating DB failover"
Snooze Incident
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py snooze --id P1234AB --duration 3600
Reassign Incident
python3 ~/.openclaw/workspace/skills/pagerduty-oncall/scripts/pd.py reassign --id P1234AB --user-id PU12345
Direct API Calls (Advanced)
For operations not covered by the script, use curl directly:
curl -s -H "Authorization: Token token=$PAGERDUTY_API_KEY" \
-H "Accept: application/vnd.pagerduty+json;version=2" \
"https://api.pagerduty.com/incidents?statuses[]=triggered&limit=25"
Key Concepts
triggered β acknowledged β resolvedCommon Tasks for Agents
incidents to check overnight alertsoncall + incidents for current stateget for timeline, then note to document RCAincidents filtered by urgency, then acknowledgeAPI Rate Limits
--limit flag to control result set sizeβοΈ Configuration
export PAGERDUTY_API_KEY="your-api-key-here"
Optional: set default email for actions that require it
export PAGERDUTY_FROM_EMAIL="oncall@yourcompany.com"
Get your API key: PagerDuty β User Icon β My Profile β User Settings β API Access Keys β Create New API Key