Local System Info (Iyeque)

---

name: local-system-info description: Return system metrics (CPU, RAM, disk, processes) using psutil. metadata: { "openclaw": { "emoji": "🖥️", "requires": { "bins": ["python3"], "pip": ["psutil"] }, "install": [ { "id": "psutil", "kind": "pip", "package": "psutil", "label": "Install psutil", }, ], "version": "1.1.0", }, }

---

Local System Info Skill

Monitor local system resources including CPU, memory, disk usage, and running processes.

Tool API

system_info

Retrieve system metrics.

Parameters:

- action (string, required): One of summary, cpu, memory, disk, processes. - limit (integer, optional): Number of processes to list (default: 20). Only used with action=processes.

Usage:

# Get full system summary
uv run --with psutil skills/local-system-info/sysinfo.py summary
CPU metrics only
uv run --with psutil skills/local-system-info/sysinfo.py cpu
Memory metrics only
uv run --with psutil skills/local-system-info/sysinfo.py memory
Disk usage
uv run --with psutil skills/local-system-info/sysinfo.py disk
List top processes by CPU usage
uv run --with psutil skills/local-system-info/sysinfo.py processes --limit 10

Output Format

summary

{
  "cpu": {
    "cpu_percent": 15.2,
    "cpu_count": 8,
    "load_avg": [0.5, 0.3, 0.2]
  },
  "memory": {
    "total": 17179869184,
    "available": 8589934592,
    "percent": 50.0,
    "swap_percent": 5.2
  },
  "disk": {
    "total": 500000000000,
    "used": 250000000000,
    "free": 250000000000,
    "percent": 50.0
  }
}

processes

[
  {
    "pid": 1234,
    "name": "python3",
    "username": "user",
    "cpu_percent": 5.2,
    "memory_percent": 2.1
  },
  ...
]

Metrics Explained

cpu_percent: Current CPU utilization (0-100%)

cpu_count: Number of logical CPU cores

load_avg: System load average (1, 5, 15 min) normalized by CPU count

memory.total/available: RAM in bytes

memory.percent: RAM usage percentage

disk.percent: Root filesystem usage percentage

processes: Top N processes sorted by CPU usage

Requirements

psutil: Cross-platform system monitoring library

Python 3.6+: For f-string support and typing

Platform Support

Works on Linux, macOS, Windows, and WSL. Some metrics may vary by platform:

load_avg: Not available on Windows

Process information depth varies by OS