Proxmox Backup Server Manager for Openclaw

A comprehensive agent-driven tool to automate Proxmox Backup Server installation, configuration, and VM/LXC backup management.

maikimolto
v1.6.0
Apr 16, 2026
0
946
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install proxmox-backup-server-manager

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-backup-server-manager 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 Backup Server Manager?

The Proxmox Backup Server Manager is a specialized tool designed to streamline the lifecycle of data protection within Proxmox environments. As part of the wider ecosystem of Openclaw Skills, it bridges the gap between infrastructure management and automated disaster recovery. It provides a conversational interface for deploying a Backup Server (PBS), configuring storage backends like NAS (NFS/SMB), and maintaining consistent backup schedules for virtual machines and Linux containers.

This skill is built for developers and sysadmins who need reliable, incremental, and space-efficient backup solutions without the overhead of manual CLI management. By integrating directly with Proxmox APIs, it ensures that your environment is protected through a guided discover, setup, and operate workflow that prioritizes technical accuracy and security.

Proxmox Backup Server Manager Use Cases

  • Deploying a new Proxmox Backup Server instance in an LXC, VM, or bare metal environment.
  • Automating incremental snapshots for running VMs and containers to ensure data integrity.
  • Connecting Proxmox hosts to external NAS shares for centralized, off-server backup storage.
  • Monitoring the health and success status of backup jobs across multiple nodes.
  • Quickly registering or excluding specific VMIDs from global backup policies.

How Proxmox Backup Server Manager Works

  1. Discovery Phase: The agent scans for existing configuration files in the local environment and verifies if the PBS is reachable.
  2. Guided Setup: If no configuration is found, the agent initiates a step-by-step setup to install PBS, configure network settings, and define storage paths.
  3. Storage Integration: The skill assists in mounting local or NAS-based storage and creating the necessary datastores within the PBS interface.
  4. Target Registration: Using Openclaw Skills logic, the agent auto-discovers all VMs and containers on the host and allows the user to select targets for protection.
  5. Operations: Users can trigger backups, list recent archives, or perform health checks via the provided Python helper scripts.
  6. Lifecycle Management: The skill manages the backup notes, statuses, and sequential execution for environments with multiple targets.

Proxmox Backup Server Manager Setup

To begin using this skill within the Openclaw Skills framework, ensure you have the necessary dependencies installed on your local machine.

# Install the required Python library
pip install proxmoxer

The configuration is managed via a JSON file. The agent will guide you through the creation of this file during the first run:

  • Config Path: ~/.openclaw/credentials/pbs-backup.json (chmod 600)
  • Optional: It can import existing credentials from the proxmox-multi-control skill if available.

Proxmox Backup Server Manager Data Schema & Taxonomy

The skill organizes its operation around a central configuration file that maps Proxmox hosts to their respective backup targets.

Data Component Format Description
Host Configuration JSON Object Stores IP, Port, API tokens, and Datastore names.
Target Registry Array List of VMIDs, types (LXC/QEMU), and node names.
Credentials File Securely stores secrets in pbs-backup.json with restricted permissions.

All backups leverage the native vzdump utility using snapshot mode to ensure consistency without downtime for your services.

Proxmox Backup Server Manager Advanced Features

  • Multi-mode execution allowing the agent to run commands directly via SSH or provide manual instructions for the user.
  • Automated NAS mounting including fstab editing for persistent NFS and SMB shares.
  • Smart target filtering that suggests all running VMs while allowing specific exclusions.
  • Support for incremental backups that significantly reduce storage overhead and network traffic.
  • Built-in health check and status reporting to verify the integrity of the backup chain across the entire cluster.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*