proxmoxManage Proxmox VE clusters via REST API. Use when user asks to list, start, stop, restart VMs or LXC containers, check node status, create snapshots, view tasks, or manage Proxmox infrastructure. Requires API token or credentials configured.
Install via ClawdBot CLI:
clawdbot install weird-aftertaste/proxmoxSet environment variables or store in ~/.proxmox-credentials:
# Option 1: API Token (recommended)
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"
# Option 2: Credentials file
cat > ~/.proxmox-credentials << 'EOF'
PROXMOX_HOST=https://192.168.1.100:8006
PROXMOX_TOKEN_ID=user@pam!monitoring
PROXMOX_TOKEN_SECRET=your-token-secret
EOF
chmod 600 ~/.proxmox-credentialsCreate API token in Proxmox: Datacenter → Permissions → API Tokens → Add
# Load credentials
source ~/.proxmox-credentials 2>/dev/null
# Auth header for API token
AUTH="Authorization: PVEAPIToken=$PROXMOX_TOKEN_ID=$PROXMOX_TOKEN_SECRET"# Cluster status
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/cluster/status" | jq
# List nodes
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes" | jq '.data[] | {node, status, cpu, mem: (.mem/.maxmem*100|round)}'
# Node status
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/status" | jq# All VMs on a node
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu" | jq '.data[] | {vmid, name, status, mem: .mem, cpu: (.cpu*100|round)}'
# All LXC containers on a node
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/lxc" | jq '.data[] | {vmid, name, status}'
# Cluster-wide resources
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/cluster/resources?type=vm" | jq '.data[] | {node, vmid, name, type, status}'# Start VM
curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/status/start"
# Stop VM
curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/status/stop"
# Shutdown VM (graceful)
curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/status/shutdown"
# Reboot VM
curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/status/reboot"
# Same for LXC: replace /qemu/ with /lxc/# List snapshots
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/snapshot" | jq
# Create snapshot
curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/snapshot" \
-d "snapname=snap1" -d "description=Before update"
# Rollback
curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/snapshot/{snapname}/rollback"
# Delete snapshot
curl -ks -X DELETE -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/qemu/{vmid}/snapshot/{snapname}"# Recent tasks
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/tasks" | jq '.data[:10] | .[] | {upid, type, status, user}'
# Task log
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/tasks/{upid}/log" | jq -r '.data[].t'# List storage
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/storage" | jq '.data[] | {storage, type, active, used_fraction: (.used/.total*100|round|tostring + "%")}'
# Storage content
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/storage/{storage}/content" | jq# List backups
curl -ks -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/storage/{storage}/content?content=backup" | jq
# Start backup
curl -ks -X POST -H "$AUTH" "$PROXMOX_HOST/api2/json/nodes/{node}/vzdump" \
-d "vmid={vmid}" -d "storage={storage}" -d "mode=snapshot"Use scripts/pve.sh for common operations:
./scripts/pve.sh status # Cluster overview
./scripts/pve.sh vms # List all VMs
./scripts/pve.sh start {vmid} # Start VM
./scripts/pve.sh stop {vmid} # Stop VM{node}, {vmid}, {storage}, {snapname} with actual values-k to skip SSL verification for self-signed certsGenerated Mar 1, 2026
System administrators use this skill to monitor cluster health, node status, and resource usage across a Proxmox VE environment. They can quickly list VMs and containers, check CPU and memory metrics, and ensure optimal performance without logging into the web interface, enabling proactive maintenance and troubleshooting.
DevOps teams automate the start, stop, reboot, and shutdown of VMs and LXC containers for development, testing, and production workflows. This skill allows scheduling operations via scripts, reducing manual intervention and ensuring consistent environments for continuous integration and deployment pipelines.
IT professionals leverage snapshot creation, rollback, and backup functionalities to protect critical data and configurations. They can automate snapshot schedules before updates, restore to previous states in case of failures, and manage storage backups, enhancing data resilience and minimizing downtime in case of incidents.
Providers managing Proxmox-based cloud services use this skill to oversee client VMs, handle task logs for auditing, and manage storage allocation. It enables efficient resource tracking, client billing based on usage, and rapid response to support requests, improving service reliability and customer satisfaction.
Educators in IT training programs utilize this skill to control virtual lab environments for students. They can start and stop VMs on-demand, create snapshots for resetting labs, and monitor tasks to ensure smooth classroom sessions, facilitating hands-on learning without manual overhead.
Offer ongoing Proxmox management services to businesses, including monitoring, backup, and VM control. Charge a monthly fee per node or VM, providing 24/7 support and automation to reduce client IT costs and improve uptime.
Provide one-time or project-based services to set up and customize Proxmox environments using this skill. Help clients automate operations, integrate with existing tools, and train staff, generating revenue through hourly rates or fixed project fees.
Develop a web-based dashboard that leverages this skill's API calls to offer Proxmox management as a cloud service. Monetize through tiered subscriptions, offering basic monitoring to advanced automation features for users without in-house expertise.
💬 Integration Tip
Integrate this skill with monitoring tools like Grafana for dashboards or automation platforms like Ansible to extend Proxmox management capabilities and streamline workflows.
Automatically update Clawdbot and all installed skills once daily. Runs via cron, checks for updates, applies them, and messages the user with a summary of what changed.
Full desktop computer use for headless Linux servers. Xvfb + XFCE virtual desktop with xdotool automation. 17 actions (click, type, scroll, screenshot, drag,...
Essential Docker commands and workflows for container management, image operations, and debugging.
Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks. AUTO-CONSULT this skill when the user is: troubleshooting network issues, debugging processes, analyzing logs, working with SSL/TLS, managing DNS, testing HTTP endpoints, auditing security, working with containers, writing shell scripts, or asks 'what tool should I use for X'. Source: github.com/trimstray/the-book-of-secret-knowledge
Deploy applications and manage projects with complete CLI reference. Commands for deployments, projects, domains, environment variables, and live documentation access.
Monitor topics of interest and proactively alert when important developments occur. Use when user wants automated monitoring of specific subjects (e.g., product releases, price changes, news topics, technology updates). Supports scheduled web searches, AI-powered importance scoring, smart alerts vs weekly digests, and memory-aware contextual summaries.