A comprehensive interface to manage Proxmox VE clusters, virtual machines, and containers using the REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install proxmox
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install proxmox using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Proxmox VE Management?
The Proxmox VE skill is a powerful integration designed for administrators and developers who need to programmatically control their virtualization infrastructure. By interacting directly with the Proxmox REST API, this skill allows users to monitor cluster health, manage resource allocation, and execute lifecycle commands on both VMs and LXC containers. It is a vital component of the Openclaw Skills ecosystem for anyone looking to bridge the gap between AI-driven workflows and bare-metal or virtualized hardware management.
This skill eliminates the need to manually navigate the Proxmox web GUI for routine tasks. Instead, it provides a structured way to query node status, manage storage, and handle complex snapshot operations. Whether you are running a home lab or a production datacenter, incorporating this into your Openclaw Skills library streamlines your DevOps and sysadmin operations through secure, token-based authentication.
Proxmox VE Management Use Cases
- Monitoring cluster-wide resource utilization including CPU and memory pressure.
- Automating VM and Container power states like start, stop, and graceful shutdown.
- Implementing pre-deployment safeguards by creating snapshots before system updates.
- Auditing system activity by retrieving task logs and process IDs (UPIDs).
- Managing backups and verifying storage capacity across multiple nodes.
How Proxmox VE Management Works
- The skill authenticates with the Proxmox host using a secure API Token (PVEAPIToken) or stored credentials.
- It queries the cluster resources endpoint to identify available nodes, virtual machines, and containers.
- User commands are translated into specific REST API calls directed at the relevant node or resource ID.
- For state changes like reboots or backups, the skill initiates the request and returns a UPID for tracking.
- Resulting JSON data is parsed and formatted to provide clear, actionable insights into the infrastructure state.
Proxmox VE Management Setup
To use this skill with Openclaw Skills, you must first generate an API Token in your Proxmox web interface under Datacenter → Permissions → API Tokens. Then, configure your environment:
# Define your Proxmox credentials
export PROXMOX_HOST="https://192.168.1.100:8006"
export PROXMOX_TOKEN_ID="user@pam!tokenname"
export PROXMOX_TOKEN_SECRET="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Alternatively, you can store these in ~/.proxmox-credentials to maintain a persistent configuration for your agent.
Proxmox VE Management Data Schema & Taxonomy
The skill interacts with several Proxmox data structures to provide comprehensive management:
| Entity | Attributes Captured | Purpose |
|---|---|---|
| Node | node, status, cpu, mem | Tracks physical host health and load |
| QEMU VM | vmid, name, status, netin/out | Manages virtual machine lifecycle and metrics |
| LXC | vmid, name, status, type | Manages Linux container instances |
| Storage | storage, type, active, used | Monitors disk space and datastore availability |
| Snapshot | snapname, description, time | Handles point-in-time recovery states |
Proxmox VE Management Advanced Features
- Direct LXC container support for lightweight virtualization management.
- Granular snapshot lifecycle control including rollback and deletion via API.
- Asynchronous task tracking using UPIDs to monitor long-running operations like backups.
- Support for self-signed SSL certificates via insecure mode flags.
- Integrated helper scripts for rapid cluster-wide status summaries and bulk operations.
SKILL.md
Loading
Related Openclaw Skills
NPM Proxy
A streamlined API interface for managing Nginx Proxy Manager hosts, certificates, and access lists programmatically.
Literature Review
An AI-powered academic research assistant that searches multiple scientific databases to find, deduplicate, and synthesize scholarly literature.
Komodo Infrastructure Management
A comprehensive infrastructure management skill for controlling Komodo servers, Docker containers, stacks, and automated build procedures.
LinkedIn Account Warmup Agent
An automated LinkedIn warming agent designed to mimic human behavior and safely grow new accounts through daily lightweight interactions.
b3ehive
b3ehive is a multi-agent framework that pits three AI agents against each other to implement, evaluate, and select the highest-quality code solution through objective competition.
GEB Aesthetics Skill
A multi-modal creative intelligence system based on the principles of Gödel, Escher, and Bach to harmonize complex narrative and aesthetic layers.
Featured*
