| name | gitclaw-backup |
| description | GitHub backup for OpenClaw workspace. Use when user says "同步", "备份", "backup", "sync", "push to github", or asks about backup status/history/failures. Manages git-based full backup of ~/.openclaw to GitHub. |
GitClaw Backup
Full backup of /home/node/.openclaw/ to GitHub via git.
Quick Reference
- Repo:
https://github.com/blessonism/openclaw-backup.git
- Branch:
main
- Script:
/home/node/.openclaw/gitclaw/auto_backup.sh
- Cron:
daily-workspace-backup — 每天 UTC 16:00 (北京时间 0:00)
- Exclude rules:
/home/node/.openclaw/.gitignore
Manual Sync
Run the backup script directly:
bash /home/node/.openclaw/gitclaw/auto_backup.sh
Script behavior:
- Lock-based (prevents concurrent runs)
- Stages all changes (
git add -A), respects .gitignore
- Skips commit if no changes
- Pushes to
origin main
- Logs to
/home/node/.openclaw/gitclaw/backup.log
Post-Sync Response
After a successful sync, always include a clickable link to the latest commit in your reply:
cd /home/node/.openclaw && git log --oneline -1
Then format the response like:
✅ 同步完成 — 查看 commit
- If no changes were detected, report "无变更，跳过" (no link needed).
- If the push failed, report the error and suggest troubleshooting steps.
Check Status
tail -5 /home/node/.openclaw/gitclaw/backup.log
cd /home/node/.openclaw && git status --short
cd /home/node/.openclaw && git log --oneline -5
Exclude Files from Backup
Edit /home/node/.openclaw/.gitignore — standard gitignore syntax.
Current notable exclusions: workspace/images/, workspace/node_modules/, workspace/.micromamba/, workspace/bin/, large binary files.
Troubleshooting
- "already running" in log → stale lock at
/home/node/.openclaw/gitclaw/lock/, remove it: rmdir /home/node/.openclaw/gitclaw/lock
- Push rejected → likely force-push or diverged history on remote; check with
git log --oneline -5 origin/main
- Auth failure → credentials in
~/.git-credentials; verify with git credential fill <<< "host=github.com"
