workspace-sync
Sync agent workspace with cloud storage (Dropbox, Google Drive, S3, etc.) using rclone.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ashbrener/openclaw-workspace-syncworkspace-sync
Sync the agent workspace with cloud storage. mode is required — choose mailbox (inbox/outbox, safest), mirror (remote->local), or bisync (bidirectional, advanced).
Trigger
Use this skill when the user asks to:
- Sync workspace to/from cloud
- Back up workspace files
- Check sync status
- Fix sync issues
- Send files to the agent workspace
Sync modes
| Mode | Direction | Description |
|---|---|---|
mailbox (recommended) | Push + inbox/outbox | Workspace pushes to cloud; _outbox sends files up to the agent's _inbox. Safest. |
mirror | Remote → Local | One-way: workspace mirrors down. Safe — local can never overwrite remote. |
bisync | Bidirectional | Two-way sync. Powerful but requires careful setup. |
Mailbox mode
Each sync cycle: (1) pushes workspace to cloud excluding _inbox/ and _outbox/, (2) drains cloud _outbox/ into workspace _inbox/ via rclone move (deletes from cloud after transfer). On startup, bootstraps cloud:_outbox and local _inbox/.
Users drop files in the local _outbox/ folder (created by the cloud provider's desktop app). Files arrive in the agent's _inbox/. The agent or a skill processes them from there.
With notifyOnInbox: true, the agent is woken when files land in _inbox. A system event lists the new filenames so the agent can process them. Off by default — each notification costs an agent turn.
Mirror mode with ingest
With ingest: true, a local inbox/ folder syncs one-way up to the remote workspace (additive only). For a more robust pattern, use mailbox mode instead.
Commands
Check sync status
openclaw workspace-sync status
Shows: provider, mode, last sync time, sync count, error count, running state.
Trigger manual sync
openclaw workspace-sync sync
In mailbox mode: pushes workspace and drains _outbox. In mirror mode: pulls latest from remote. In bisync mode: runs bidirectional sync.
Preview changes
openclaw workspace-sync sync --dry-run
One-way sync (explicit direction)
openclaw workspace-sync sync --direction pull # remote -> local
openclaw workspace-sync sync --direction push # local -> remote
Force re-establish bisync baseline (destructive)
openclaw workspace-sync sync --resync
WARNING: --resync is destructive (bisync only). It copies ALL files from both sides to make them identical — deleted files come back, and it transfers everything. Only use when you explicitly need to re-establish the bisync baseline. The plugin never auto-resyncs.
View remote files
openclaw workspace-sync list
Lists files in the configured cloud storage path.
Configuration
Workspace sync is configured via the plugin entry in openclaw.json. The preferred format uses nested sync and backup blocks (flat config at root level is also supported):
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-ashbrener-openclaw-workspace-sync": {
"enabled": true,
"auto_update": true
}
}
}