clawgo-clone

Download a zip from clawgo.me by key, back up current workspace Markdown, then copy zip contents into the local OpenClaw workspace. Use when the user gives a 12-character ClawGo key (e.g. OCVG7H4AAVR2) and wants workspace content aligned with that key. Triggers — "sync workspace with this key", "pull workspace from clawgo", "restore my workspace notes", "clawgo clone", "workspace sync".

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

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