polyclaw

What This Skill Does

Polyclaw is a powerful trading-enabled skill for OpenClaw designed to facilitate interactions with Polymarket prediction markets. By integrating directly with the Polygon blockchain and Polymarket's Central Limit Order Book (CLOB), this skill empowers users to browse markets, monitor portfolio positions, and execute trades programmatically. Beyond simple execution, Polyclaw features an LLM-powered engine capable of identifying hedging opportunities by analyzing the logical implications between different market outcomes. It automates the complex process of cross-referencing markets to find covering portfolios, providing users with a data-driven approach to risk management in decentralized finance.

Installation

To install Polyclaw, execute the following command within your terminal while running the ClawHub environment:

clawhub install openclaw/skills/skills/akegaviar/polyclaw

Once installed, ensure you are in the skill directory and run uv sync to install the required Python dependencies. Before you can begin trading, you must perform a one-time setup to approve the Polymarket contracts on the Polygon network. This step is mandatory and incurs a small gas fee (approximately 0.01 POL). Use the command: uv run python scripts/polyclaw.py wallet approve. Finally, ensure your environment variable POLYCLAW_PRIVATE_KEY is correctly configured to enable secure transactions.

Use Cases

• Automated Prediction Trading: Rapidly enter or exit positions in YES/NO prediction markets based on current trends or specific news triggers.
• Portfolio Risk Mitigation: Use the hedge discovery tool to identify pairs of market outcomes that offset each other, allowing you to lock in profit or minimize loss exposure.
• Market Analysis: Query trending markets to track global sentiment and use structured JSON output to feed market data into your own custom analytics dashboards.
• Position Monitoring: Track real-time P&L across multiple open positions to make informed decisions on when to close out contracts.

Example Prompts

1. "Polyclaw, search for all active markets related to the upcoming presidential election and tell me which ones are trending by volume."
2. "I want to hedge my existing portfolio; scan the latest trending markets for any tier 1 or tier 2 coverage opportunities that reduce my risk."
3. "Open a $100 YES position on the market with ID 12345 and then give me a summary of my total current P&L."

Tips & Limitations

• Gas Fees: Always ensure your wallet has sufficient POL for transactions. The initial approval step is a one-time cost, but subsequent trades will require ongoing gas coverage.
• Hedge Tiers: Pay attention to the coverage tiers. Tier 1 opportunities provide the highest reliability (>=95% coverage), while Tier 4 is filtered by default due to high speculative risk.
• Data Accuracy: Always verify market IDs before executing trades to avoid buying the wrong outcome. Use the --full flag if you need the complete question text for clarity.
• Security: Since this skill handles private keys via environment variables, ensure your development environment is secure and that your keys are never committed to version control.