Purpose

This timer manages the push-side of the bidirectional vault synchronization. It ensures that canonical VPS paths (plans, memory, knowledge-base, and agent files) are rsynced into the Obsidian vault and pushed to the private GitHub repository to maintain a durable, versioned backup.

Schedule

OnUnitActiveSec=15min (with RandomizedDelaySec=180s) The service triggers every 15 minutes after the last activation, with a random jitter of up to 3 minutes to prevent resource spikes.

Service

Runs openclaw-vault-sync.service, which executes the shell script: /home/opsadmin/.openclaw/tools/openclaw-vault-sync.sh

Failure behavior

The service is configured as Type=oneshot with Restart=no. If the sync fails (e.g., due to network issues or a locked mutex at /tmp/openclaw-vault-sync.lock), it will fail silently for that cycle and attempt to run again at the next 15-minute interval.

Health signal

Verification can be performed via:

  • Logs: Check ~/.openclaw/logs/openclaw-vault-sync.log
  • System Status: systemctl --user status openclaw-vault-sync.timer
  • Remote: Verify the latest commit timestamp in the traewayrer/openclaw-vault GitHub repository.
  • cron-timer-registry — Central registry of all system timers.
  • _summary — Primary agent whose SOUL and memory files are synced.
  • github — Integration details for the vault backup repository.