X2C Publish 是一个用于向 X2C 平台发布视频内容并管理数字资产的 API 技能，涵盖分发（Distribution）与钱包（Wallet）两大功能模块。
用途
该技能用于将视频内容发布到 X2C 平台，并对平台内的数字资产进行管理。它适合需要批量或程序化上传视频、跟踪审核状态、追加剧集，以及处理余额、领取、兑换、提现和交易记录查询的场景。
主要能力
分发工作流
分发流程包含以下步骤，需按顺序完整执行：
- distribution/categories — 获取分类
- distribution/upload-url — 获取 S3 预签名上传地址
- 通过 HTTP PUT 将文件上传到 S3
- distribution/publish — 使用第 3 步返回的 public_url 提交发布
- distribution/query — 查询审核状态
- distribution/add-episodes — 追加剧集
- distribution/list — 列出所有项目
提供视频有两种方式：
- S3 上传 — 对本地文件使用 upload-url 工作流
- 外部 URL — 在发布时直接使用已有的视频 URL
钱包 API（资产管理）
- wallet/balance — 获取余额，返回 credits、x2c_wallet_balance、x2c_pending_claim、x2c_pending_release、usdc_balance、wallet_address
- wallet/claim-x2c — 领取 X2C
- wallet/swap-x2c — 将 X2C 兑换为 USDC
- wallet/withdraw-usdc — 提取 USDC 到指定地址
- wallet/transactions — 查询交易历史，类型包括 earnings（挖矿、分发、推荐等）、purchases（消费、兑换、提现等）或 all
使用方式
认证与多用户支持
API 密钥可存储在 credentials/{USER_ID}.json 中：
{
"x2cApiKey": "x2c_sk_xxx"
}
调用时设置 USER_ID 环境变量。OpenClaw 会从聊天上下文自动传递该变量。也可以通过 X2C_API_KEY 环境变量设置，或在 ~/.openclaw/openclaw.json 中配置 skills."x2c-publish".env.X2C_API_KEY。
API 端点
所有请求发送到 X2C Open API。基础 URL 通过 X2C_API_BASE_URL 环境变量配置，或默认使用生产端点。
请求头：
- Content-Type: application/json
- X-API-Key: <your_x2c_api_key>
关键规则
- 按顺序完成所有工作流步骤，不要跳过
- 始终为 curl 命令添加超时：-m 60
- 绝不重试失败的请求 — 报告错误并询问用户
- 发布前检查项目状态以避免重复
- 封面 URL 必须是图片（jpg/png/webp），绝不能是视频 URL
发布参数
| 参数 | 必填 | 说明 |
|---|---|---|
| title | 是 | 项目名称（最多 100 字符） |
| description | 是 | 简介（最多 2000 字符） |
| category_id | 是 | 分类 UUID |
| cover_url | 是 | 封面图片 URL |
| video_urls | 是 | 视频 URL 数组（1-10 个） |
| enable_prediction | 否 | 启用预测市场 |
审核状态值包括：draft、pending_review、approved、rejected。
适用场景
- 需要以编程方式向 X2C 平台发布视频内容的开发者或运营人员
- 需要管理 X2C 平台内数字资产（余额、领取、兑换、提现）的用户
- 需要批量上传、追加剧集或跟踪审核状态的视频分发流程
限制
- 封面 URL 必须为图片格式，不能使用视频 URL
- 视频 URL 数组限制为 1-10 个
- 标题最多 100 字符，简介最多 2000 字符
- 失败请求不应重试，需报告错误并询问用户
- 关于收费、价格、平台覆盖范围或具体效果的信息暂未提供