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#

FileRoleSOUL.mdPrimary identity, reasoning style, behavioral guardrailsAGENTS.mdSession bootstrap, tool policy, hard limitsTOOLS.mdLocal tooling notes and proxy routingIDENTITY.mdDisplay name, role, emoji metadataUSER.mdUser profile and session contextHEARTBEAT.mdScheduled task notes

Errors#

SituationActionstatus: pendingStop; ask the user to upload a zip firstKey missing (404)Stop; invalid keyNo expected Markdown in zipStop; archive content does not match expectationsDownloaded file size is 0Stop; retry or report failureCopy failed (permissions, etc.)Report error; backup remains available