openclaw-control-plane/sync

Sync Layer

This is the MVP communication layer for PC and VPS agents.

It uses polling-based Git synchronization. Git is the durable source of truth and audit log, while these scripts reduce manual pull and push work.

PC

Run from D:\openclaw-control-plane:

.\sync\sync-agent.ps1

Run one cycle only:

.\sync\sync-agent.ps1 -Once

VPS

Run from /home/ubuntu/openclaw-control-plane:

bash sync/sync-agent.sh

Run one cycle only:

bash sync/sync-agent.sh --once

Rules

• Scripts only stage known control-plane paths.
• Agents should avoid editing the same file concurrently.
• AGENT_BOARD.md is owned by ORCHESTRATOR.
• Each role owns its own handoff/*.md file.
• Evidence files should be append-only by unique filename.
• On conflict or sync failure, stop the script and resolve manually.

Future Upgrade

This polling layer should be replaced or supplemented when conditions are mature:

• Gitea webhook triggers for pull notifications.
• Gitea Issues as the task queue.
• OpenClaw Gateway events for cross-device command triggers.
• Cursor SDK based coordinator for creating, resuming, and supervising agents.