📦 AgentcloudAgentCloud — 代理cloud代理Cloud

代理Cloud 技能

为 AI 代理 打造的云存储服务。让你的 代理 拥有专属文件存储空间，支持跨 代理 文件传输和分享。

快速开始 一键注册 代理（无需手机/邮箱，无需先注册人类账号）

只需一个命令，代理 就能获得专属存储空间：

curl -X POST https://API.追踪claw.cn/API/v1/代理s/register/open \ -H "Content-Type: 应用/json" \ -d '{"name": "my-代理"}'

# 返回示例 # { # "代理_id": "agt_xxxxx", # "API_key": "avk_yyyyy", # ← 保存好！只返回一次 # "name": "my-代理", # "plan": "free", # "total_storage_mb": 30 # }

⚠️ API_key 只返回一次，请妥善保存。如果丢失，可在 仪表盘 重置。

设置 API Key # 保存到环境变量（推荐） 导出 代理CLOUD_KEY="avk_yyyyy"

# 或直接写在请求头中 # X-代理-Key: avk_yyyyy

API 概览

所有请求都通过 https://API.追踪claw.cn/API/v1 访问。

方法 路径 认证 说明 POST /代理s/register/open 无（开放注册，限频3次/小时/IP） 注册新 代理 获取 /代理s/me X-代理-Key 查询本 代理 信息 POST /代理s/{id}/re设置-key X-代理-Key 重置 API Key 删除 /代理s/{id} X-代理-Key 删除 代理 POST /files/上传 X-代理-Key 上传文件 获取 /files/下载/{id} X-代理-Key 下载文件 获取 /files X-代理-Key 文件列表 删除 /files/{id} X-代理-Key 删除文件 POST /files/{id}/分享 X-代理-Key 创建分享链接 获取 /files/分享d/{令牌} 无需认证 通过分享链接下载

认证方式：代理 使用 X-代理-Key 请求头，值为注册时获得的 avk_xxx API Key。

Python 使用示例 安装依赖 pip 安装 请求s

注册 代理 导入 请求s

BASE = "https://API.追踪claw.cn/API/v1"

# 注册（无需任何认证） r = 请求s.post(f"{BASE}/代理s/register/open", json={"name": "my-代理"}) data = r.json()

API_key = data["API_key"] # 保存好！ 代理_id = data["代理_id"] print(f"注册成功！代理 ID: {代理_id}")

上传文件 API_KEY = "avk_xxxxx" # 注册时获得的 Key

with open("报告.pdf", "rb") as f: r = 请求s.post( f"{BASE}/files/上传", files={"file": ("报告.pdf", f, "应用/pdf")}, headers={"X-代理-Key": API_KEY} ) file_id = r.json()["file_id"] print(f"上传成功！File ID: {file_id}")

下载文件 r = 请求s.获取( f"{BASE}/files/下载/{file_id}", headers={"X-代理-Key": API_KEY} ) with open("下载ed.pdf", "wb") as f: f.write(r.content)

创建分享链接（给其他 代理） # 生成 1 小时有效分享链接 r = 请求s.post( f"{BASE}/files/{file_id}/分享", json={"expires_in": 3600}, headers={"X-代理-Key": API_KEY} ) 分享_令牌 = r.json()["分享_令牌"] 分享_url = f"https://API.追踪claw.cn/API/v1/files/分享d/{分享_令牌}" print(f"分享链接: {分享_url}")

# 对方无需认证即可下载 r = 请求s.获取(分享_url) with open("分享d_file.pdf", "wb") as f: f.write(r.content)

查看文件列表 r = 请求s.获取( f"{BASE}/files", headers={"X-代理-Key": API_KEY} ) files = r.json() for f in files: print(f"{f['filename']} — {f['file_size']} bytes")

查询 代理 信息 r = 请求s.获取( f"{BASE}/代理s/me", headers={"X-代理-Key": API_KEY} ) print(r.json()) # { # "代理_id": "agt_xxx", # "name": "my-代理", # "total_storage_mb": 30, # "used_storage_mb": 1.2, # "subscription_end": null # }

curl 一行命令版 # 注册 curl -s -X POST https://API.追踪claw.cn/API/v1/代理s/register/open \ -H "Content-Type: 应用/json" \ -d '{"name":"my-代理"}'

# 上传文件 curl -s -X POST https://API.追踪claw.cn/API/v1/files/上传 \ -H "X-代理-Key: avk_xxxxx" \ -F "file=@myfile.pdf"

# 下载文件 curl -s -o 输出.pdf \ https://API.追踪claw.cn/API/v1/files/下载/{file_id} \ -H "X-代理-Key: avk_xxxxx"

# 创建分享链接 curl -s -X POST https://API.追踪claw.cn/API/v1/files/{file_id}/分享 \ -H "X-代理-Key: avk_xxxxx" \ -H "Content-Type: 应用/json" \ -d '{"expires_in": 3600}'

# 查看文件列表 curl -s https://API.追踪claw.cn/API/v1/files \ -H "X-代理-Key: avk_xxxxx" | jq .

网页 管理后台

注册后可通过浏览器管理文件：

首页: https://代理cloud.追踪claw.cn 登录: https://代理cloud.追踪claw.cn/记录in 控制台: https://代理cloud.追踪claw.cn/仪表盘

登录后可查看存储使用量、管理上传的文件、查看 API Key。

套餐说明

代理Cloud 采用会员制：

套餐 价格 存储空间 🆓 免费 ¥0 30 MB ⭐ VIP ¥6/月 600 MB 💎 SVIP ¥30/月 3.2 GB 👑 SVIP+ ¥128/月 15 GB

注册即送免费额度，可通过 网页 后台充值升级。

OpenClaw / OpenCode 用户使用 安装方式

OpenClaw/OpenCode 不支持 hermes 技能s 安装，但支持本地 技能 目录发现。有两种方式让 技能 生效：

方式一：直接克隆仓库用 命令行工具 脚本

git clone https://github.com/jiangzh0202/代理cloud-技能.git ~/代理cloud-技能 cd ~/代理cloud-技能 pip 安装 请求s python3 scripts/代理cloud.py register python3 scripts/代理cloud.py me

方式二：让 OpenClaw 自动发现 技能.md

# 全局安装（所有项目生效） mkdir -p ~/.config/opencode/技能s/代理cloud cp ~/代理cloud-技能/技能.md ~/.config/opencode/技能s/代理cloud/

# 或项目级安装（仅当前项目生效） mkdir -p .opencode/技能s/代理cloud cp ~/代理cloud-技能/技能.md .opencode/技能s/代理cloud/

OpenClaw/OpenCode 会自动从 ~/.config/opencode/技能s/、.opencode/技能s/、.claude/技能s/、.代理s/技能s/ 目录加载 技能。安装后 代理 在对话中可自动发现并使用。

在代码中调用 API # OpenClaw 脚本示例 导入 请求s

# 注册（开放注册，无需任何前置条件） r = 请求s.post("https://API.追踪claw.cn/API/v1/代理s", json={ "name": 上下文.代理.name # 使用 代理 自身名称 }) config = r.json() 上下文.memory.设置("代理cloud_key", config["API_key"])

# 上传文件 r = 请求s.post( "https://API.追踪claw.cn/API/v1/files/上传", files={"file": open("/tmp/结果.txt", "rb")}, headers={"X-代理-Key": config["API_key"]} ) file_id = r.json()["file_id"]

助手脚本

本技能附带了一个 Python 助手脚本 代理cloud.py，提供更便捷