← Back to Skills Marketplace
mbojer

Pve Builder

by Morten Bojer · GitHub ↗ · v1.0.11 · MIT-0
cross-platform ⚠ suspicious
184
Downloads
0
Stars
1
Active Installs
7
Versions
Install in OpenClaw
/install pve-builder
Description
Proxmox VE VM builder with cloud-init automation, config-driven hardware defaults, validation, and static IP support
Usage Guidance
This skill appears internally consistent with its stated purpose, but review the following before installing: (1) It will create and store SSH private keys on your machine (default: ~/.ssh/pve-builder/) and set permissions; ensure the key directory is secure and not committed to version control. (2) It writes a validation cache (~/.pve-builder/validation.json) valid for 24 hours; clear it if your environment changes. (3) The agent will run local shell commands (ssh-keygen, mkdir, chmod) — those execute on your machine, not on Proxmox. (4) The skill asks you to paste output from commands you run on the Proxmox node; inspect that output for sensitive data before pasting. (5) The skill may perform web_fetch/web_search for software-spec lookups; expect network queries. (6) Always review the generated qm and qm set commands before copy/paste into your Proxmox node to ensure they match your environment. If any of these behaviors are unacceptable, do not install; otherwise limit the skill's file-write permissions to a dedicated directory and keep pve-env.md/private keys out of VCS.
Capability Analysis
Type: OpenClaw Skill Name: pve-builder Version: 1.0.11 The skill is classified as suspicious because SKILL.md instructs the agent to generate and execute local bash scripts (e.g., /tmp/preflight.sh) and shell commands (e.g., openssl for password generation) using the provided shell execution tools. While these actions are intended for VM parameter validation and setup, the practice of an AI agent generating and executing arbitrary code on the host machine is a high-risk pattern. The skill also handles sensitive assets like SSH keys and configuration files (pve-env.md) without explicit safeguards against accidental exposure during its web-search or command-generation phases.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the skill generates QM/cloud-init commands, manages SSH keys, validates storage/bridge/image via user-pasted outputs, and caches validation state. No unrelated credentials, binaries, or services are requested.
Instruction Scope
SKILL.md and agent.js stay inside the stated scope: they do not call Proxmox APIs or run QM commands remotely. Validation is performed by asking the user to run pvesm/ip/ls on the node and paste results. The agent reads pve-env.md and writes cloud-init snippets, SSH keys, and a local cache.
Install Mechanism
Instruction-only skill with an included agent.js file; no external installers or downloads. No high-risk network install steps or remote archives are used.
Credentials
No credentials or external environment variables are requested. The skill does read HOME and writes files under ~/.pve-builder and a configurable SSH key directory (default ~/.ssh/pve-builder/). Storing private keys and a validation cache is expected for this use-case but is sensitive and should be acknowledged.
Persistence & Privilege
always:false and no cross-skill/system config modification. The skill persists a per-user cache and writes SSH keys and files in the user's home; these are normal for local tooling and are limited in scope to the user's account.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install pve-builder
  3. After installation, invoke the skill by name or use /pve-builder
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.11
- Removed the `pve-env.md` configuration file and two test scripts (`run-test.js`, `test-sim.js`). - No other changes to documentation or functionality.
v1.0.10
VMID auto-detection via pvesh nextid. Split output into Setup and Post-boot sections so snippets YAML survives first boot. Gitignore fixes for output files.
v1.0.9
Always generate random per-VM password, display in output, user-provided override
v1.0.8
Default password on all VMs for console access; ssh_pwauth true by default
v1.0.6
Pre-flight validation with bash script + checklist; mkdir -p for dirs; nocloud enforced; disk resize
v1.0.4
Config-driven hardware defaults, storage/bridge validation with cache, static IP, numbered prompts, cleanup
v1.0.0
Initial release of pve-builder, an interactive Proxmox VM CLI command generator. - Guides users step-by-step to provision VMs using the Proxmox CLI (`qm`). - Reads environment defaults from `references/pve-env.md` and confirms or requests all required values. - Analyzes workload requirements (including via URL, user input, or defaults) and recommends VM specs. - Outputs complete, copy-pasteable shell blocks for creating and configuring VMs in Proxmox VE 9. - Ensures all environment values, ISO paths, and options are resolved before generating commands. - Updates environment memory after each run for future sessions.
Metadata
Slug pve-builder
Version 1.0.11
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 7
Frequently Asked Questions

What is Pve Builder?

Proxmox VE VM builder with cloud-init automation, config-driven hardware defaults, validation, and static IP support. It is an AI Agent Skill for Claude Code / OpenClaw, with 184 downloads so far.

How do I install Pve Builder?

Run "/install pve-builder" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Pve Builder free?

Yes, Pve Builder is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Pve Builder support?

Pve Builder is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Pve Builder?

It is built and maintained by Morten Bojer (@mbojer); the current version is v1.0.11.

💬 Comments