PolyClaw is a professional-grade trading suite for Polymarket that enables automated execution, LLM-powered hedge discovery, and real-time portfolio management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install polyclaw-pro
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install polyclaw-pro using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is PolyClaw?
PolyClaw is a specialized toolset designed for the Openclaw Skills ecosystem to streamline interactions with Polymarket, the world's largest prediction market. It provides a bridge between high-level AI analysis and low-level Web3 execution on the Polygon network. The skill allows developers and traders to move beyond manual betting by providing programmatic access to market browsing, wallet management, and sophisticated trading mechanics like position splitting and order book execution.
By leveraging Openclaw Skills integration, PolyClaw empowers users to automate the entire lifecycle of a prediction market position. From initial discovery via trending lists to automated take-profit scanning and final redemption of settled markets, it transforms Polymarket into a programmable financial layer. The inclusion of LLM-powered hedge discovery allows users to identify complex logical correlations between markets that aren't immediately obvious to human traders.
PolyClaw Use Cases
- Programmatic trading of YES/NO outcomes on Polymarket using split-and-sell execution logic.
- Automated hedging by using AI to identify markets with contrapositive logical implications.
- Running a headless portfolio monitor that tracks real-time P&L and cost basis for all active positions.
- Implementing a set-and-forget strategy for redeeming funds from resolved markets using cron-based automation.
- Executing disciplined take-profit orders automatically when specific price targets are met.
How PolyClaw Works
- The user or agent searches for specific prediction markets or identifies trending opportunities via the CLI.
- When a trade is initiated, the system performs a Split Position transaction on-chain, converting USDC.e into a pair of conditional tokens.
- To achieve the desired position, the skill automatically attempts to sell the unwanted side of the split via the Polymarket Central Limit Order Book (CLOB).
- A local database tracks the entry price and cost basis, while the live Data API provides real-time market valuations.
- Automation scripts continuously monitor the wallet for settled markets to trigger redemption or for profit-taking opportunities based on user-defined parameters.
PolyClaw Setup
To begin using this skill within the Openclaw Skills framework, follow these steps:
# Navigate to the skill directory and install dependencies
cd polyclaw
uv sync
# Set required environment variables
export POLYCLAW_PRIVATE_KEY="your_evm_private_key"
export CHAINSTACK_NODE="your_polygon_rpc_url"
export OPENROUTER_API_KEY="your_api_key_for_llm_hedging"
# Initialize contract approvals for the first time
uv run python scripts/polyclaw.py wallet approve
PolyClaw Data Schema & Taxonomy
PolyClaw organizes its trading and automation data through several structured files and API integrations:
| File Name | Purpose |
|---|---|
portfolio.json |
Maintains local records of cost basis, entry timestamps, and position IDs. |
redeem_state.json |
Persistent log of processed redemptions to ensure each settled market is only claimed once. |
cfo_params.json |
Stores configuration for the Discipline Scanner, including take-profit percentages. |
Polymarket Data API |
Used for real-time price discovery and current market state without requiring on-chain calls. |
CTF Contracts |
Direct interaction with Conditional Token Framework contracts for splitting and merging positions. |
PolyClaw Advanced Features
- LLM-Powered Hedge Discovery: Uses advanced models to scan markets for logical hedges (e.g., finding if Market A implies the inverse of Market B).
- Automated Discipline Scanner: A background worker that monitors positions and automatically sells when profit targets (e.g., +20%) are reached.
- Residential Proxy Support: Built-in support for rotating proxies to handle Cloudflare-protected CLOB API requests for high-frequency execution.
- Auto-Redeem Worker: A cron-compatible script that identifies settled markets and claims payouts automatically to maintain liquidity.
- CLI Bridge: A dedicated
polyclaw_api.pyscript that provides structured JSON outputs for easy integration with Telegram bots or custom dashboards.
SKILL.md
Loading
Related Openclaw Skills
PCClaw - Windows-Native AI Agent Skills
A powerful suite of Windows-native capabilities designed to bring the Openclaw Skills ecosystem to the PC.
Omni Research
A powerful multi-source research tool that queries Perplexity, Grok, and Gemini via your browser sessions without requiring individual API keys.
Humanizer
A specialized writing editor that identifies and strips away 24 common AI writing patterns to make text sound authentically human.
Contract Review
An AI-powered legal analysis tool that reviews contracts for risks, extracts key terms, and suggests redlines based on market standards.
Mail Caduceus
Mail Caduceus is an enterprise-grade automation skill that transforms a single Microsoft 365 mailbox into a multi-lane identity control plane using Cloudflare DNS.
MailCaduceus
MailCaduceus transforms a single Microsoft 365 mailbox and domain into an enterprise-grade communications control plane.
Featured*
