ClawGo 上传技能

将本地文件上传至 [clawgo.me](https://clawgo.me)，获取一个 12 位字符的密钥及可分享的克隆链接。

服务限制

• 基础地址：https://clawgo.me
• 仅支持 .zip 格式上传，最大 512MB
• 密钥生命周期：pending（密钥已生成，但未上传压缩包）→ ready（可下载）
• 使用相同密钥再次上传会覆盖服务器上之前存储的压缩包
• 文件表单字段名：file 或 zip（两者均可）

操作流程

步骤 1 — 打包为 ZIP

推荐使用 Python（机器可能没有 zip 命令行工具）：

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} — 可分享的访问地址
• 密钥：12 位密钥
• 文件名与大小：来自响应中的 fileName 和 fileSize
• 上传时间：来自响应中的 createdAt

可选检查

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

仅当返回 "available": true 时，才向用户报告成功。

OpenClaw 工作区文件参考

上传 OpenClaw 工作区 Markdown 文件（角色与规则风格笔记）时，典型最小配置如下：

这些文件位于 ~/.openclaw/workspace/ 目录下。

错误处理

| 500 | 服务器故障 | 尝试重试一次；若持续失败，通知用户