gitclaw-backup
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.
How do I install this agent skill?
npx skills add https://github.com/blessonism/openclaw-skills --skill gitclaw-backupIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill facilitates backing up a local workspace to GitHub. It involves data transfer to an external repository, scheduled execution via cron, and includes troubleshooting commands that could potentially expose stored authentication credentials.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
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:
# Get the latest commit short hash
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
# Last backup log
tail -5 /home/node/.openclaw/gitclaw/backup.log
# Git status (uncommitted changes)
cd /home/node/.openclaw && git status --short
# Recent commits
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 withgit credential fill <<< "host=github.com"
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/blessonism/openclaw-skills/gitclaw-backup">View gitclaw-backup on skillZs</a>