clawdbot-sync

What This Skill Does

The clawdbot-sync skill provides a robust framework for maintaining state consistency across distributed Clawdbot instances. By leveraging the secure, private networking capabilities of Tailscale and the reliability of SSH-based rsync, this skill ensures that your agents share a cohesive 'brain.' It manages the synchronization of memory files, user preferences, and skill configurations across different machines, whether you are running a Clawdbot on a local Mac, a cloud-based server, or a Raspberry Pi. The tool implements intelligent conflict resolution, utilizing timestamp comparison for standard files and specialized merging logic for append-only logs, ensuring data integrity while minimizing manual intervention.

Installation

Installation is handled directly through the Clawhub interface. Use the command clawhub install openclaw/skills/skills/udiedrichsen/clawdbot-sync to fetch the necessary components. Once installed, you must define your peer infrastructure using the handler.sh add command, specifying the peer name, Tailscale IP address, SSH username, and the target workspace path. Ensure that SSH key-based authentication is configured between your machines using ssh-copy-id to facilitate seamless, password-less synchronization sessions.

Use Cases

• Multi-Device Parity: Keeping your home server and laptop agents aligned so that you never lose a train of thought, regardless of which machine you are interacting with.
• Agent Fleet Management: Managing a group of specialized Clawdbots that need access to shared global knowledge or common datasets.
• Backup and Recovery: Maintaining a redundant, up-to-date copy of your agent's memory and configurations on a secondary node for fault tolerance.
• Seamless Transitions: Moving between different compute environments without the need to manually migrate configuration or context files.

Example Prompts

1. "Sync my memory with the mac-mini right now."
2. "Update my other clawdbot; I just added a new preference for project tracking."
3. "Show me the connection status for all my synced instances."

Tips & Limitations

• Security: Since this skill relies on SSH, ensure that your private keys are protected. Always prefer Tailscale's encrypted private network over exposing SSH to the public internet.
• Selective Sync: Remember that identity-specific files like IDENTITY.md and instance-specific config/ directories are ignored by default to prevent agent identity collisions.
• Conflict Management: If the system detects high-level conflicts that cannot be auto-resolved, check the memory/clawdbot-sync/conflicts/ directory to review and manually merge changes.