clawgo-clone

# ClawGo workspace sync skill Download a zip from clawgo.me, back up existing files, and copy Markdown from the archive into the local OpenClaw workspace. ## Service limits - Base URL: `https://clawgo.me` - Key: 12 alphanumeric characters (server normalizes to uppercase) - Only `.zip` payloads; require `status: ready` before download - Target folder: `~/.openclaw/workspace/` ## Workflow ### Step 1 — Check key readiness ```bash curl -s https://clawgo.me/api/clones/{key}/availability ``` - `available: true` and `status: ready` → continue - `status: pending` → stop with error: "No zip uploaded for this key yet" - Missing key (404) → stop with error: "Key not found" ### Step 2 — Download zip to a temp path ```bash curl -s -L -o /tmp/clone-{key}.zip \ https://clawgo.me/api/clones/{key}/download ``` Verify: file size must be greater than zero. ### Step 3 — Extract and inspect ```bash mkdir -p /tmp/clone-{key} unzip -o /tmp/clone-{key}.zip -d /tmp/clone-{key}/ ``` Run these safety checks after extraction. If anything looks wrong, warn the user clearly and ask whether to proceed: - List archive contents - Require at least one of: `SOUL.md`, `AGENTS.md`, `TOOLS.md` - If empty or none of the expected Markdown files → stop with error ### Step 4 — Back up current workspace files ```bash BACKUP_DIR="/tmp/backup-before-clone-$(date +%Y%m%d-%H%M%S)" mkdir -p "$BACKUP_DIR" WORKSPACE="$HOME/.openclaw/workspace" for f in SOUL.md AGENTS.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md; do [ -f "$WORKSPACE/$f" ] && cp "$WORKSPACE/$f" "$BACKUP_DIR/$f" done ``` Tell the user the backup path so they can roll back manually if needed. ### Step 5 — Write archive files into the workspace ```bash WORKSPACE="$HOME/.openclaw/workspace" SRC="/tmp/clone-{key}" for f in SOUL.md AGENTS.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md; do [ -f "$SRC/$f" ] && cp "$SRC/$f" "$WORKSPACE/$f" done ``` Only files present in the zip are copied; local files missing from the zip are left unchanged (not removed). ### Step 6 — Report results Tell the user: - Files successfully written from the zip - Files skipped because they were absent from the zip - Backup directory path - Suggestion: run `/reset` to restart the session so new workspace content loads ## Workspace file reference | File | Role | |------|------| | `SOUL.md` | Primary identity, reasoning style, behavioral guardrails | | `AGENTS.md` | Session bootstrap, tool policy, hard limits | | `TOOLS.md` | Local tooling notes and proxy routing | | `IDENTITY.md` | Display name, role, emoji metadata | | `USER.md` | User profile and session context | | `HEARTBEAT.md` | Scheduled task notes | ## Errors | Situation | Action | |-----------|--------| | `status: pending` | Stop; ask the user to upload a zip first | | Key missing (404) | Stop; invalid key | | No expected Markdown in zip | Stop; archive content does not match expectations | | Downloaded file size is 0 | Stop; retry or report failure | | Copy failed (permissions, etc.) | Report error; backup remains available |