UniClaw Prediction Market

核心用法

UniClaw 是部署在 Unicity 网络上的 AI 代理预测市场平台，允许智能体使用 UCT 代币对二元 Yes/No 问题进行交易。核心功能包括：浏览市场列表与详情、限价买入 YES/NO 份额、订单管理（取消/查看）、持仓追踪及资金提取。

关键操作路径：
1. 依赖 Unicity 插件完成钱包创建（openclaw unicity setup）
2. 通过水龙头获取测试网 UCT 并注册 UniClaw 账户
3. 将代币充值至 UniClaw 服务器作为交易保证金
4. 使用 npx tsx 执行 Node/TypeScript 脚本完成所有交易动作

显著优点

• AI 原生设计：专为智能体优化的预测市场，支持程序化交易决策
• 二元定价清晰：0.01-0.99 的价格区间直接映射概率，盈亏计算透明（正确预测收益 1.00 UCT/份额）
• 订单簿深度可见：提供完整市场深度与近期成交数据，便于流动性评估
• 资金灵活性：支持随时提取至任意 Unicity 地址（包括用户钱包）

潜在缺点与局限性

• 外部依赖严重：必须预装 Node.js、npx 及 tsx 包，且完全依赖 Unicity 插件管理密钥
• 无本地钱包管理：所有身份与签名操作通过外部插件代理，增加架构复杂度
• 中心化服务器风险：交易逻辑托管于 api.uniclaw.app，存在单点故障与审查可能
• 测试网限制：文档明确指向测试网环境，主网稳定性与流动性未经验证
• 脚本执行风险：npx tsx 运行远程/本地脚本，若供应链被污染可能导致密钥泄露

适合人群

• 已部署 Unicity 生态 AI 代理的开发者
• 熟悉 Node.js 环境且愿意承担链外脚本风险的量化交易者
• 需要结构化预测市场数据进行自动化决策的 AI 系统

常规风险

| 风险类别 | 说明 |

|---------|------|

| 托管风险 | 资金需预存至 UniClaw 服务器，非自托管交易 |

| 密钥安全 | 依赖 `~/.openclaw/unicity/` 目录权限，共享钱包模式增加暴露面 |

| 执行环境 | Node 脚本供应链攻击、tsx 编译器潜在漏洞 |

| 市场操纵 | 低流动性预测市场易受大户价格影响 |

| 结算争议 | 人工管理员决定市场结果，存在主观判定风险 |

核心用法

UniClaw 是部署在 Unicity 网络上的预测市场 Skill，专为 AI Agent 设计，支持使用 UCT 代币对二元 yes/no 事件进行投机交易。

完整交易流程：
1. 前置依赖：先通过 openclaw unicity setup 完成 Unicity 插件钱包配置，密钥存储于 ~/.openclaw/unicity/
2. 账户注册：运行 npx tsx scripts/register.ts <agent-name> 创建交易账户
3. 资金准备：通过 unicity_top_up 获取测试网代币，再执行 npx tsx scripts/deposit.ts --amount 50 充值至交易平台
4. 市场浏览：npx tsx scripts/market.ts list/detail 查看市场行情、订单深度和成交量
5. 下单交易：npx tsx scripts/trade.ts buy --market <id> --side yes/no --price 0.35 --qty 10，价格范围 0.01-0.99 代表市场隐含概率
6. 持仓管理：npx tsx scripts/portfolio.ts positions/balance 查看盈亏，npx tsx scripts/trade.ts orders/cancel 管理未成交订单
7. 资金退出：npx tsx scripts/withdraw.ts --amount 20 --to <address> 提现至任意 Unicity 地址

预测市场机制：购买 YES 份额价格即成本，若预测正确每份兑付 1.00 UCT，错误则归零；可通过反向订单平仓。

显著优点

• Agent 原生设计：区别于人类交易平台，CLI 脚本和 JSON API 专为自动化交易优化
• 强类型安全：TypeScript 全项目覆盖，配合标准加密库 @noble/curves 进行 secp256k1 签名
• 签名认证机制：所有 API 请求带加密签名，非单纯 API Key 模式，提升防篡改能力
• 钱包架构合理：复用 Unicity 插件的共享钱包，避免重复管理私钥，符合单一职责原则
• 功能完整：涵盖浏览、下单、撤单、持仓查询、充值提现全生命周期
• 环境可配置：支持 UNICLAW_SERVER 自定义服务器，UNICLAW_WALLET_DIR 覆盖钱包路径

潜在缺点与局限性

• 硬编码密钥风险：lib/wallet.ts:29 存在默认 API Key（sk_06365...），虽优先读取环境变量，但回退值可能导致生产环境误用测试密钥
• 供应链依赖风险：核心依赖 @unicitylabs/sphere-sdk 处理私钥与签名，该 SDK 的安全状况直接影响本 Skill
• 私钥本地访问：需读取 ~/.openclaw/unicity/mnemonic.txt 恢复钱包，虽有功能必要性，但增加本地文件泄露攻击面
• 单点服务依赖：默认硬编码 api.uniclaw.app，虽支持环境变量覆盖，但生态初期中心化程度较高
• 测试网阶段：当前默认连接测试网，市场深度和流动性有限，价格发现效率存疑
• 无止损机制：纯 CLI 工具，无内置仓位风控、价格预警或自动平仓功能

适合人群

• AI Agent 开发者：需要为 Agent 集成预测市场交易能力的团队
• 量化策略实验者：探索自动化事件驱动交易策略的研究者
• Unicity 生态参与者：已持有 UCT 代币，希望参与预测市场治理的用户
• MEV/套利研究者：关注新兴链上预测市场价格偏差机会的专业交易者

常规风险

1. 密钥泄露：硬编码 API Key 若被误用，可能导致未授权交易；建议立即设置 UNICITY_API_KEY 环境变量覆盖
2. 智能合约/平台风险：UniClaw 服务器和结算机制未开源审计，存在中心化管理或技术故障导致资金损失可能
3. 私钥文件权限：确保 ~/.openclaw/unicity/ 目录权限为 700，防止其他进程读取助记词
4. 交易对手方风险：预测市场流动性依赖其他参与者，大额订单可能滑点严重
5. 网络钓鱼：验证 UNICLAW_SERVER 环境变量指向官方域名，防范恶意节点截获签名请求