workspace-git-backup

What This Skill Does

The workspace-git-backup skill provides a robust, automated solution for backing up your local OpenClaw workspace or any arbitrary directory to a remote Git repository (GitHub or GitLab). By integrating with your existing shell environment, it bridges the gap between local file management and secure cloud version control. The skill is designed for cross-platform compatibility, leveraging native automation tools like launchd on macOS and cron on Linux. It handles the complete lifecycle of a backup: repository initialization, configuration management, scheduling, and execution, ensuring your sensitive workspace data is safely versioned and stored off-site without manual intervention.

Installation

To add this skill to your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/cooperun/workspace-git-backup

Once installed, you can trigger the setup process by asking the OpenClaw agent to configure a backup. The agent will interactively walk you through selecting your target directory, choosing a remote repository, and verifying your credentials. It automatically creates the necessary scripts, configuration files, and system-level scheduling tasks required for background operations.

Use Cases

• Workspace Protection: Automatically back up your OpenClaw working directory to prevent data loss due to hardware failure or accidental deletion.
• Configuration Versioning: Keep your dotfiles or project-specific configurations under version control, allowing for easy rollback and synchronization across multiple machines.
• Regular Documentation Sync: Use the optional timestamp feature to keep a README or status log up-to-date with the frequency of your automated backups.
• Audit Logs: Use the provided management commands to audit past backup attempts and troubleshoot potential connectivity issues with your Git host.

Example Prompts

1. "帮我配置 workspace 自动备份，把我的工作空间上传到 GitHub 私有仓库。"
2. "查看一下当前的备份状态，确认一下最近一次自动备份是否成功。"
3. "我想把我的文档文件夹也加入备份列表，该怎么操作？"

Tips & Limitations

• Authentication: For the smoothest experience, ensure you have the GitHub CLI (gh) installed and authenticated. Without it, the agent will require you to provide repository URLs manually.
• Git Ignored Files: Ensure you have a .gitignore file in your backup directory to avoid uploading large node_modules or binary files that could bloat your repository.
• Performance: While backups are asynchronous, very large directories may cause Git commit delays. Consider excluding large cache directories for optimal performance.
• Security: Always use private repositories if your workspace contains sensitive API keys or personal configuration files to prevent unauthorized access.