uptime-kuma

What This Skill Does

The Uptime Kuma skill for OpenClaw provides a robust interface to interact with your self-hosted Uptime Kuma monitoring server. By wrapping the uptime-kuma-api library, this skill allows users to perform administrative tasks directly via the command line or through OpenClaw conversational agents. It enables you to monitor the health and status of various services, including websites, databases, TCP ports, and Docker containers. Beyond simple status checks, you can programmatically manage your monitoring infrastructure by adding new monitors, toggling pause/resume states for maintenance, and fetching detailed heartbeat statistics. This automation reduces the operational overhead of manually updating monitoring dashboards when your infrastructure changes.

Installation

To enable this skill, first ensure your environment is prepared by installing the necessary dependency: pip install uptime-kuma-api. You will also need to configure your authentication details within the OpenClaw environment or your shell profile. Ensure the following environment variables are correctly set: UPTIME_KUMA_URL, UPTIME_KUMA_USERNAME, and UPTIME_KUMA_PASSWORD. Once configured, install the skill via the OpenClaw CLI using: clawhub install openclaw/skills/skills/bobdevibecoder/bobagent-uptime-kuma. Ensure that the scripts/kuma.py file is accessible in your script path.

Use Cases

This skill is perfect for DevOps engineers and system administrators who want to integrate monitoring control into their automated workflows. Common use cases include: 1. Automated Maintenance: Temporarily pausing all monitors during scheduled deployments using a simple shell loop. 2. Alert Triaging: Quickly querying the status of specific services when an incident occurs. 3. Infrastructure as Code: Scripting the addition of new monitors whenever a new service is deployed in your staging or production environments. 4. Reporting: Extracting heartbeat history to generate uptime reports for internal service level agreements.

Example Prompts

1. "OpenClaw, can you check the current status of all my monitors and tell me if any are down?"
2. "Add a new http monitor for the production API at https://api.mysite.com with a 30-second interval."
3. "Please pause the 'Database Backup' monitor while I run the maintenance script."

Tips & Limitations

• Authentication: Always store your UPTIME_KUMA_PASSWORD in a secure vault; avoid hardcoding it in scripts.
• Scalability: For large environments with hundreds of monitors, use the --json flag with the list command to process data more efficiently with tools like jq.
• Limitations: The skill currently relies on a synchronous wrapper; for extremely large environments, ensure your network connection to the Kuma server is stable to avoid timeouts during mass-update operations.