A powerful CLI-driven skill to manage Uptime Kuma monitoring instances, allowing for automated status checks and monitor configuration.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install uptime-kuma
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 uptime-kuma 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 Uptime Kuma Monitoring?
The Uptime Kuma skill provides a bridge between your AI agent and your self-hosted monitoring infrastructure. By leveraging a Python-based wrapper around the Socket.IO API, this tool enables seamless management of health checks, uptime history, and service alerts. Integrating this with Openclaw Skills allows developers to automate infrastructure oversight within their natural coding or administration workflows.
This skill is designed for high reliability, enabling agents to interpret server health and respond to outages programmatically. Whether you are running a simple website or a complex set of Docker containers and databases, this extension ensures your monitoring stack is always within reach of your automated workflows.
Uptime Kuma Monitoring Use Cases
- Monitoring server health and website uptime in real-time.
- Automating the creation of new monitors when deploying new services.
- Executing maintenance mode by pausing all active monitors via script.
- Inspecting heartbeat history to diagnose intermittent connectivity issues.
- Auditing notification channels to ensure alerting is properly configured.
How Uptime Kuma Monitoring Works
- The skill connects to an Uptime Kuma server using the Socket.IO protocol via the uptime-kuma-api Python library.
- Authentication is handled through environment variables (URL, Username, Password) for secure access to the instance.
- Users or AI agents issue commands through the kuma.py script to query or modify monitor states.
- The script returns human-readable status codes or machine-parseable JSON data representing the state of the monitoring environment.
Uptime Kuma Monitoring Setup
To integrate this with Openclaw Skills, first install the necessary Python dependencies:
pip install uptime-kuma-api
Next, configure your environment variables in your shell or agent configuration:
export UPTIME_KUMA_URL="http://your-server:3001"
export UPTIME_KUMA_USERNAME="admin"
export UPTIME_KUMA_PASSWORD="yourpassword"
Uptime Kuma Monitoring Data Schema & Taxonomy
The skill organizes monitoring data into a structured format compatible with CLI piping and JSON processing:
| Property | Description |
|---|---|
| ID | The unique numerical identifier for the monitor |
| Name | The user-defined display name of the service |
| Type | The check protocol (http, ping, port, docker, dns, etc.) |
| Status | The current health state (Up, Down, Pending, or Paused) |
| Heartbeats | Historical logs of service response times and availability |
Uptime Kuma Monitoring Advanced Features
- Support for diverse monitor types including MQTT, SQL databases (MySQL, Postgres, Redis), and Passive Push checks.
- JSON output formatting for advanced piping into tools like jq.
- Bulk operation support for maintenance windows (pausing/resuming all monitors).
- Detailed heartbeat analysis with configurable time windows (e.g., last 24 hours).
- Native integration with Uptime Kuma notification channel listing for alert verification.
SKILL.md
Loading
Related Openclaw Skills
Proxmox VE Full Management
A comprehensive automation skill for managing Proxmox VE infrastructure, including virtual machines and Linux containers, via its REST API.
RepoMedic
RepoMedic is an AI agent skill designed to safely triage and remediate GitHub dependency issues, security vulnerabilities, and lockfile inconsistencies with strict safety guardrails.
IDA – Instructional Design Agent
A strategic learning engine that transforms raw discovery data into structured instructional blueprints and performance recommendations.
Web Content Fetcher
A specialized tool that bypasses web scrapers blocks by using alternative proxy services to fetch webpage content in Markdown format.
OpenClaw Default Agent Backstory
A systematic framework for bootstrapping and maintaining stable AI agent identities through guided interviews and core context file generation.
ChromaDB Memory
A 100% local, self-hosted long-term memory system using ChromaDB and Ollama for intelligent context injection.
Featured*
