polyclawster-agent

Category: Tools & Productivity | Uploader: al1enjesus | Downloads: 0 | Version: v1.0（Latest）

Trade on Polymarket prediction markets. Non-custodial — your agent generates a Polygon wallet, signs orders locally, and submits via polyclawster.com relay (geo-bypass). Private key never leaves your machine. Fund with POL — agent auto-swaps to USDC.e.

Changelog: Source: GitHub https://github.com/al1enjesus/polyclawster

Directory Structure

Current level: Root

📁 scripts/
- 📄 approve.js 7.7 KB
- 📄 auto.js 5.5 KB
- 📄 balance.js 3.8 KB
- 📄 batch-monitor.js 3.8 KB
- 📄 browse.js 4.4 KB
- 📄 hourly-status.js 1.5 KB
- 📄 link.js 1.2 KB
- 📄 monitor.js 3.0 KB
- 📄 news-dryrun-cron.js 3.3 KB
- 📄 record-external.js 8.1 KB
- 📄 sell.js 7.2 KB
- 📄 setup.js 14.2 KB
- 📄 strategy-card.js 4.2 KB
- 📄 swap.js 6.0 KB
- 📄 trade.js 13.6 KB
- 📄 whale-monitor.js 2.7 KB
📁 skills/
- 📁 polyclawster-agent/
  - 📁 .clawhub/
    
    📄 origin.json 150 B
  - 📁 scripts/
    
    📄 approve.js 5.9 KB
    
    📄 auto.js 7.1 KB
    
    📄 balance.js 2.4 KB
    
    📄 browse.js 5.3 KB
    
    📄 link.js 2.1 KB
    
    📄 monitor.js 3.7 KB
    
    📄 sell.js 8.6 KB
    
    📄 setup.js 13.7 KB
    
    📄 swap.js 6.0 KB
    
    📄 trade.js 17.6 KB
  - 📄 .gitignore 19 B
  - 📄 _meta.json 137 B
  - 📄 CHANGELOG.md 609 B
  - 📄 package-lock.json 49.4 KB
  - 📄 package.json 1.0 KB
  - 📄 README.md 6.8 KB
  - 📄 SECURITY.md 1.1 KB
  - 📄 SKILL.md 6.0 KB
📄 .clawhubignore 596 B
📄 .env.example 262 B
📄 .gitignore 1.2 KB
📄 EXTERNAL_AGENT_PROTOCOL.md 5.7 KB
📄 package-lock.json 44.9 KB
📄 package.json 1.1 KB
📄 README.md 8.3 KB
📄 SECURITY.md 1.1 KB
📄 SKILL.md 4.6 KB

SKILL.md

---
name: polyclawster-agent
description: Trade on Polymarket prediction markets. Non-custodial — your agent generates a Polygon wallet, signs orders locally, and submits via polyclawster.com relay (geo-bypass). Private key never leaves your machine. Fund with POL — agent auto-swaps to USDC.e.
metadata:
  {
    "openclaw": {
      "requires": { "bins": ["node"] },
      "install": [
        {
          "id": "deps",
          "kind": "shell",
          "command": "cd {{skillDir}} && npm install --production",
          "label": "Install npm dependencies (ethers, @polymarket/clob-client)"
        }
      ],
      "permissions": {
        "network": [
          "polyclawster.com",
          "polygon-bor-rpc.publicnode.com",
          "clob.polymarket.com",
          "gamma-api.polymarket.com"
        ],
        "fs": {
          "write": ["~/.polyclawster/config.json"],
          "read":  ["~/.polyclawster/config.json"]
        }
      }
    }
  }
---

# polyclawster-agent

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

## User experience

This skill is designed for conversational use. When a user asks to trade, the agent runs the appropriate script and reports results naturally.

For example, if a user says "Bet $5 on Bitcoin above 100k", the agent runs the trade script and responds with the outcome — the trade details, price, and confirmation. Users can always ask for more technical details if they want them.

The agent should share the wallet address when the user needs to fund it, and explain any errors in clear terms.

## Setup flow

When a user wants to start trading Polymarket:

1. Run `setup.js --auto` — creates a local Polygon wallet and registers the agent on polyclawster.com
2. Share the wallet address — the user sends POL (Polygon native token) to fund it
3. Once funded, the agent can place trades

Config is stored in `~/.polyclawster/config.json` (private key, CLOB API credentials).

## Scripts reference

All scripts are in the `scripts/` directory. Run with `node scripts/<name>.js`.

| Script | Purpose | Key flags |
|--------|---------|-----------|
| `setup.js` | Create wallet + register agent | `--auto`, `--info`, `--derive-clob` |
| `balance.js` | Check POL, USDC.e, and CLOB balances | — |
| `swap.js` | Convert POL or native USDC → USDC.e | `--pol N`, `--usdc N`, `--check` |
| `approve.js` | One-time Polymarket contract approvals | `--check` (read-only) |
| `browse.js` | Search markets by topic | Pass search term as argument |
| `trade.js` | Place a bet (live or demo) | `--market`, `--side YES/NO`, `--amount N`, `--demo` |
| `sell.js` | Close a position | `--bet-id N`, `--list` |
| `auto.js` | Autonomous trading on AI signals | `--demo`, `--min-score N`, `--max-bet N`, `--dry-run` |
| `link.js` | Link agent to Telegram Mini App | Pass claim code as argument |

## Live trading

`trade.js` handles the full flow automatically before placing a live bet:

1. Checks USDC.e balance
2. Swaps POL → USDC.e if needed (keeps 1 POL for gas)
3. Runs one-time contract approvals if missing
4. Refreshes CLOB balance
5. Places the order (signed locally, submitted via relay)

### About approvals

`approve.js` grants ERC-20 allowance and CTF `setApprovalForAll` to Polymarket exchange contracts. These are standard Polymarket approvals — the same ones the official Polymarket UI requests. You can check approval status with `approve.js --check` before granting, and revoke them on-chain at any time.

## Architecture

- **Wallet**: Polygon EOA generated locally — private key stays on this machine in `~/.polyclawster/config.json`
- **Trading token**: USDC.e (bridged USDC on Polygon, `0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174`)
- **Funding**: user sends POL → agent swaps to USDC.e via Uniswap SwapRouter02
- **Relay**: signed orders go through polyclawster.com (Tokyo) for geo-bypass — the relay never sees the private key
- **Dashboard**: polyclawster.com/a/{agent_id}

## Important notes

- **USDC.e ≠ native USDC** — Polymarket uses bridged USDC.e. If user sends native USDC (`0x3c499...`), use `swap.js` to convert.
- **Demo mode** (`--demo`) uses a free $10 paper balance — recommended for first-time testing.
- All orders are signed locally with EIP-712 + HMAC. The relay forwards signed payloads without access to keys.
- **Start small** — fund with a small amount of POL first to verify everything works.

## 📱 Not using OpenClaw? Trade via Telegram

Don't have an AI agent? Use the Telegram Mini App instead — same markets, same signals, no coding needed.

👉 [@PolyClawsterBot](https://t.me/PolyClawsterBot/app)

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

polyclawster-agent

Directory Structure

SKILL.md

Report

Notice