← Back to Skills Marketplace
zhangpengle

openclaw workspace backup

by zhangpengle · GitHub ↗ · v0.1.5 · MIT-0
cross-platform ⚠ suspicious
166
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install openclaw-workspace-backup
Description
将工作空间 git 仓库备份到 GitHub 各分支。通过 .env 配置目录列表,每天 03:00 自动执行。当用户说"workspace-backup"、"备份工作空间"、"工作空间备份"时触发。
Usage Guidance
Before installing or enabling this skill: (1) Inspect and control the .env files it will read (package .env and ~/.config/workspace/.env). Only list directories you intentionally want backed up; do not include home-level or system-level paths that may contain secrets. (2) Test on a non-sensitive directory first to confirm push behavior (branch naming, push errors). The tool commits with git add -A and push --force optionally — be sure you understand the consequence. (3) Confirm the 'origin' remote for each repo points to the intended GitHub repository (the code does not verify the host). (4) Consider modifying the script or adding a dry-run/approval step to avoid accidental commits of credentials or private files. (5) If you need stricter guarantees, run this locally under your control or add repository-level protections (or a dedicated remote) to prevent accidental exfiltration. Install only if you accept the risk of unattended commits/pushes from the configured directories.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-workspace-backup Version: 0.1.5 The workspace-backup skill is a legitimate utility designed to automate git-based backups of local directories to remote repositories. The implementation in workspace_backup/cli.py uses standard subprocess calls to execute git commands (add, commit, push) and manages configuration through local .env files. The code logic is transparent, includes logging to ~/.openclaw/logs/backup.log, and strictly follows the functionality described in SKILL.md and CLAUDE.md without any evidence of malicious intent, data exfiltration to unauthorized third parties, or obfuscation.
Capability Assessment
Purpose & Capability
Name/description claim: back up workspaces to GitHub branches. Code requires only git and reads WORKSPACE_<id>=<path> entries from package/user .env files — this is consistent. Minor mismatch: code pushes to remote named 'origin' (generic) and does not verify the remote is GitHub; the description suggests GitHub specifically.
Instruction Scope
Runtime behavior (workspace_backup/cli.py) will: read package and user .env files, iterate arbitrary directories specified there, run git add -A, commit, and push for each path, and write logs to ~/.openclaw/logs/backup.log. This is within backup purpose, but the agent will automatically add/commit/push whatever files are in the configured directories (including secrets like keys, config files, or other sensitive data) without any review or filtering. The code also does not switch or create branches before pushing and may fail or push unexpected refs. Daily automated execution increases the risk of unintended data exposure.
Install Mechanism
No install spec in registry; SKILL.md metadata suggests 'pip install -e {baseDir}' which is a reasonable install path for a Python CLI. No remote downloads or extract steps. Because code files are included, installing the package would place code on disk — expected for this type of utility.
Credentials
The skill does not request credentials or sensitive environment variables. It reads only package-level and user-level .env files for WORKSPACE_<id> entries (paths supplied by the user). No extra API keys or unrelated credentials are required.
Persistence & Privilege
always:false (not force-included). The SKILL.md says OpenClaw cron will run it daily at 03:00 — autonomous invocation combined with scheduled runs means the skill will act without interactive approval on each run. Autonomous invocation itself is normal, but combined with automatic commits/pushes this raises the operational risk if misconfigured.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-workspace-backup
  3. After installation, invoke the skill by name or use /openclaw-workspace-backup
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.5
- 改用 `.env` 文件集中配置多个待备份目录,淘汰原先的 openclaw.json 读取方式 - 每个工作空间目录将自动推送到对应的同名远程分支 - 移除对 agent 配置和 `list` 等结构的依赖,配置方式更加简化 - 删除 `backup.sh` 和 `status.sh` 脚本,备份与状态逻辑整合进 Python CLI - 文档简化,明确操作命令及前提说明
v0.1.4
- Migrated backup and status scripts into a Python package structure with CLI support. - Added pyproject.toml and modularized code under the workspace_backup directory. - Introduced new entrypoint: use workspace or workspace --backup for manual backup, workspace --status for status checks. - Updated documentation to reflect new usage and command structure. - Removed legacy scripts/ directory and refreshed triggers/metadata for better OpenClaw integration.
v0.1.1
**Dynamically support backup for multiple agents configured in openclaw.json.** - Now reads all agents from `openclaw.json`, backing up each workspace to a matching GitHub branch. - Allows custom workspace paths per agent; falls back to default if unspecified. - Improves backup script logic and error handling; backup failures are logged instead of sending notifications. - Updated documentation to describe dynamic agent detection and configuration.
v0.1.0
Initial release of workspace-backup skill. - Automatically backs up two OpenClaw Agent workspaces to separate GitHub branches (`main` and `formulas`) - Runs backup daily at 03:00 via OpenClaw cron - Includes scripts for manual backup and status checking - Sends WeCom notification if backup fails - Requires pre-configured SSH Key and initial git setup
Metadata
Slug openclaw-workspace-backup
Version 0.1.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is openclaw workspace backup?

将工作空间 git 仓库备份到 GitHub 各分支。通过 .env 配置目录列表,每天 03:00 自动执行。当用户说"workspace-backup"、"备份工作空间"、"工作空间备份"时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 166 downloads so far.

How do I install openclaw workspace backup?

Run "/install openclaw-workspace-backup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is openclaw workspace backup free?

Yes, openclaw workspace backup is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does openclaw workspace backup support?

openclaw workspace backup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created openclaw workspace backup?

It is built and maintained by zhangpengle (@zhangpengle); the current version is v0.1.5.

💬 Comments