← Back to Skills Marketplace
NAS Agent Sync
by
Nealbuilds
· GitHub ↗
· v1.1.0
802
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install nas-agent-sync
Description
Centralizes multi-agent file storage by routing all file operations through a designated File Master agent using SSH to a Synology NAS or any SSH-accessible...
Usage Guidance
This skill is conceptually reasonable for centralizing agent files to a Synology NAS, but the SKILL.md and the registry metadata are inconsistent and the instructions ask agents to access and transmit local workspace files via sessions_send. Before installing or using it:
- Expect to manually provide an SSH key/account on the File Master; the skill should explicitly declare required binaries (ssh, rsync) and the credential handling method.
- Restrict the File Master to a dedicated account on the NAS with minimal permissions (dedicated home dir, no shell access beyond scp/rsync if possible). Consider a forced-command or restricted sftp/chroot account on the NAS.
- Do not place private keys or long-lived secrets in agent memory or SOUL.md; store the private key only on the File Master host, with proper filesystem permissions and rotation policy.
- Test with non-sensitive files first to confirm where file contents are logged or retained by the agent messaging (sessions_send). Add explicit size limits and content filters to avoid accidental exfiltration of secrets.
- If you enable scheduled backups, audit the backup payload and logs and ensure backup tasks run under a least-privilege account.
- Ask the skill author to update metadata to list required binaries (ssh, rsync, cron capability) and to declare what credentials the skill expects and how they should be provisioned.
If you cannot confirm these changes or control of the File Master account/NAS, treat installation as higher risk and avoid sending sensitive data through the system.
Capability Analysis
Type: OpenClaw Skill
Name: nas-agent-sync
Version: 1.1.0
The skill bundle describes a legitimate NAS integration via SSH, but the `SKILL.md` instructions for the 'File Master' agent involve constructing and executing `ssh` and `rsync` commands with user-provided or inter-agent parameters (e.g., `[file]`, `[subfolder]`). This pattern introduces a significant shell injection vulnerability on the remote NAS if these parameters are not rigorously sanitized by the OpenClaw agent's execution environment, potentially allowing arbitrary command execution on the NAS. While the stated purpose is benign, the direct execution of shell commands with templated inputs represents a high-risk capability without explicit safeguards described in the skill itself.
Capability Assessment
Purpose & Capability
The stated purpose (centralized NAS file storage via a single File Master over SSH) is coherent with the instructions (ssh, rsync, sessions_send, folder layout). However the registry metadata claims no required binaries or credentials even though the SKILL.md explicitly requires ssh, rsync, and an SSH key on the File Master — this omission is an inconsistency that should be corrected.
Instruction Scope
The SKILL.md instructs the File Master to run ssh/rsync commands, cat files, and send file contents back to requesting agents using sessions_send. That means agents will access local workspace paths (~/.openclaw/workspace-*/memory/) and transmit file content through agent messaging. Those actions can expose secrets or large files and should be narrowly scoped, audited, and documented; the instructions do not mandate any filtering, size limits, or content-sanitization.
Install Mechanism
This is an instruction-only skill (no install spec, no code files), which minimizes installation risk. There is no download/extract/install mechanism in the registry payload.
Credentials
The skill metadata lists no required environment variables or primary credential, yet the runtime workflow depends on an SSH key/account on the File Master and on the target NAS accepting key-based auth. Also it expects access to local user paths like ~/.openclaw/workspace-*/ — potentially containing sensitive data. The lack of declared credentials/tools is disproportionate to what the instructions actually require.
Persistence & Privilege
The skill does not request always:true and has no install-time persistence. However the README suggests scheduling recurring backups (cron job via OpenClaw), which would enable autonomous, scheduled file transfers and therefore increases impact if misconfigured. Autonomous invocation is allowed by default; this combination warrants caution but is not itself a disqualifying privilege.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nas-agent-sync - After installation, invoke the skill by name or use
/nas-agent-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
SECURITY FIX: Removed all specific agent names and setup details. Fully generalized examples.
v1.0.0
- Initial release of nas-agent-sync (v1.0.0)
- Introduces the File Master agent pattern for secure, centralized file storage via SSH
- Provides comprehensive setup and folder structure guides for Synology and compatible NAS systems
- Includes documented backup strategies using cron and rsync
- Recommends Tailscale for secure remote SSH access
- Supports multi-agent teams and various NAS/Linux storage platforms
Metadata
Frequently Asked Questions
What is NAS Agent Sync?
Centralizes multi-agent file storage by routing all file operations through a designated File Master agent using SSH to a Synology NAS or any SSH-accessible... It is an AI Agent Skill for Claude Code / OpenClaw, with 802 downloads so far.
How do I install NAS Agent Sync?
Run "/install nas-agent-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is NAS Agent Sync free?
Yes, NAS Agent Sync is completely free (open-source). You can download, install and use it at no cost.
Which platforms does NAS Agent Sync support?
NAS Agent Sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created NAS Agent Sync?
It is built and maintained by Nealbuilds (@neal-collab); the current version is v1.1.0.
More Skills