Librenms

# LibreNMS Skill

Monitor network infrastructure via LibreNMS REST API. Read-only monitoring skill for device status, health sensors, port statistics, and alerts.

## Configuration

Create `~/.openclaw/credentials/librenms/config.json`:
```json
{
  "url": "https://librenms.example.com",
  "api_token": "your-api-token-here"
}
```

Or set environment variables:
- `LIBRENMS_URL` — Base URL of your LibreNMS instance
- `LIBRENMS_TOKEN` — API authentication token

## Commands

### Quick Overview
```bash
librenms summary
```
Dashboard view showing total devices, how many are up/down, and active alert count. Use this first to get a quick status overview.

### Device Management
```bash
librenms devices           # List all devices with status, IP, OS, uptime
librenms down             # Show ONLY devices that are down (critical for alerting)
librenms device <hostname> # Detailed info: hardware, serial, location, OS version
```

### Health Monitoring
```bash
librenms health <hostname> # Temperature, CPU, memory, disk usage sensors
librenms ports <hostname>  # Network interfaces with traffic stats
```

### Alerts
```bash
librenms alerts           # Show active/unresolved alerts with severity and timestamps
```

## Usage Patterns

**Daily health check:**
```bash
librenms summary && librenms down && librenms alerts
```

**Investigate specific device:**
```bash
librenms device switch-core-01
librenms health switch-core-01
librenms ports switch-core-01
```

**Quick down-device triage:**
```bash
librenms down | grep -v "UP"
```

## Important Notes

- All operations are **read-only** — no device modifications possible
- The script accepts self-signed certificates (-sk flag for curl)
- Status indicators: ● green = up, ● red = down
- Uptime is formatted as human-readable (days/hours instead of seconds)
- Traffic stats are formatted as KB/MB/GB per second

## Heartbeat Integration

Check infrastructure health periodically:
```bash
# In heartbeat script
if librenms down | grep -q "Device...

# LibreNMS Skill for OpenClaw

Monitor your network infrastructure with LibreNMS REST API integration. Read-only monitoring skill for devices, health sensors, ports, and alerts.

## Features

- 📊 **Dashboard Summary** — Quick overview of all devices, up/down counts, active alerts
- 🖥️ **Device Monitoring** — List all devices with status, uptime, and OS info
- 🚨 **Alert Management** — View active/unresolved alerts with severity levels
- 🌡️ **Health Sensors** — Temperature, CPU, memory, disk usage monitoring
- 🔌 **Port Statistics** — Network interface status and traffic rates
- ⚠️ **Down Device Filter** — Instantly see which devices need attention

## Installation

1. Clone or copy this skill to your OpenClaw skills directory:
   ```bash
   cd ~/.openclaw/skills/
   git clone <this-repo> librenms
   # or copy the librenms/ folder
   ```

2. Install dependencies:
   ```bash
   # Most systems already have these
   sudo apt install curl jq bc  # Debian/Ubuntu
   sudo yum install curl jq bc  # RHEL/CentOS
   brew install curl jq         # macOS
   ```

3. Create configuration file:
   ```bash
   mkdir -p ~/.openclaw/credentials/librenms
   cat > ~/.openclaw/credentials/librenms/config.json << EOF
   {
     "url": "https://librenms.example.com",
     "api_token": "your-api-token-here"
   }
   EOF
   chmod 600 ~/.openclaw/credentials/librenms/config.json
   ```

4. Get your API token:
   - Log into LibreNMS web UI
   - Go to Settings → API Settings
   - Click "Create API Token"
   - Copy the token to your config.json

## Usage

### Quick Start

```bash
# Dashboard overview
librenms summary

# List all devices
librenms devices

# Show only devices that are down
librenms down

# Check active alerts
librenms alerts
```

### Device Details

```bash
# Get detailed info for a specific device
librenms device router-core-01

# Check health sensors (temp, CPU, memory, disk)
librenms health router-core-01

# View port/interface statistics
librenms ports router-core-01
```

### Exa...