// Retrieve system information and list running processes on a remote host via QuickDesk. Use when the user asks to check server health, monitor CPU or memory usage, view disk space, list running processes, or query OS and uptime details on a remote machine.
| name | sys-info |
| description | Retrieve system information and list running processes on a remote host via QuickDesk. Use when the user asks to check server health, monitor CPU or memory usage, view disk space, list running processes, or query OS and uptime details on a remote machine. |
| metadata | {"openclaw":{"os":["win32","darwin","linux"],"install":[{"id":"binary","kind":"binary","package":"sys-info"}]}} |
Query system health and running processes on a remote host connected through QuickDesk.
Retrieve OS version, CPU model and usage, memory and swap totals/used, disk usage, hostname, and uptime. Takes no parameters.
Returns:
{
"os": "Ubuntu 22.04",
"kernel": "5.15.0",
"hostname": "prod-server-01",
"cpu": { "model": "AMD EPYC 7763", "cores": 8, "usage_percent": "12.3" },
"memory": { "total_mb": 16384, "used_mb": 8200, "usage_percent": "50.0" },
"swap": { "total_mb": 4096, "used_mb": 128 },
"disks": [{ "mount": "/", "total_gb": 500.0, "available_gb": 320.5, "fs": "ext4" }],
"uptime": "14h 32m"
}
List running processes with resource usage, sorted and limited.
"cpu", "memory", or "name" (default: "cpu")Returns:
{
"total_processes": 312,
"showing": 5,
"sort_by": "cpu",
"processes": [
{ "pid": 1234, "name": "node", "cpu_percent": "45.2", "memory_mb": 512 }
]
}
get_system_info to get an overview of the remote machine's health.list_processes sorted by "cpu" or "memory" to identify the top consumers.limit to control result size when only the top offenders are needed.Read, write, list, move, and inspect files and directories on a remote host via QuickDesk. Use when the user needs to browse folders, view file contents, create or edit files, rename or relocate files, or check file metadata (size, permissions, modification time) on a remote machine.
Execute shell commands on a remote host via QuickDesk and return stdout, stderr, and exit code. Use when the user asks to run a command, script, or terminal operation on a remote machine — supports configurable timeout and working directory.