A comprehensive automation skill for managing Proxmox VE virtual machines, containers, and cluster resources through a robust REST API interface.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pve-automation
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 pve-automation 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 Automation?
This skill provides a powerful interface for interacting with Proxmox VE (Virtual Environment), an open-source platform for enterprise virtualization. It leverages the PVE REST API to give AI agents and developers complete control over QEMU/KVM virtual machines and LXC containers. By integrating this into your Openclaw Skills library, you can automate complex infrastructure tasks that previously required manual intervention in the Proxmox web interface.
Beyond basic lifecycle operations, the skill handles storage management, networking configuration, and cluster-wide tasks. It is designed with developer safety in mind, offering patterns for resource validation and dry-run execution to prevent over-allocation or accidental deletions in production environments.
Proxmox VE Automation Use Cases
- Automated provisioning of development environments using Cloud-Init for rapid deployment.
- Bulk lifecycle operations such as starting or shutting down groups of VMs based on triggers.
- Continuous backup and snapshot management to maintain disaster recovery standards.
- Dynamic scaling of LXC container resources based on real-time performance metrics.
- Automated hardware passthrough configuration for GPU-intensive workloads or specialized networking.
How Proxmox VE Automation Works
- The skill establishes a secure connection to the Proxmox VE host using either API Tokens or Ticket-based authentication.
- Commands are translated into REST API calls targeting specific nodes, virtual machines (VMs), or containers.
- For write operations, the skill captures the Unique Process ID (UPID) returned by the Proxmox host.
- It polls the task status endpoint to monitor progress and verify successful execution of the operation.
- Detailed JSON responses are processed to return resource statuses or error messages back to the environment.
Proxmox VE Automation Setup
To deploy this skill within your Openclaw Skills collection, ensure you have network access to your PVE host on port 8006 (default).
Create an API token in the Proxmox Web UI (Datacenter -> Permissions -> API Tokens) and export the following environment variables:
export PVE_HOST="pve.example.com"
export PVE_TOKEN_ID="automation"
export PVE_TOKEN_SECRET="aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
You can also configure custom ports if your management interface is not on the default 8006.
Proxmox VE Automation Data Schema & Taxonomy
The skill interacts with the core Proxmox data hierarchy, organizing information into the following schema:
| Resource | Description | Key Attributes |
|---|---|---|
| Nodes | Physical cluster members | status, cpu, memory, uptime |
| QEMU | Virtual Machines | vmid, name, status, cores, memory |
| LXC | Linux Containers | vmid, hostname, status, ostemplate |
| Storage | Data backends | type, content, total, used, avail |
| Tasks | Ongoing operations | upid, status, exitstatus, user |
Proxmox VE Automation Advanced Features
- High Availability (HA) group management for automated failover of critical services.
- Live migration capabilities for running VMs across cluster nodes with shared storage.
- Comprehensive Firewall configuration at both the cluster and individual virtual resource level.
- Integration with ACME for automated SSL/TLS certificate management across the cluster.
- Advanced PCI and USB passthrough automation for specialized hardware access.
- Scheduled backup jobs with custom cron expressions and automated notification webhooks.
SKILL.md
Loading
Related Openclaw Skills
Claws NFT
A secure, multi-phase skill for AI agents to mint exclusive Claws NFTs on the Solana blockchain by solving logic challenges.
Bark Push Skill
An intelligent Bark notification assistant for Openclaw Skills that provides flexible multi-user message delivery and history management.
China Weather
A comprehensive weather retrieval skill providing real-time conditions, forecasts, and lifestyle recommendations for cities across China.
TikHub API Helper
A comprehensive tool for discovering and calling TikHub API endpoints to fetch data from TikTok, Instagram, Douyin, and other social platforms.
Boot KPI Analyzer
An automated diagnostic tool for analyzing the startup and shutdown performance metrics of SS4 vehicle head units.
issuefinder-tool
A professional automotive diagnostic tool for Openclaw Skills that automates vehicle log retrieval from the cloud and provides intelligent fault analysis.
Featured*
