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

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

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

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

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

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

Errors