pulse

What This Skill Does

The Pulse skill provides a command-line interface for the Pulse infrastructure monitoring system, enabling OpenClaw agents to query and control real-time system metrics, resource health, and system alerts. By integrating the Pulse REST API, the skill bridges the gap between raw infrastructure telemetry and intelligent automation. It allows for the monitoring of nodes, VMs, containers, and storage units, as well as the ability to trigger system updates, manage agent links, and perform security-related operations like API token lifecycle management. The skill is designed for SREs, system administrators, and developers who need to interact with Pulse programmatically within a conversational agent interface.

Installation

To add the Pulse monitoring capabilities to your agent, use the ClawHub package manager. Run the following command in your terminal:

clawhub install openclaw/skills/skills/cyberkov/pulse

Once installed, ensure you have configured your environment variables. The skill defaults to https://demo.pulserelay.pro, but you should set the PULSE_URL and PULSE_TOKEN variables in your environment for production access. For a seamless experience, a shell wrapper script can be placed in ~/.local/bin/pulse, as documented in the skill repository.

Use Cases

• Incident Response: Automatically query system health and active alerts when the agent detects a performance anomaly.
• Capacity Planning: Extract metrics over specific time ranges (e.g., 7 days) to evaluate resource utilization trends for VMs and containers.
• Security Auditing: Generate and manage API tokens with specific scopes to audit access to monitoring data.
• Proactive Maintenance: Use the AI-patrol trigger to identify potential bottlenecks before they impact service availability.

Example Prompts

• "Pulse, can you check the current health of the infrastructure and list any active alerts?"
• "I need a report on container CPU usage for the last 4 hours. Which ones are exceeding 80%?"
• "Trigger an AI patrol run for the cluster and let me know if any new findings are reported."

Tips & Limitations

• Data Formatting: The tool relies on jq for JSON processing. When piping results, ensure you have jq installed to handle the complex JSON responses from the Pulse API.
• Range Constraints: Available metric ranges are strictly limited to 5m, 15m, 30m, 1h, 4h, 12h, 24h, and 7d. Requesting unsupported intervals will result in an API error.
• Security: Never hardcode your API token in the wrapper script if you are on a shared system. Prefer using secure environment variables or secret management services.