ClawGo 上传技能

将本地文件上传至 clawgo.me，并获取一个 12 位字符的密钥及可共享的克隆 URL。

服务限制

• 基础 URL：https://clawgo.me
• 仅支持 .zip 文件上传，最大体积为 512 MB
• 密钥生命周期：pending（已生成密钥，但 zip 尚未上传）→ ready（可下载）
• 对同一密钥重复上传会覆盖服务器上该密钥此前存储的 zip 文件
• 表单中文件字段名称为：file 或 zip（二者均可）

工作流程

步骤 1 — 构建 zip 包

推荐使用 Python（目标机器可能未安装 zip CLI 工具）：

import zipfile, os

files = ['SOUL.md', 'AGENTS.md', 'TOOLS.md', 'IDENTITY.md', 'USER.md']   # 按需调整
output = '/tmp/upload-payload.zip'

with zipfile.ZipFile(output, 'w', zipfile.ZIP_DEFLATED) as z:
    for f in files:
        if os.path.exists(f):
            z.write(f)

压缩整个目录：

import zipfile, os

src_dir = '/path/to/dir'
output  = '/tmp/upload-payload.zip'

with zipfile.ZipFile(output, 'w', zipfile.ZIP_DEFLATED) as z:
    for root, _, filenames in os.walk(src_dir):
        for fname in filenames:
            fpath = os.path.join(root, fname)
            z.write(fpath, os.path.relpath(fpath, os.path.dirname(src_dir)))

继续后续步骤前，请确认 zip 文件已存在且非空。

步骤 2 — 生成密钥

curl -s -X POST https://clawgo.me/api/keys/generate

从返回的 JSON 中读取 key 字段（12 位大写英文字母与数字组合）。

步骤 3 — 上传 zip 文件

curl -s -X POST 
  -F "file=@/tmp/upload-payload.zip" 
  https://clawgo.me/api/clones/{key}/upload

成功响应包含 "status": "ready" 和 "available": true。

步骤 4 — 向用户反馈结果

上传成功后，向用户提供以下信息：

• 克隆链接：https://clawgo.me/clone/{key} — 可分享的 URL
• 密钥：12 位字符密钥
• 文件名与大小：取自响应中的 fileName 和 fileSize
• 上传时间：取自响应中的 createdAt

可选检查

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

仅当响应中出现 "available": true 后，才向用户报告成功。

OpenClaw 工作区文件参考

上传 OpenClaw 工作区 Markdown 文件（含角色设定与规则类笔记）时，典型的最小文件集如下：

这些文件路径位于 ~/.openclaw/workspace/ 下。

错误处理