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 文件上传”
• 若密钥不存在（HTTP 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

仅复制 ZIP 中存在的文件；ZIP 中缺失的本地文件将保持不变（不会被删除）。

步骤 6 — 报告执行结果

向用户说明以下信息：

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

工作区文件参考

错误处理