A powerful AI agent skill for managing PagerDuty incident lifecycles, on-call rotations, and service health directly from your development workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pagerduty-agent
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install pagerduty-agent using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is PagerDuty Agent Skill?
The PagerDuty Agent is a specialized tool designed to bring full-stack incident response capabilities to your AI-driven workflows. By leveraging this Openclaw Skills contribution, developers and SREs can interface with the PagerDuty REST API to trigger, acknowledge, and resolve incidents without context-switching between browser tabs and their terminal. It provides a structured, JSON-based interface to manage complex infrastructure alerting and team coordination.
This skill is particularly valuable for teams practicing ChatOps or those looking to automate their observability stack. It handles the nuances of the PagerDuty API, such as mapping severities to urgency levels and ensuring that write operations are properly attributed to valid users via email headers, making it a robust addition to the Openclaw Skills ecosystem.
PagerDuty Agent Skill Use Cases
- Automatically triggering high-priority incidents during failed CI/CD deployments or detected outages.
- Quickly identifying who is currently on-call across different schedules to accelerate escalation.
- Silencing noisy alerts by creating maintenance windows during scheduled database migrations or system upgrades.
- Centralizing incident documentation by appending diagnostic logs or runbook links as notes directly to the incident timeline.
- Auditing active service health and listing all currently triggered incidents for rapid status reporting.
How PagerDuty Agent Skill Works
- The user or automated agent provides a command and parameters in a structured JSON format to the skill.
- The skill verifies the presence of the necessary PAGERDUTY_API_KEY for authentication and PAGERDUTY_FROM_EMAIL for audit logging.
- The request is dispatched to the PagerDuty v2 REST API, handling specific logic like severity mapping (e.g., critical maps to high urgency).
- The PagerDuty API processes the request, updating incident statuses, schedules, or maintenance windows as requested.
- The skill captures the API response and returns a clean, parseable JSON object to the agent for further action or display.
PagerDuty Agent Skill Setup
To get started with this skill in the Openclaw Skills collection, follow these steps:
- Generate a PagerDuty API key: Navigate to PagerDuty -> Integrations -> API Access Keys -> Create New API Key.
- Ensure Node.js is installed on your environment.
- Export the required environment variables to your shell or agent configuration:
export PAGERDUTY_API_KEY="your-v2-api-key"
export PAGERDUTY_FROM_EMAIL="[email protected]"
- Test the installation by listing active incidents:
echo '{"command":"list_incidents","params":{"status":"triggered"}}' | node pagerduty.js
PagerDuty Agent Skill Data Schema & Taxonomy
The PagerDuty Agent organizes its data interactions around standard PagerDuty objects. Below is the primary metadata taxonomy used by this skill within Openclaw Skills:
| Object | Key Attributes | Purpose |
|---|---|---|
| Incident | id, incident_number, status, urgency |
Tracks the lifecycle of a system alert. |
| Service | id, name, status, html_url |
Represents the technical components being monitored. |
| On-Call | user, schedule, start, end |
Defines who is responsible for a service at a given time. |
| Maintenance | id, start_time, end_time, services |
Manages periods of suppressed alerting for specific services. |
PagerDuty Agent Skill Advanced Features
- Intelligent Urgency Mapping: Automatically elevates incidents with critical or error severities to high urgency status.
- Multi-Service Suppression: Create maintenance windows that cover an array of services in a single command.
- Timeline Integration: Add Markdown-formatted notes to incidents to provide rich context for post-mortems and active troubleshooting.
- Full Discovery Suite: Use dedicated commands to discover service IDs and schedule IDs dynamically, enabling more complex automation chains within Openclaw Skills.
- Comprehensive Incident Control: Granular control over the transition between triggered, acknowledged, and resolved states.
SKILL.md
Loading
Related Openclaw Skills
linear-agent
A robust Linear integration for AI agents that enables native GraphQL project management, issue tracking, and automated git-sync functionality.
ElevenLabs Speech-to-Text (STT)
A high-performance transcription skill leveraging ElevenLabs Scribe v2 for accurate audio-to-text conversion with speaker diarization.
ElevenLabs Music Generation
A sophisticated tool for generating complete songs with vocals and lyrics from simple text descriptions using the ElevenLabs Music API.
SuperMemory
An AI-driven memory management skill that enables users to store information, perform semantic searches, and chat with their personal knowledge base via the SuperMemory API.
Hybrid Memory System
A sophisticated memory architecture that merges vector-based document retrieval with temporal knowledge graphs for comprehensive AI agent context.
Drift
A specialized toolkit providing AI agents with frameworks for persistent identity, self-reflection, and session continuity.
Featured*
