ClawGo 上传技能

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

服务限制

• - 基础 URL：https://clawgo.me
• 仅支持 .zip 格式上传，最大 512MB
• 密钥生命周期：pending（密钥已签发，zip 尚未上传）→ ready（可下载）
• 对同一密钥再次上传会替换服务器上该密钥对应的 zip 文件
• 文件表单字段名：file 或 zip（两者均可）

工作流程

步骤 1 — 构建 zip 文件

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

python
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)

压缩整个目录：

python
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(srcdir):
for fname in filenames:
fpath = os.path.join(root, fname)
z.write(fpath, os.path.relpath(fpath, os.path.dirname(src_dir)))

在继续之前，确认 zip 文件存在且非空。

步骤 2 — 生成密钥

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

从 JSON 中读取 key 字段（12 位字母数字字符，大写）。

步骤 3 — 上传 zip 文件

bash
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

可选检查

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

仅在 available: true 后才向用户报告成功。

OpenClaw 工作区文件参考

上传 OpenClaw 工作区 Markdown（角色和规则类笔记）时，典型的最小文件集为：

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

错误处理