ClawGo 工作区同步技能

从 clawgo.me 下载 ZIP 文件，备份现有文件，并将压缩包中的 Markdown 内容复制到本地 OpenClaw 工作区。

服务限制

• 基础 URL：https://clawgo.me
• 密钥：12 个字母数字字符（服务器会自动转换为大写）
• 仅支持 .zip 格式数据包；下载前必须确保 status: ready
• 目标目录：~/.openclaw/workspace/

操作流程

步骤 1 — 检查密钥就绪状态

curl -s https://clawgo.me/api/clones/{key}/availability

• available: true 且 status: ready → 继续执行
• status: pending → 停止并报错：“该密钥尚未上传 ZIP 文件”
• 密钥不存在（返回 404）→ 停止并报错：“密钥不存在”

步骤 2 — 下载 ZIP 到临时路径

curl -s -L -o /tmp/clone-{key}.zip \
  https://clawgo.me/api/clones/{key}/download

验证：文件大小必须大于零。

步骤 3 — 解压并检查内容

mkdir -p /tmp/clone-{key}
unzip -o /tmp/clone-{key}.zip -d /tmp/clone-{key}/

解压后执行以下安全检查。若发现异常，请明确提示用户并询问是否继续：

• 列出压缩包内所有文件内容
• 必须至少包含以下文件之一：SOUL.md、AGENTS.md、TOOLS.md
• 若为空或不包含上述任一预期的 Markdown 文件 → 停止并报错

步骤 4 — 备份当前工作区文件

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

告知用户备份路径，以便在需要时手动回滚。

步骤 5 — 将压缩包文件写入工作区

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

仅复制压缩包中存在的文件；本地存在的文件若不在压缩包中，则保持不变（不会被删除）。

步骤 6 — 报告执行结果

向用户说明：

• 成功从 ZIP 中写入的文件
• 因未在 ZIP 中找到而跳过的文件
• 备份目录路径
• 建议：运行 /reset 以重新启动会话，使新工作区内容生效

工作区文件说明

错误处理