Uptime Tool for Openclaw

A robust system monitoring utility to track uptime, load averages, and boot timestamps for proactive health diagnostics.

dinghaibin
v1.0.0
May 10, 2026
0
634
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install uptime-tool

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install uptime-tool 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 Tool?

The Uptime Tool is a versatile system diagnostic utility designed to provide deep insights into system availability and performance. As a key component within the Openclaw Skills ecosystem, it allows developers and system administrators to quickly retrieve uptime duration, active user sessions, and CPU load averages across Linux, macOS, and BSD environments.

Beyond simple reporting, this skill bridges the gap between manual checks and automated monitoring. It provides both human-readable outputs and structured data formats, making it indispensable for verifying system stability and identifying unexpected reboots in production or development environments.

Uptime Tool Use Cases

  • Verifying if a remote server has successfully rebooted after a maintenance window.
  • Monitoring CPU load averages to identify performance bottlenecks during heavy workloads.
  • Automating alerts within CI/CD pipelines when a system shows a suspiciously low uptime.
  • Exporting system health metrics to third-party monitoring stacks using structured JSON.

How Uptime Tool Works

  1. The skill queries the system kernel or performance APIs to fetch the current uptime and boot timestamp.
  2. It calculates the CPU load averages for 1, 5, and 15-minute intervals.
  3. The data is processed through a formatting engine based on the user's flag (e.g., --pretty for humans or --json for machines).
  4. In watch mode, the tool enters a loop to refresh these metrics at a specified interval.
  5. If alert thresholds are set, the skill compares the current uptime against the limit and triggers a notification if the criteria are met.

Uptime Tool Setup

To integrate this into your existing Openclaw Skills workflow, ensure the binary is in your PATH and execute the following commands:

# Basic installation check
uptime-tool --version

# Run a standard health check
uptime-tool

# Enable continuous monitoring every 60 seconds
uptime-tool --watch 60

Uptime Tool Data Schema & Taxonomy

The Uptime Tool organizes its output into structured objects. When using the machine-readable mode, the data follows this schema:

Field Type Description
uptime_seconds Integer Total seconds since last boot
load_avg Array Load averages for [1m, 5m, 15m]
users Integer Count of active user sessions
boot_time ISO8601 The exact timestamp of system start
status String Health status based on alert thresholds

Uptime Tool Advanced Features

  • Alert Thresholds: Automatically trigger warnings if a system has recently rebooted (e.g., uptime < 60s).
  • Compare Mode: Use state files to detect changes in system status between execution runs.
  • Real-time Watch: Continuous monitoring mode with configurable intervals for live dashboarding.
  • Multi-Format Output: Seamlessly switch between emoji-rich human displays and raw seconds for shell scripting.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*