📦 mnemospark-lite 云文件存储

mnemospark Lite for OpenClaw 使用此技能从 OpenClaw 操作 mnemospark-lite。mnemospark-lite 通过简单的付费 HTTP 工作流为任何代理提供云存储访问。代理可以上传文件、列出存储文件、删除文件，并生成可共享链接，可以传递给另一个代理或人类。人类可以使用 https://app.mnemospark.ai/mnemospark-lite 的 Web 应用程序查看文件、下载文件、删除文件和创建共享链接。它是相同的存储系统，旨在为代理和人类提供干净的工作。文件保留 30 天，然后自动删除。

工作流摘要 支持以下 mnemospark-lite 操作： 上传文件并生成共享 URL 列出付款者钱包范围内的上传 获取特定上传的下载详细信息 为现有上传生成 24 小时共享 URL 删除一个或多个上传 使用以下端点： POST /api/mnemospark-lite/upload POST /api/mnemospark-lite/upload/complete GET /api/mnemospark-lite/uploads GET /api/mnemospark-lite/download/{uploadId} POST /api/mnemospark-lite/share POST /api/mnemospark-lite/delete

输入 收集请求操作的最少输入。 常见输入： MNEMOSPARK_API_BASE_URL=https://api.mnemospark.ai 具有 x402 功能的付款者或现有的 mnemospark 兼容钱包 上传输入： 磁盘上的文件路径 层级：10mb、100mb、500mb、1gb、2gb 或 3gb 之一 contentType 字节大小 上传后带有 Bearer 范围的读写输入： Authorization: Bearer 使用付款上传流程中的 list_scope_bearer 实体输入： 下载/共享/删除操作的 uploadId 删除操作的一个或多个 uploadId 值

OpenClaw 环境提示 在 OpenClaw 内运行时： 如果安装了 mnemospark 插件，钱包密钥通常位于 /home/ubuntu/.openclaw/mnemospark/wallet/wallet.key 一些较旧或本地设置也可能具有遗留的 Blockrun 钱包路径，但不要假设它是插件的活动 mnemospark 钱包 对于 CLI，首选绝对调用，如 /usr/bin/node /home/ubuntu/.openclaw/extensions/mnemospark/dist/cli.js wallet 不要依赖 npx mnemospark 或 cwd 敏感路径，当本地安装状态可能已经漂移 如果使用 Python x402 客户端路径，安装 EVM 附加组件，而不仅仅是基本包：pip install 'x402[evm]'

规范上传流程 当用户想要上传文件时，使用此确切流程。

• 探测付款上传端点

首先在不付款的情况下探测 POST ${MNEMOSPARK_API_BASE_URL}/api/mnemospark-lite/upload，当需要 x402 挑战时。 请求正文：{ "filename": "example.txt", "contentType": "text/plain", "tier": "10mb", "size_bytes": 12 } 读取 PAYMENT-REQUIRED 或 x-payment-required，base64 解码它，并保留宣传的付款要求。 402 JSON 正文还可能包括：resource.url 接受 extensions.bazaar 对于 bazaar 索引和兼容性，保留宣传的要求并在客户端支持时将 extensions.bazaar 回显到 x402 PaymentPayload 中。

• 提交付款上传请求

使用以下内容重试相同的 POST /upload 请求： Content-Type: application/json PAYMENT-SIGNATURE: 或 x-payment: 首选 PAYMENT-SIGNATURE，除非运行时仅支持 x-payment。 响应字段可以包括： data.uploadId data.uploadUrl data.completion_token data.list_scope_bearer data.publicUrl data.siteUrl metadata.payment.status metadata.payment.transactionHash metadata.payment.success

• 正确处理结算轮询

付款 POST /upload 可能返回： 200 立即，或 202 带有错误：settlement_pending 如果它返回 202： 重试相同的付款请求 重用相同的付款有效负载 不要重新生成、规范化、缩小或重建付款 JSON 每隔约 2 秒轮询一次 使用约 60 秒的超时时间

• 上传文件字节

将文件字节发送到 data.uploadUrl。 示例：curl -T "example.txt" -H "Content-Type: text/plain" ""

• 完成上传

调用 POST ${MNEMOSPARK_API_BASE_URL}/api/mnemospark-lite/upload/complete，只带有： { "uploadId": "", "completion_token": "" } 规则： 不要将付款头发送到 /upload/complete 只发送 uploadId 和 completion_token 如果服务返回 202，轮询每隔几秒，直到 200 或超时 使用约 45-60 秒的超时时间 成功完成应该公开： data.upload.publicUrl data.upload.siteUrl data.upload.status

• 验证至少一个读路径

完成后，验证至少一个带有 Bearer 范围的读路径： GET /api/mnemospark-lite/uploads GET /api/mnemospark-lite/download/{uploadId} 使用 Authorization: Bearer 。 这确认上传对付款者范围内的 API 可见，可以生成或公开下载 URL。

关键可靠性规则 在 OpenClaw 下运行时，使用 x402 客户端生成的有效负载流程，而不是手动构建 JSON。 使用确切的付款有效负载