← Back to Skills Marketplace
1996
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install proxmox-skill
Description
Manage Proxmox VE nodes, VMs, and containers. Can list hardware stats, resources, control power states (start, stop, reboot, shutdown), and manage snapshots...
Usage Guidance
This package appears to be a legitimate Proxmox API client, but before installing you should: 1) Confirm with the publisher why the registry metadata showed no required credentials while the included SKILL.md/_meta.json and script require PVE_HOST, PVE_TOKEN_ID, and PVE_TOKEN_SECRET. 2) If you proceed, create a limited-scope API token in Proxmox (not root), grant only the minimum role (PVEAuditor for read-only or a scoped VM role for power/snapshot actions), and avoid cluster-wide root-level permissions. 3) Keep PVE_TOKEN_SECRET secret (do not commit it). 4) Test the skill in a non-production environment first to confirm the approval gate behavior and outputs. 5) If you need higher assurance, review the proxmox.py source (it currently only uses proxmoxer and standard env reads) and ensure your platform enforces the SKILL.md approval flags for destructive actions.
Capability Analysis
Type: OpenClaw Skill
Name: proxmox-skill
Version: 1.0.2
The Proxmox skill is a standard administrative tool for managing Proxmox VE clusters via the official 'proxmoxer' Python library. It correctly handles sensitive credentials using environment variables and implements 'Approval: true' guards in SKILL.md for all power management and snapshot operations. The code in scripts/proxmox.py follows expected logic without any signs of data exfiltration, shell injection, or hidden malicious instructions.
Capability Assessment
Purpose & Capability
Name, description, SKILL.md, _meta.json, README, requirements.txt, and the included script all align: this is a Proxmox API client that needs the Proxmox host URL and an API token. However, the registry summary at the top of the package metadata (the 'Requirements' section you were shown) claimed no required env vars or primary credential — that contradicts the shipped files which do declare three required environment variables. This mismatch should be resolved.
Instruction Scope
SKILL.md directs the agent to run a local Python script with explicit commands and arguments. The script only reads the declared PVE_* environment variables, uses the proxmoxer API to call the Proxmox host, and prints JSON results. There are no instructions to read unrelated files, exfiltrate data to third parties, or perform system-wide enumeration beyond talking to the Proxmox API.
Install Mechanism
This is an instruction-only skill with no installer. A requirements.txt lists proxmoxer and requests (standard for a Proxmox client). No remote downloads, obscure installers, or archive extraction are present in the package.
Credentials
The environment variables required by the script (PVE_HOST, PVE_TOKEN_ID, PVE_TOKEN_SECRET) are appropriate and proportional for a Proxmox API client. The concern is the inconsistency: the registry summary presented to the platform lists no required env/credentials while the shipped SKILL.md and _meta.json mark three required variables (including a secret). That discrepancy could be an honest packaging mistake, but it increases risk because automatic permission/visibility controls may not reflect the real secrets the skill needs.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. Autonomous invocation is enabled (default), which is normal; destructive actions are marked as requiring human approval in SKILL.md, which is appropriate.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install proxmox-skill - After installation, invoke the skill by name or use
/proxmox-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Added snapshot management features for VMs and containers.
- Now supports creating, listing, rolling back to, and deleting snapshots.
- Updated requirements to include proxmoxer and requests Python dependencies.
- Skill description extended to cover new snapshot capabilities.
v1.0.1
- Removed the "verify_ssl=False" in scripts/proxmox.py.
v1.0.0
Initial release with core Proxmox management features:
- Manage Proxmox VE nodes, virtual machines, and containers.
- List nodes, VMs, and containers across the cluster.
- Retrieve hardware health statistics for physical nodes.
- Get real-time status of individual VMs or containers.
- Perform power actions (start, stop, reboot, shutdown) on VMs and containers with approval.
Metadata
Frequently Asked Questions
What is Proxmox Management?
Manage Proxmox VE nodes, VMs, and containers. Can list hardware stats, resources, control power states (start, stop, reboot, shutdown), and manage snapshots... It is an AI Agent Skill for Claude Code / OpenClaw, with 1996 downloads so far.
How do I install Proxmox Management?
Run "/install proxmox-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Proxmox Management free?
Yes, Proxmox Management is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Proxmox Management support?
Proxmox Management is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Proxmox Management?
It is built and maintained by robnew (@robnew); the current version is v1.0.2.
More Skills