Proxmox Multi-Control for Openclaw

A comprehensive management interface for controlling one or multiple Proxmox VE servers including VMs, containers, and storage through an AI agent.

maikimolto
v1.6.0
Apr 16, 2026
0
894
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install proxmox-multi-control

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install proxmox-multi-control 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 Multi-Control?

The Proxmox Multi-Control skill for Openclaw Skills is a robust integration designed for developers and system administrators who manage Proxmox VE environments. It provides a unified command structure to interact with the Proxmox REST API, allowing for seamless management of standalone servers or distributed clusters. By integrating this capability into your AI agent's toolkit, you can perform complex infrastructure tasks using natural language or automated scripts.

This skill is particularly valuable for those looking to expand their Openclaw Skills library with professional-grade DevOps tools. It supports multi-host configurations, enabling you to get a bird's-eye view of your entire infrastructure, from node health and resource utilization to the operational status of virtual machines and LXC containers.

Proxmox Multi-Control Use Cases

  • Monitoring the resource usage and health status of multiple Proxmox nodes from a single interface.
  • Automating power management for development environments, including starting or stopping VMs across different hosts.
  • Managing system recovery points by creating and rolling back snapshots before major updates.
  • Auditing storage pools and backup archives across various Proxmox instances within the Openclaw Skills ecosystem.
  • Troubleshooting server operations by reviewing recent task logs and async operations directly through the AI agent.

How Proxmox Multi-Control Works

  1. The AI agent receives a command regarding a Proxmox resource, such as listing VMs or checking node status.
  2. The skill references either the ~/.openclaw/credentials/proxmox.json file or environment variables to authenticate with the Proxmox REST API.
  3. The skill executes the requested logic using the proxmoxer Python library to communicate with the specific Proxmox host.
  4. For multi-host commands, the skill iterates through all configured hosts and aggregates the results into a single response.
  5. The skill returns a structured JSON payload to the agent, which then presents the infrastructure data to the user.

Proxmox Multi-Control Setup

To get started with this skill for Openclaw Skills, first install the required Python dependency:

pip install proxmoxer

For managing multiple hosts, create a configuration file at ~/.openclaw/credentials/proxmox.json:

{
  "default": "production",
  "hosts": {
    "production": {
      "host": "192.168.1.100",
      "token_id": "admin@pve!agent",
      "token_secret": "your-api-secret",
      "verify_ssl": false
    }
  }
}

Alternatively, for a quick single-host setup, you can export the following environment variables:

export PVE_HOST="192.168.1.100"
export PVE_TOKEN_ID="admin@pve!agent"
export PVE_TOKEN_SECRET="your-api-secret"

Proxmox Multi-Control Data Schema & Taxonomy

The Proxmox Multi-Control skill organizes data into a consistent JSON structure to ensure compatibility across all Openclaw Skills workflows:

Property Type Description
ok boolean Indicates if the API request was successful
data array Contains the list of nodes, VMs, storage, or tasks
_host string The name of the host the data belongs to (included in cluster-wide commands)
error string Error message details if the operation fails
available array List of valid host names if an invalid host was specified

Proxmox Multi-Control Advanced Features

  • Cluster-wide visibility: Use commands like cluster-vms and cluster-status to aggregate data across every configured Proxmox server.
  • Granular Snapshot Control: Support for including or excluding RAM state when creating snapshots for flexible recovery options.
  • Secure Credential Management: Dedicated configuration file with 600 permissions support to keep API tokens safe within the Openclaw Skills environment.
  • Approval-gated Actions: Critical operations like power cycling and snapshot rollbacks require explicit user approval for safety.
  • Flexible Host Targeting: Use the --host flag to override default settings and target specific servers for any command.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*