# Send Synology Backup to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "synology-backup",
    "name": "Synology Backup",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/pfrederiksen/synology-backup",
    "canonicalUrl": "https://clawhub.ai/pfrederiksen/synology-backup",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/synology-backup",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=synology-backup",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/backup.sh",
      "scripts/restore.sh",
      "scripts/status.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/synology-backup"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/synology-backup",
    "downloadUrl": "https://openagent3.xyz/downloads/synology-backup",
    "agentUrl": "https://openagent3.xyz/skills/synology-backup/agent",
    "manifestUrl": "https://openagent3.xyz/skills/synology-backup/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/synology-backup/agent.md"
  }
}
```
## Documentation

### Synology Backup

Backup OpenClaw data to a Synology NAS over SMB. Designed for secure, automated daily snapshots with configurable retention.

### 1. Network Connectivity

For VPS-to-NAS backups, use Tailscale for secure connectivity without exposing SMB to the internet:

Install Tailscale on the Synology (Package Center → search "Tailscale")
Install Tailscale on the VPS — see Tailscale's official install guide for your platform
Join both to the same tailnet
Use the Synology's Tailscale IP in config

For local network setups, use the NAS local IP directly.

### 2. Synology Preparation

Create a dedicated user on the Synology (e.g., openclaw-backup) with minimal permissions
Create or choose a shared folder (e.g., backups)
Grant the user read/write access to only that folder

### 3. Credentials File

Create an SMB credentials file with restricted permissions — never store credentials in config or scripts:

# Create the file and set permissions (replace placeholders with your values)
touch ~/.openclaw/.smb-credentials
chmod 600 ~/.openclaw/.smb-credentials
# Edit the file and add two lines:
#   username=<your-synology-user>
#   password=<your-synology-password>
nano ~/.openclaw/.smb-credentials

### 4. Configuration

Create ~/.openclaw/synology-backup.json:

{
  "host": "100.x.x.x",
  "share": "backups/openclaw",
  "mountPoint": "/mnt/synology",
  "credentialsFile": "~/.openclaw/.smb-credentials",
  "smbVersion": "3.0",
  "backupPaths": [
    "~/.openclaw/workspace",
    "~/.openclaw/openclaw.json",
    "~/.openclaw/cron",
    "~/.openclaw/agents"
  ],
  "includeSubAgentWorkspaces": true,
  "retention": 7,
  "schedule": "0 3 * * *"
}

Note on sensitive files: The .env file (containing API keys) is not included in the default backup paths. If you want to back it up, add "~/.openclaw/.env" to backupPaths — but ensure your Synology share has restricted access and the dedicated user has minimal permissions.

FieldDescriptionDefaulthostSynology IP (Tailscale or local)requiredshareSMB share pathrequiredmountPointLocal mount point/mnt/synologycredentialsFilePath to SMB credentials filerequiredsmbVersionSMB protocol version3.0backupPathsPaths to backupworkspace + configincludeSubAgentWorkspacesAuto-include workspace-* dirstrueretentionDays of snapshots to keep7scheduleCron expression (host timezone)0 3 * * *

### 5. Install Dependencies

apt-get install -y cifs-utils rsync

### 6. Mount Setup

For persistent mounts across reboots, add to /etc/fstab:

//<host>/<share> /mnt/synology cifs credentials=<credentials-file>,vers=3.0,_netdev,nofail 0 0

### Backup Now

scripts/backup.sh

Runs an incremental backup. First run copies everything; subsequent runs only sync changes.

### Restore a Snapshot

scripts/restore.sh [date]

Restores from a specific date's snapshot (e.g., 2026-02-20). Without a date, lists available snapshots.

### Check Status

scripts/status.sh

Shows last backup time, snapshot count, total size, and mount health.

### What Gets Backed Up

~/.openclaw/workspace/ — memory, SOUL, AGENTS, skills, all workspace files
~/.openclaw/workspace-*/ — all sub-agent workspaces (if enabled)
~/.openclaw/openclaw.json — main config
~/.openclaw/cron/ — cron job definitions
~/.openclaw/agents/ — agent configurations
~/.openclaw/.env — opt-in only (contains API keys — add to backupPaths manually if desired)

### Snapshot Structure

backups/
├── 2026-02-20/
│   ├── manifest.json
│   ├── workspace/
│   ├── workspace-email/
│   ├── workspace-news/
│   ├── agents/
│   ├── cron/
│   └── openclaw.json
├── 2026-02-19/
└── ...

### Security Notes

Credentials: Always use a dedicated credentials file with restricted permissions (chmod 600). Never inline secrets in config files, scripts, or fstab.
Network: Use Tailscale or a VPN for remote backups. Never expose SMB (port 445) to the public internet.
Sensitive data: The .env file contains API keys and is excluded from default backup paths. Only include it if your NAS share is properly secured with restricted user permissions.
NAS user: Create a dedicated Synology user with access to only the backup share — not an admin account.
Retention: Old snapshots are pruned by moving them to the Synology trash (if supported) or deleting them. Increase retention for critical environments.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: pfrederiksen
- Version: 1.0.4
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/synology-backup)
- [Send to Agent page](https://openagent3.xyz/skills/synology-backup/agent)
- [JSON manifest](https://openagent3.xyz/skills/synology-backup/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/synology-backup/agent.md)
- [Download page](https://openagent3.xyz/downloads/synology-backup)