Uniclaw Skill

核心用法

UniClaw 是基于 Unicity 网络的预测市场协议，专为 AI 代理设计，支持 UCT 代币对二元 Yes/No 事件进行概率定价交易。用户需先通过 Unicity 插件完成钱包初始化，注册账户并向合约存入 UCT 后即可参与市场。

关键操作流程：
1. 钱包准备：openclaw unicity setup 创建密钥对
2. 获取代币：通过 faucet 或 unicity_top_up 获取测试网 UCT
3. 账户注册：npx tsx scripts/register.ts <agent-name>
4. 资金存入：npx tsx scripts/deposit.ts --amount 50
5. 交易执行：浏览市场、查看订单簿深度、限价挂单（0.01-0.99 价格区间）
6. 仓位管理：实时查看持仓与未成交订单，支持反向平仓
7. 资金提取：npx tsx scripts/withdraw.ts 提至任意 Unicity 地址

显著优点

• 概率定价透明：价格即隐含概率，数学期望清晰（0.30 买入 YES 意味着 30% 市场定价，若真实概率更高则存在套利空间）
• AI 代理原生设计：命令行工具链完整，脚本化操作适合自动化策略
• 损失可控：买方最大损失为买入成本，无爆仓或追加保证金风险
• 流动性机制：支持限价单与订单簿深度查看，便于评估滑点

潜在缺点与局限性

• 生态依赖度高：必须完整部署 Unicity 插件，节点依赖 npx/tsx 环境，配置链路较长
• 中心化管理：市场由 admin 创建与结算，存在结果裁定信任假设
• 测试网阶段：当前为测试网部署，代币无实际价值，流动性深度有限
• 无自动做市：纯订单簿模式，冷门市场可能流动性枯竭
• 资金托管风险：交易前需将 UCT 存入服务器地址，非纯链上结算

适合人群

• 对预测市场机制有理解的量化交易者或 AI 代理开发者
• 希望在特定领域（加密、宏观、事件驱动）进行信息套利的用户
• 需要程序化接入二元事件概率定价的自动化系统
• 熟悉 Node.js/tsx 环境的开发者

常规风险

• 智能合约风险：尽管依赖 Unicity 底层安全，但 UniClaw 应用层合约未经广泛审计
• 结算争议风险：Admin 裁决模式存在主观判断或延迟可能
• 流动性风险：限价单可能长期无法成交，资金锁定在合约中
• 操作风险：CLI 工具参数错误（如价格区间外）导致交易失败或意外损失
• 测试网重置风险：测试环境数据可能丢失，资产非永久性

核心用法

UniClaw 是专为 AI Agent 设计的预测市场交易技能，运行在 Unicity 去中心化网络上。用户通过该技能可使用 UCT（Unicity Token）对二元 Yes/No 事件合约进行程序化交易。核心工作流包括：通过 Unicity 插件完成钱包初始化与身份认证；向 UniClaw 服务器注册代理账户并充值 UCT；浏览活跃市场列表与深度订单簿数据；根据隐含概率判断下注 YES 或 NO 份额；管理未平仓订单与持仓头寸；最终将盈利提取至链上钱包。

交易指令通过 npx tsx 执行 TypeScript 脚本完成，涵盖市场浏览（market.ts）、订单操作（trade.ts）、资产查询（portfolio.ts）及资金划转（withdraw.ts）四大功能模块。价格区间限定 0.01-0.99 UCT，代表市场对事件发生的隐含概率，正确预测可获得 1.00 UCT/份额的固定赔付。

显著优点

去中心化架构：依托 Unicity 网络实现链上结算，交易数据透明可验证，避免中心化交易所的托管风险。AI原生设计：接口专为程序化访问优化，Agent 可直接解析订单簿 JSON 数据，无需模拟浏览器操作。确定性收益结构：二元合约盈亏计算清晰，最大损失锁定为建仓成本，适合风险量化模型。模块化钱包管理：与 Unicity 插件共享密钥体系，避免重复管理助记词，支持多技能复用同一身份。实时市场数据：提供最优买卖报价、成交量、近期成交价等多维度信息，支持算法定价策略。

潜在缺点与局限性

测试网阶段限制：当前硬编码的 API Key 指向测试网环境，主网迁移需重新配置认证体系。内部 API 依赖：通过 (sphere as any)._identity 访问 SDK 私有字段获取私钥，存在 SDK 升级后兼容性断裂风险。流动性约束：预测市场深度依赖用户参与度，小众事件可能出现买卖价差过大或订单无法成交的情况。价格发现机制简单：纯订单簿模式无自动做市商，大额交易可能显著冲击市场价格。人机协作门槛：需同时理解区块链钱包操作、预测市场定价逻辑及命令行工具使用，对非技术用户不够友好。

适合的目标群体

量化策略开发者：希望将预测市场纳入多资产组合、需要可编程接口进行回测和实盘的交易系统工程师。AI Agent 运营者：为自动化代理配置金融工具能力，实现基于信息优势的事件驱动交易。区块链研究人员：探索去中心化预测市场机制设计、流动性模型及 Agent 经济行为的学术或行业研究者。加密原住民：熟悉 CLI 操作、持有 UCT 并寻求非托管交易体验的进阶用户。

使用风险

密钥安全风险：助记词以明文形式存储于 ~/.openclaw/unicity/mnemonic.txt，目录权限配置不当可能导致资金损失。智能合约风险：尽管依赖审计通过的密码学库，UniClaw 服务器自身的合约逻辑未公开审计细节。网络可用性风险：单一服务端点 api.uniclaw.app 故障将中断全部交易功能，无备用节点机制。依赖供应链风险：使用 ^2.0.1 等松散版本约束，可能因依赖库更新引入未预期的行为变更。监管合规风险：预测市场在部分司法辖区受严格限制，用户需自行评估本地法律环境。测试网资金风险：测试网 UCT 无实际价值，但主网迁移后的真实资金操作需格外谨慎验证地址与金额。