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 进行兑换。
