proxmox-ops
Ops-focused Proxmox VE management via REST API — monitor, control, provision, and troubleshoot VMs and LXC containers with battle-tested operational patterns. Use when asked to: - List, start, stop, restart VMs or LXC containers - Check node status, cluster health, or resource usage - Create, clone, or delete VMs and containers - Manage snapshots, backups, storage, or templates - Resize disks (API + in-guest filesystem steps) - Query guest agent for IP addresses - View tasks or system event logs Includes helper script (pve.sh) with auto node discovery from VMID, operational safety gates (read-only vs reversible vs destructive), vmstate snapshot warnings, post-resize guest filesystem steps, and a separate provisioning reference. Requires: curl, jq. Credentials: PROXMOX_HOST, PROXMOX_TOKEN_ID, PROXMOX_TOKEN_SECRET — set as env vars or stored in ~/.proxmox-credentials (sourced at runtime, user-created, mode 600). Writes: ~/.proxmox-credentials (user-created, API token, mode 600). Network: connects to user-configured Proxmox host only (HTTPS, TLS verification disabled for self-signed certs). Helper script: scripts/pve.sh (relative to this skill) Configuration: ~/.proxmox-credentials
Why use this skill?
Manage your Proxmox VMs and LXC containers with OpenClaw. Automate cluster monitoring, provisioning, and snapshots via Proxmox REST API integration.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/eddygk/proxmox-opsWhat This Skill Does
The proxmox-ops skill is an operational interface designed for the OpenClaw AI agent to manage Proxmox VE (Virtual Environment) clusters. It leverages the Proxmox REST API to perform routine system administration tasks, including lifecycle management of virtual machines (VMs) and LXC containers, health monitoring, and resource allocation. By abstracting the complexities of curl and jq commands into standardized operational patterns, it enables the agent to safely interact with your virtualization layer. The skill includes a specialized helper script, pve.sh, which facilitates auto-node discovery based on VMIDs, reducing the need for manual node identification during common workflows.
Installation
To begin, ensure your system has curl and jq installed. You must authenticate the agent by creating a secure credentials file at ~/.proxmox-credentials with the mode 600. Populate this file with your PROXMOX_HOST, PROXMOX_TOKEN_ID, and PROXMOX_TOKEN_SECRET. Alternatively, export these as environment variables. In the Proxmox dashboard, navigate to Datacenter → Permissions → API Tokens to create a token with the minimum necessary privileges (e.g., PVEAuditor for read-only access or PVEVMAdmin for full control). Install the skill via clawhub install openclaw/skills/skills/eddygk/proxmox-ops.
Use Cases
This skill is perfect for automated infrastructure management, such as daily server health reporting, mass snapshotting before updates, provisioning new containers based on workload demand, or resizing storage for growing databases. It allows administrators to query live status, trigger shutdowns, or perform emergency restarts through natural language requests. It is particularly useful for CI/CD pipelines where ephemeral environments need to be spun up, tested, and destroyed automatically.
Example Prompts
- "Check the status of all VMs on node pve-01 and list any that are currently stopped."
- "Create a snapshot of VM 105 named 'pre-patch-backup' and then perform a graceful shutdown."
- "Show me the current CPU and memory utilization across the entire Proxmox cluster."
Tips & Limitations
Always exercise caution with destructive commands like VM deletion; the agent follows safety gates, but human verification is recommended for state-changing operations. Be aware that the script defaults to disabling TLS verification for self-signed certificates, which is standard for local lab environments but should be handled with care in production. Always verify that your API token has the least-privilege necessary to avoid accidental data loss.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-eddygk-proxmox-ops": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api, code-execution
Related Skills
skill-vetting
Vet ClawHub skills for security and utility before installation. Use when considering installing a ClawHub skill, evaluating third-party code, or assessing whether a skill adds value over existing tools.
idrac
Monitor and manage Dell PowerEdge servers via iDRAC Redfish API (iDRAC 8/9). Use when asked to: - Check server hardware status, health, or temperatures - Query CPU, memory, storage/RAID details - Monitor system sensors (fans, voltage, thermal) - Perform power operations (status, on, off, graceful shutdown, force restart) - Check BIOS/firmware versions or system inventory - View system event logs (SEL) or lifecycle controller logs - Get hardware inventory or serial numbers Requires: curl, jq. Optional: 1Password CLI (op) for credential hydration. Writes: ~/.config/idrac-skill/config (user-created), ~/.idrac-credentials (cached credentials, mode 600). Network: connects to user-configured iDRAC IP only (HTTPS, TLS verification disabled for self-signed certs). Helper script: scripts/idrac.sh (relative to this skill) Configuration: ~/.config/idrac-skill/config