file-sync

Synchronize Hermes Worker configs, skills, and shared files from MinIO.

5.3k|652|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/agentscope-ai/HiClaw --skill file-sync-agentscope-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-sync
Source: https://github.com/agentscope-ai/HiClaw/tree/main/manager/agent/hermes-worker-agent/skills/file-sync
Command: npx skills add https://github.com/agentscope-ai/HiClaw --skill file-sync-agentscope-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires hermes-worker (bridge_openclaw_to_hermes, FileSync), mc, and includes scripts (resource) components.

What problem does it solve?

File synchronization drift between a coordinator/other workers and your Hermes Worker workspace can cause you to run on stale configs or outdated task and shared artifacts.

Core Features & Use Cases

  • Sync config and skill artifacts from MinIO: Pulls openclaw.json, SOUL.md, AGENTS.md, and skills into the Hermes workspace and re-bridges config into ${HERMES_HOME}.
  • Mirror shared task/project files: Keeps shared/tasks/{task-id}/ and shared/projects/{project-id}/ up to date via the shared directory mirror.
  • On-demand and automatic updates: Supports immediate sync via hermes-sync and periodic fallback syncing every 300 seconds.

Quick Start

Run file-sync on your Hermes Worker by telling the system to execute the file synchronization command.

Frequently Asked Questions about file-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent stale configuration and shared task artifacts in a multi-agent runtime?

To prevent stale configuration and shared task artifacts in a multi-agent runtime, you need to synchronize files from centralized MinIO storage to your local workspace. This ensures all agents operate on the latest openclaw.json, SOUL.md, and AGENTS.md files.

What is the best way to sync Hermes Worker configuration files during active task workflows?

The best way to sync Hermes Worker configuration files during active task workflows is to pull openclaw.json and skill directories from MinIO. You can trigger this on-demand or rely on automatic fallback syncing every 300 seconds to stay current.

How does file synchronization handle shared project directories in collaborative workspaces?

File synchronization handles shared project directories in collaborative workspaces by mirroring shared/tasks/{task-id}/ and shared/projects/{project-id}/ folders directly from centralized storage. This ensures every agent accesses identical task artifacts.

Can I use MinIO to distribute skill updates to agents in a multi-agent collaboration room?

Yes, you can use MinIO to distribute skill updates to agents in a multi-agent collaboration room. The system pulls skill directories from MinIO and re-bridges config changes into the Hermes workspace automatically.

Why does my Hermes Worker run on outdated configs after a coordinator updates the shared files?

Your Hermes Worker runs on outdated configs because file synchronization drift occurs without pulling from centralized MinIO storage. Bridging openclaw.json into ${HERMES_HOME} config files is required to eliminate stale execution state.

Do I need hermes-worker to bridge openclaw.json into the Hermes home directory?

Yes, you need the hermes-worker dependency to bridge openclaw.json into the Hermes home directory. It handles re-bridging config.yaml, .env, SOUL.md, and AGENTS.md files when configuration changes are detected.