nas-agent-sync

What This Skill Does

The NAS Agent Sync skill provides a centralized file storage solution for multi-agent teams by integrating with a Synology NAS or any SSH-accessible storage. It addresses the common problem of scattered files across different agent workspaces, which can lead to lost data, lack of backups, duplicated efforts, and no single source of truth. The skill designates one agent as the 'File Master' responsible for managing all file operations. Other agents route their file requests (storing or retrieving) through the File Master using sessions_send. The File Master then handles the SSH connection to the NAS, maintains a structured folder system for each agent and shared resources, and manages the actual file storage and retrieval. This architecture ensures efficient cross-agent file sharing and a robust backup strategy.

Installation

To install the NAS Agent Sync skill, use the following command:

clawhub install openclaw/skills/skills/neal-collab/nas-agent-sync

This skill is sourced from the openclaw/skills repository.

Use Cases

• Centralized Document Repository: Store all important project documents, reports, and assets in a single, accessible location managed by the File Master.
• Team Collaboration: Enable seamless file sharing between different agents working on the same project, ensuring everyone has access to the latest versions.
• Automated Backups: Leverage the NAS as a reliable backup destination for all agent-generated files, preventing data loss.
• Version Control: Maintain a clear history of files and a single source of truth, reducing confusion and duplicated work.
• Remote Access: Securely access and manage files from remote locations via SSH, VPN, or Tailnet.

Example Prompts

1. "File Master, please store the latest invoice.pdf from the finance agent into the finance/invoices/2023 folder on the NAS."
2. "Hey File Master, retrieve the sales_report_q3.xlsx from the sales agent's workspace on the NAS and send it to me."
3. "File Master, create a new directory structure on the NAS for the marketing agent under campaigns/summer_sale/ and confirm when done."

Tips & Limitations

• Security: Ensure your SSH access is secured with key-based authentication and consider using a VPN or Tailnet for encrypted remote access to your NAS.
• File Master Stability: The agent designated as the File Master must remain active and accessible for file operations to succeed. If the File Master goes offline, other agents will not be able to access or store files on the NAS.
• Folder Structure: Carefully plan and configure your NAS folder structure, especially the agent-directory.json file, to match your team's organization and agent roles.
• Error Handling: Implement robust error handling within your agents to gracefully manage potential SSH connection issues or file permission errors on the NAS.
• Scalability: For very large teams or extremely high file throughput, monitor NAS performance and network bandwidth to ensure smooth operation.