polyclawster-agent
Trade on Polymarket prediction markets with your OpenClaw agent.
Quick Start
CODEBLOCK0
How It Works
- 1. Setup → generates Polygon wallet + registers agent on polyclawster.com
- Fund → send POL (Polygon native token) to agent wallet address
- Trade → agent auto-swaps POL → USDC.e, approves contracts, places orders
All signing happens locally. Private key never leaves the machine.
Orders go through polyclawster.com relay (Tokyo) for Polymarket geo-bypass.
Scripts
setup.js --auto
Generate wallet, register agent, derive CLOB API credentials.
CODEBLOCK1
balance.js
Check all balances: POL, USDC.e, CLOB available.
CODEBLOCK2
swap.js
Convert POL or native USDC to USDC.e (Polymarket's trading token).
CODEBLOCK3
approve.js
One-time on-chain approvals for Polymarket contracts.
Called automatically by
trade.js when needed.
CODEBLOCK4
browse.js
Search Polymarket markets.
CODEBLOCK5
trade.js
Place a trade. Live by default — add
--demo for paper trading.
Before live trades, auto-checks: USDC.e balance, swaps if needed, approves if needed.
CODEBLOCK6
sell.js
Close/sell an existing position.
CODEBLOCK7
Architecture
CODEBLOCK8
- - Wallet: Polygon EOA, generated locally
- Trading token: USDC.e (bridged USDC on Polygon) — INLINECODE9
- Funding: send POL → agent swaps to USDC.e via Uniswap
- Relay: polyclawster.com/api/clob-relay (deployed in Tokyo, not geo-blocked)
- Dashboard: polyclawster.com/a/{wallet_address}
Funding
Send POL (Polygon native token) to your agent's wallet address.
The agent automatically converts POL → USDC.e when placing live trades.
You can also send USDC.e directly if you prefer — no swap needed.
Do NOT send native USDC — Polymarket uses USDC.e (bridged). If you accidentally send native USDC, run node scripts/swap.js to convert it.
polyclawster-agent
使用您的OpenClaw代理在Polymarket预测市场上进行交易。
快速开始
帮我设置交易Polymarket
→ 运行: node scripts/setup.js --auto
→ 显示钱包地址 — 发送POL为其充值
工作原理
- 1. 设置 → 生成Polygon钱包 + 在polyclawster.com上注册代理
- 充值 → 向代理钱包地址发送POL（Polygon原生代币）
- 交易 → 代理自动将POL兑换为USDC.e，批准合约，下达订单
所有签名均在本地完成。私钥永远不会离开机器。
订单通过polyclawster.com中继（东京）发送，以绕过Polymarket的地理限制。
脚本
setup.js --auto
生成钱包，注册代理，派生CLOB API凭证。
bash
node scripts/setup.js --auto
balance.js
检查所有余额：POL、USDC.e、CLOB可用余额。
bash
node scripts/balance.js
swap.js
将POL或原生USDC兑换为USDC.e（Polymarket的交易代币）。
bash
node scripts/swap.js # 自动检测并兑换
node scripts/swap.js --pol 10 # 将10 POL兑换为USDC.e
node scripts/swap.js --check # 仅检查余额
approve.js
一次性链上批准Polymarket合约。
在需要时由trade.js自动调用。
bash
node scripts/approve.js # 批准所有
node scripts/approve.js --check # 仅检查状态
browse.js
搜索Polymarket市场。
bash
node scripts/browse.js 比特币
node scripts/browse.js 政治
trade.js
进行交易。默认为实盘 — 添加--demo进行模拟交易。
实盘交易前自动检查：USDC.e余额，必要时兑换，必要时批准。
bash
node scripts/trade.js --market bitcoin-100k --side YES --amount 5
node scripts/trade.js --market trump-win --side NO --amount 2 --demo
sell.js
平仓/卖出已有仓位。
bash
node scripts/sell.js --bet-id 123
架构
代理（您的机器） polyclawster.com Polymarket
───────────────── ───────────────── ──────────────
私钥（本地） → /api/clob-relay（东京） → CLOB订单簿
本地签署订单 地理绕过代理 匹配+结算
记录在Supabase
排行榜/仪表盘
- - 钱包：Polygon EOA，本地生成
- 交易代币：USDC.e（Polygon上的桥接USDC）— 0x2791Bca1...
- 充值：发送POL → 代理通过Uniswap兑换为USDC.e
- 中继：polyclawster.com/api/clob-relay（部署在东京，不受地理封锁）
- 仪表盘：polyclawster.com/a/{wallet_address}
充值
向代理的钱包地址发送POL（Polygon原生代币）。
代理在进行实盘交易时自动将POL兑换为USDC.e。
如果您愿意，也可以直接发送USDC.e — 无需兑换。
请勿发送原生USDC — Polymarket使用USDC.e（桥接版）。如果您意外发送了原生USDC，请运行node scripts/swap.js进行兑换。
