polyclaw

核心用法

PolyClaw 是一款面向 OpenClaw 框架的 Polymarket 交易技能，提供完整的预测市场交互能力。用户可通过命令行完成市场浏览、钱包状态查询、合约授权、YES/NO 仓位交易、持仓盈亏追踪及 AI 对冲发现等操作。交易采用"拆分+订单簿"模式：将 USDC.e 拆分为条件代币后，通过 CLOB 卖出不需要的一侧以降低净成本。

显著优点

1. 功能完整闭环：覆盖从市场发现、交易执行到持仓管理的全流程，无需离开终端即可完成操作。
2. 智能对冲发现：集成 OpenRouter LLM（默认 nvidia/nemotron-nano-9b-v2），通过逻辑蕴含关系识别跨市场对冲组合，支持 Tier 1 近套利机会筛选。
3. 工程化设计：采用 uv 包管理、原子文件写入、线程安全锁、代理轮换重试等生产级实践。
4. 来源可信：基于 Chainstack 官方开源项目 polymarket-alpha-bot，作者为 Chainstack 团队成员，代码可审计。

潜在缺点与局限性

1. 私钥管理风险：私钥通过环境变量传递，存在进程泄露风险，文档已明确建议仅存储小额资金。
2. CLOB 访问障碍：Polymarket 的 Cloudflare 防护会阻断大量 IP，必须配置住宅代理（如 IPRoyal）才能稳定交易，增加了使用门槛和成本。
3. 流动性依赖：CLOB 卖单可能因流动性不足失败，需手动介入或启用 --skip-sell 保留双边仓位。
4. LLM 模型敏感：对冲发现效果依赖模型选择，部分模型会产生虚假关联或格式错误。

适合的目标群体

• 量化交易者与 DeFi 高级用户，熟悉链上操作和私钥管理
• 需要自动化 Polymarket 策略执行的研究员和交易员
• 寻求跨市场套利/对冲机会的专业投资者

使用风险

• 资金风险：涉及真实加密货币交易，智能合约漏洞、市场波动均可导致损失
• 网络依赖：Polygon 节点、Polymarket API、OpenRouter 任一服务中断将影响功能
• 代理成本：稳定交易需持续付费的住宅代理服务
• 授权管理：首次使用需提交 6 笔授权交易，gas 成本约 0.01 POL

核心用法

PolyClaw 是一款面向 OpenClaw 的 Polymarket 预测市场交易 Skill，提供从市场浏览到对冲策略发现的全链路功能。

主要功能模块：

• 市场浏览：通过 markets trending/search 查看热门或搜索特定主题市场，支持 JSON 输出便于程序化处理
• 钱包管理：基于 POLYCLAW_PRIVATE_KEY 环境变量的钱包配置，首次使用需执行 wallet approve 完成 6 笔合约授权
• 交易执行：采用"拆分+订单簿"机制——将 USDC.e 拆分为 YES/NO 双币后通过 CLOB 卖出不需要的一方，实现低成本建仓
• 持仓追踪：实时显示入场价、现价与盈亏计算
• 对冲发现：利用 LLM（默认 nvidia/nemotron-nano-9b-v2）分析市场间的逻辑蕴含关系，识别 Tier 1-4 级别的覆盖组合

典型交易示例：
以 $0.70 买入 YES 时，系统拆分 $100 → 100 YES + 100 NO，以 ~$0.30 卖出 NO 回收 ~$27，实际成本约 $73（入场价 $0.73）。

显著优点

1. 执行效率：拆分+CLOB 机制相比直接交易可降低滑点成本
2. 智能对冲：业界罕见的 LLM 驱动逻辑蕴含分析，可发现跨市场套利机会
3. 代理友好：内置 IP 轮换重试机制应对 Cloudflare 拦截，适配自动化场景
4. 代码质量：18 文件 3299 行代码，结构清晰（lib/业务逻辑、scripts/CLI），无危险函数、无混淆、无硬编码密钥

潜在缺点与局限性

• 私钥存储：MVP 阶段采用环境变量存储私钥，存在进程泄露/Shell 历史风险，需配合"小额资金+定期转出"策略
• Cloudflare 依赖：CLOB 卖出步骤可能因 IP 被阻失败，虽提供 --skip-sell 兜底，但增加手动操作成本
• 流动性风险：低流动性市场可能无法完成对冲卖出
• LLM 可靠性：不同模型对相关性判断差异显著，DeepSeek R1 存在输出格式问题

适合人群

• 熟悉 DeFi 与预测市场、接受环境变量私钥风险的活跃交易者
• 需要自动化 Polymarket 策略的量化用户
• 寻求跨市场对冲组合的套利型玩家

常规风险

• 资金风险：智能合约漏洞、市场清算风险、Polymarket 平台风险
• 操作风险：私钥环境变量泄露、代理配置不当导致 IP 封禁
• 合规风险：预测市场在某些司法管辖区受限，需自行确认合法性
• 技术风险：Polygon 网络拥堵、CLOB API 变更、依赖库安全更新滞后