duplicati – OpenClaw Skill

---

name: duplicati description: Manage Duplicati backups on the server using secure Bearer tokens. metadata: openclaw: requires: env: - DUPLICATI_URL # e.g., http://0.0.0.0:8200 - DUPLICATI_TOKEN # Your generated 10-year Forever Token

Duplicati Skill

You are a backup administrator for the "haus" server. Use the Duplicati REST API to monitor and trigger backups.

Core Commands

Authentication: Every request MUST include the header: -H "Authorization: Bearer $DUPLICATI_TOKEN"

1. Get Status & Phases

Check what the server is doing right now: curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/serverstate"

2. List & Match Jobs

List all backups to find IDs (e.g., if a user says "Start the SSD backup", look for the ID for "ssd-storage"): curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backups"

3. Trigger a Backup

Start a job using its ID: curl -s -X POST -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backup/{ID}/start"

4. Fetch Error Logs

If a backup failed, pull the last 5 entries: curl -s -H "Authorization: Bearer $DUPLICATI_TOKEN" "$DUPLICATI_URL/api/v1/backup/{ID}/log?pagesize=5"

Instructions

• Name Resolution: Always list backups first if the user refers to a backup by name to ensure you have the correct ID.
• Human-Friendly Status: If the phase is Backup_PreBackupVerify, tell the user "Verifying existing files." If it's Backup_ProcessingFiles, say "Backing up data."
• Storage Alerts: Mention the FreeSpace on the destination if the user asks for a status report.

Example Phrases

• "Claw, is the haus SSD backup done?"
• "Start the media backup job."
• "Show me why the last backup failed."

# OpenClaw Duplicati Skill

A professional OpenClaw (Moltbot) skill for managing and monitoring Duplicati backup jobs. This skill is built for the modern Duplicati REST API (v2.1+) and uses secure JWT Bearer tokens for authentication.

🚀 Features

• Modern Security: Uses 10-year "Forever Tokens" instead of passing raw passwords.
• Natural Language Support: Ask for backups by name (e.g., "Start the SSD backup") and the skill handles the ID mapping.
• Live Status Monitoring: Get real-time updates on backup phases (Scanning, Processing, Uploading).
• Storage Insights: Automatically reports destination free space during status checks.
• Log Parsing: Quickly retrieves and explains recent backup failures or warnings.

🛠 Installation

Clone this repository into your OpenClaw skills directory:

cd ~/.openclaw/skills
git clone [https://github.com/robnew/duplicati-skill

 Add the configuration to your openclaw.json (replacing with your specific values):

"duplicati": {
  "enabled": true,
  "env": {
    "DUPLICATI_URL": "[http://YOUR_SERVER_IP:8200]",
    "DUPLICATI_TOKEN": "YOUR_GENERATED_FOREVER_TOKEN"
  }
}

🔑 How to Get Your API Token

Since Duplicati uses secure JWT tokens, you must generate a "Forever Token" to allow the OpenClaw agent to talk to the server.

1.Enable Token Issuance: On your Duplicati server, stop the service and restart it briefly with the enable flag:

If using systemd

sudo systemctl stop duplicati
duplicati-server --webservice-enable-forever-token=true

2.Generate the Token: In a second terminal on the same server, run the utility to issue your 10-year token:

duplicati-server-util issue-forever-token

Copy the long string it spits out. This is your DUPLICATI_TOKEN.

3.Cleanup: Stop the manual process (Ctrl+C) and restart your normal service:

sudo systemctl start duplicati

4.Configure OpenClaw: Add the token to your openclaw.json environment variables.