local-system-info

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" 
  

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