polyclawster-agent

# polyclawster-agent

Trade on [Polymarket](https://polymarket.com) prediction markets with your OpenClaw agent.

## Quick Start

```
"Set me up to trade Polymarket"
→ runs: node scripts/setup.js --auto
→ shows wallet address — send POL to fund it
```

## How It Works

1. **Setup** → generates Polygon wallet + registers agent on polyclawster.com
2. **Fund** → send POL (Polygon native token) to agent wallet address
3. **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.
```bash
node scripts/setup.js --auto
```

### `balance.js`
Check all balances: POL, USDC.e, CLOB available.
```bash
node scripts/balance.js
```

### `swap.js`
Convert POL or native USDC to USDC.e (Polymarket's trading token).
```bash
node scripts/swap.js              # auto-detect and swap
node scripts/swap.js --pol 10     # swap 10 POL → USDC.e
node scripts/swap.js --check      # check balances only
```

### `approve.js`
One-time on-chain approvals for Polymarket contracts.
Called automatically by `trade.js` when needed.
```bash
node scripts/approve.js           # approve all
node scripts/approve.js --check   # check status only
```

### `browse.js`
Search Polymarket markets.
```bash
node scripts/browse.js "bitcoin"
node scripts/browse.js "politics"
```

### `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.
```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`
Close/sell an existing position.
```bash
node scripts/sell.js --bet-id 123
```

## Architecture

```
Agent (your machine)          polyclawster.com           Polym...

<div align="center">

# 🦞 polyclawster-agent

**Your AI agent trades Polymarket. You keep your keys.**

[![npm](https://img.shields.io/npm/v/polyclawster?color=0f172a&style=flat-square)](https://www.npmjs.com/package/polyclawster)
[![ClawHub](https://img.shields.io/badge/clawhub-polyclawster--agent-blue?style=flat-square)](https://clawhub.com/skill/polyclawster-agent)
[![License: MIT](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
[![Polygon](https://img.shields.io/badge/chain-Polygon-8247e5?style=flat-square)](https://polygon.technology)

[Live Dashboard](https://polyclawster.com) · [ClawHub](https://clawhub.com/skill/polyclawster-agent) · [Polymarket](https://polymarket.com)

</div>

---

## What is this?

An OpenClaw skill that lets your AI agent autonomously trade on [Polymarket](https://polymarket.com) prediction markets — with a fully **non-custodial** architecture.

Your agent:
- Generates a Polygon wallet **locally** (`ethers.Wallet.createRandom()`)
- Signs every order **locally** (EIP-712 + HMAC — never sent anywhere)
- Submits via `polyclawster.com/api/clob-relay` (Tokyo, geo-bypass)
- Gets **AI-scored signals** to know when and what to trade
- **Auto-swaps POL → USDC.e** before trading (no manual token management)

`polyclawster.com` never sees your private key. It just proxies signed orders and tracks PnL.

---

## Architecture

```
┌────────────────────────────────────────────┐
│            Your Agent Container            │
│                                            │
│  ethers.Wallet.createRandom()              │
│  ├─ privateKey  ──────────────► stays here │
│  └─ walletAddress ────────────► registered │
│                                            │
│  Fund: Send POL → agent auto-swaps:       │
│  POL → USDC.e (Uniswap SwapRouter02)     │
│                                            │
│  createMarketOrder(tokenId, BUY, $10)     │
│  ├─ EIP-712 signed locally ✅             │
│  └─ HMAC signed locally    ✅...