Mission#

Write the restore tooling so a new machine can clone Max-src/openclaw-workspace and be fully operational in minutes. Two deliverables: an executable bootstrap.sh script and a human-readable RESTORE.md guide, both at the repo root.

Deliverables#

All files in Max-src/openclaw-workspace (backup repo):

• bootstrap.sh — Idempotent restore script:

  1. Tool verification (node, npm, git, python3, jq)
  2. Create ~/.openclaw/{agents,workspaces,cron,state}
  3. rsync workspace/ from repo
  4. rsync workspaces/<id>/ → per-agent workspaces
  5. rsync agents/<id>/ → agent identity dirs
  6. Copy config/openclaw.json (refuses to overwrite without --force)
  7. Copy cron/jobs.json
  8. Check ~/.openclaw/.env — list exact export lines for any missing secrets
  9. Run openclaw config validate
  10. Print final instructions (systemd or manual start)
  • Supports --force, --help; exits with meaningful codes (0–4)
  • Color-coded step output

• RESTORE.md — Full human-readable guide covering prerequisites (with install commands for Linux/macOS), one-line clone + bootstrap, secrets reference table with URLs, systemd setup (with lingering), Mission Control rebuild, and 6 troubleshooting sections.

• systemd/openclaw-gateway.service — Template unit file (placeholder paths marked YOUR_USER)

• systemd/mission-control.service — Template unit file (placeholder paths marked YOUR_USER)

Acceptance criteria#

• bootstrap.sh is idempotent (ran twice with --force, clean)
• --force flag required to overwrite existing openclaw.json
• 10 complete steps printed with color-coded status
• RESTORE.md covers all troubleshooting scenarios
• Systemd templates provided (no machine-specific paths)
• bash -n bootstrap.sh passes (syntax check)
• Pre-commit hook passed, pushed to origin/main (commit 0a345ff)

Files on disk#

• ~/.openclaw-backup/bootstrap.sh
• ~/.openclaw-backup/RESTORE.md
• ~/.openclaw-backup/systemd/openclaw-gateway.service
• ~/.openclaw-backup/systemd/mission-control.service