NAS Agent Sync — Synology File Storage for OpenClaw Agents

Centralize file storage across your multi-agent team using a Synology NAS (or any SSH-accessible storage). One agent acts as File Master — all others route file requests through it.

The Problem

Multi-agent setups generate files across multiple workspaces. Without centralized storage:

• - Files get lost between agent sessions
• No backup strategy
• Agents duplicate work
• No single source of truth

The Solution

Designate one agent as File Master. All file operations go through this agent via sessions_send. The File Master manages:

• - SSH connection to NAS
• Folder structure per agent
• File storage and retrieval
• Cross-agent file sharing

Architecture

CODEBLOCK0

Setup

1. NAS Prerequisites

• - Synology NAS (any model) or any Linux server with SSH
• SSH access with key-based auth
• VPN or Tailnet (recommended) for secure remote access

2. Create Folder Structure

CODEBLOCK1

3. Configure File Master Agent

Add to your File Master agent's AGENTS.md:

CODEBLOCK2

4. Configure Other Agents

Add to each agent's AGENTS.md:

CODEBLOCK3

NAS Folder Structure (Recommended)

CODEBLOCK4

SSH via VPN/Tailnet (Recommended)

CODEBLOCK5

Security

• - ✅ SSH key-based auth (no passwords in configs)
• ✅ VPN/Tailnet for encrypted tunnel (no port forwarding needed)
• ✅ File Master pattern limits SSH access to one agent
• ✅ Other agents never get SSH credentials
• ❌ Never store SSH keys in agent SOUL.md or memory files

Why File Master Pattern?

1. 1. Security: Only one agent has NAS credentials
2. Consistency: Single point of truth for file locations
3. Audit trail: All file ops logged through one agent
4. Simplicity: Other agents don't need to know SSH commands

Backup Strategy

Daily Backup Cron (via OpenClaw)

CODEBLOCK6

Manual Backup Command

Troubleshooting

SSH connection refused:
→ Check VPN/Tailnet status — is NAS online and connected?
→ Verify SSH service running on NAS (Synology: DSM → Control Panel → Terminal & SNMP)

Permission denied:
→ SSH key not added: ssh-copy-id user@nas-ip
→ NAS home folder not enabled (Synology: DSM → User → Advanced → Enable home service)

Slow transfers:
→ Use direct VPN connection (not relayed)
→ Consider compression: INLINECODE4

Compatible NAS Models

• - ✅ Synology (any model with DSM 7+)
• ✅ QNAP (QTS 5+)
• ✅ TrueNAS / FreeNAS
• ✅ Any Linux server with SSH access
• ✅ Raspberry Pi with external storage

Changelog

v1.1.0

• - Removed all specific agent/setup references
• Generalized folder structure and examples
• Added backup strategy with cron

v1.0.0

• - Initial release