A read-only monitoring skill to track network device health, port statistics, and active alerts through the LibreNMS REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install librenms
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 librenms 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 LibreNMS Skill?
This skill provides a robust bridge between Openclaw Skills and your LibreNMS instance, allowing for seamless network infrastructure monitoring directly from your agent. It enables developers and sysadmins to query device statuses, health sensors, and network port statistics using a set of optimized CLI commands, ensuring high visibility into hardware and connectivity health without leaving the terminal environment.
By leveraging the LibreNMS REST API, this skill transforms complex network data into actionable insights. It is designed to be lightweight and efficient, focusing on read-only operations to ensure that your monitoring activities never inadvertently modify your production infrastructure configuration.
LibreNMS Skill Use Cases
- Monitoring critical network infrastructure health and uptime in real-time.
- Triage of down devices and active system alerts during incident response.
- Checking hardware sensors like CPU, temperature, and memory for specific hosts.
- Analyzing network interface traffic statistics and port operational statuses.
- Automating infrastructure health reports and notifications via heartbeat scripts.
How LibreNMS Skill Works
- The skill authenticates with your LibreNMS instance using a provided API token and base URL.
- It executes optimized REST API calls to specific endpoints like /devices, /health, or /alerts based on user commands.
- Raw JSON responses from the LibreNMS API are processed and parsed using tools like jq for data extraction.
- Data is transformed into human-readable outputs, including color-coded status indicators and formatted uptime metrics.
- Users can pipe these outputs into other tools or use them within Openclaw Skills workflows for automated monitoring cycles.
LibreNMS Skill Setup
Create the configuration file at ~/.openclaw/credentials/librenms/config.json:
{
"url": "https://librenms.example.com",
"api_token": "your-api-token-here"
}
Alternatively, you can export the following environment variables in your shell environment:
export LIBRENMS_URL="https://librenms.example.com"
export LIBRENMS_TOKEN="your-api-token-here"
Ensure that dependencies like curl, jq, and bc are installed on your system to handle API requests and numeric data formatting correctly.
LibreNMS Skill Data Schema & Taxonomy
The skill organizes infrastructure data into several key categories for clear reporting:
| Data Category | API Endpoint | Information Provided |
|---|---|---|
| Summary | /api/v0/devices | Aggregated counts of up/down devices and active alert totals. |
| Device Details | /api/v0/devices/{hostname} | Hardware model, OS version, serial numbers, and physical location. |
| Health Sensors | /api/v0/devices/{hostname}/health | Real-time metrics for CPU, temperature, memory, and disk usage. |
| Port Statistics | /api/v0/devices/{hostname}/ports | Network interface traffic rates and operational status. |
| Active Alerts | /api/v0/alerts?state=1 | List of unresolved alerts with severity levels and timestamps. |
LibreNMS Skill Advanced Features
- Automated heartbeat integration for periodic infrastructure health checks and scripting.
- Support for self-signed SSL certificates via built-in curl flags for internal lab environments.
- Human-readable formatting for uptime (days/hours) and bandwidth metrics (KB/MB/GB per second).
- Direct grep compatibility for quick down-device triage and filtering in shell scripts.
- Seamless integration with other Openclaw Skills for multi-agent monitoring and incident response workflows.
SKILL.md
Loading
Related Openclaw Skills
Laravel Forge
A powerful command-line interface to manage Laravel Forge servers, sites, and deployments using the Openclaw Skills framework.
Laravel Cloud API Skill
A powerful command-line interface and AI agent skill for managing the entire Laravel Cloud infrastructure via a unified API wrapper.
Bitpanda Portfolio Skill
A command-line interface tool to monitor Bitpanda balances and transaction history.
IBKR Trading Automation
An automated trading skill for Interactive Brokers that simplifies authentication and API interaction via the Client Portal Gateway.
Netatmo Smart Home Control
A CLI-based skill to manage Netatmo thermostats and monitor comprehensive environmental sensor data for smarter home automation.
YouTube Transcript Generator
A specialized utility designed to extract, clean, and format readable text transcripts from any YouTube video URL while removing messy metadata.
Featured*
