{ "schemaVersion": "1.0", "item": { "slug": "polyclaw-pro", "name": "PolyClaw Pro", "source": "tencent", "type": "skill", "category": "金融交易", "sourceUrl": "https://clawhub.ai/lmanchu/polyclaw-pro", "canonicalUrl": "https://clawhub.ai/lmanchu/polyclaw-pro", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/polyclaw-pro", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polyclaw-pro", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", "auto_redeem_check.py", "check_books.py", "check_positions.py", "discipline_scanner.py" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/polyclaw-pro" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/polyclaw-pro", "agentPageUrl": "https://openagent3.xyz/skills/polyclaw-pro/agent", "manifestUrl": "https://openagent3.xyz/skills/polyclaw-pro/agent.json", "briefUrl": "https://openagent3.xyz/skills/polyclaw-pro/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "PolyClaw", "body": "Trading-enabled Polymarket skill for OpenClaw. Browse markets, manage wallets, execute trades, and track positions." }, { "title": "Features", "body": "Market Browsing - Search and browse Polymarket prediction markets\nWallet Management - Env-var based wallet configuration\nTrading - Buy YES/NO positions via split + CLOB execution\nPosition Tracking - Track entry prices, current prices, and P&L\nHedge Discovery - LLM-powered covering portfolio discovery via logical implications" }, { "title": "Quick Start", "body": "First, install dependencies (from skill directory):\n\ncd {baseDir}\nuv sync" }, { "title": "First-Time Setup (Required for Trading)", "body": "Before your first trade, set Polymarket contract approvals (one-time, costs ~0.01 POL in gas):\n\nuv run python scripts/polyclaw.py wallet approve\n\nThis submits 6 approval transactions to Polygon. You only need to do this once per wallet." }, { "title": "Browse Markets", "body": "# Trending markets by volume\nuv run python scripts/polyclaw.py markets trending\n\n# Search markets\nuv run python scripts/polyclaw.py markets search \"election\"\n\n# Market details (returns full JSON with all fields)\nuv run python scripts/polyclaw.py market \n\nOutput options:\n\nDefault output is a formatted table (good for display)\nUse --full flag for full question text without truncation\nUse --json flag via scripts/markets.py --json trending for structured JSON output" }, { "title": "Wallet Management", "body": "# Check wallet status (address, balances)\nuv run python scripts/polyclaw.py wallet status\n\n# Set contract approvals (one-time)\nuv run python scripts/polyclaw.py wallet approve\n\nThe wallet is configured via the POLYCLAW_PRIVATE_KEY environment variable." }, { "title": "Trading", "body": "# Buy YES position for $50\nuv run python scripts/polyclaw.py buy YES 50\n\n# Buy NO position for $25\nuv run python scripts/polyclaw.py buy NO 25" }, { "title": "Positions", "body": "# List all positions with P&L\nuv run python scripts/polyclaw.py positions" }, { "title": "Hedge Discovery", "body": "Find covering portfolios - pairs of market positions that hedge each other via contrapositive logic.\n\n# Scan trending markets for hedges\nuv run python scripts/polyclaw.py hedge scan\n\n# Scan markets matching a query\nuv run python scripts/polyclaw.py hedge scan --query \"election\"\n\n# Analyze specific markets for hedging relationship\nuv run python scripts/polyclaw.py hedge analyze \n\nOutput options:\n\nDefault output is a formatted table showing Tier, Coverage, Cost, Target, and Cover\nUse --json flag for structured JSON output\nUse --min-coverage 0.90 to filter by minimum coverage (default 0.85)\nUse --tier 1 to filter by tier (1=best, default 2)\n\nCoverage tiers:\n\nTier 1 (HIGH): >=95% coverage - near-arbitrage opportunities\nTier 2 (GOOD): 90-95% - strong hedges\nTier 3 (MODERATE): 85-90% - decent but noticeable risk\nTier 4 (LOW): <85% - speculative (filtered by default)\n\nLLM model: Uses nvidia/nemotron-nano-9b-v2:free via OpenRouter. Model selection matters — some models find spurious correlations while others (like DeepSeek R1) have output format issues. Override with --model if needed." }, { "title": "Portfolio Live Tracking", "body": "Real-time position tracking via Polymarket Data API. Groups positions by (slug, outcome) and displays YES/NO side, current value, and P&L with cost basis from portfolio.json.\n\nuv run python portfolio_live.py\n\nFetches live on-chain positions from data-api.polymarket.com\nShows outcome side (YES/NO), current price, and unrealized P&L\nNo web3 dependency — uses REST API only" }, { "title": "Auto Redeem", "body": "Automatically detects and redeems settled (resolved) markets. Checks payoutDenominator on-chain via the CTF contract. When a market resolves, submits a redeemPositions transaction through the NegRiskAdapter.\n\n# Manual run\ncd {baseDir} && source .env && .venv/bin/python3 auto_redeem_check.py\n\n# Cron (every 15 minutes)\n*/15 * * * * cd /path/to/polyclaw && source .env && .venv/bin/python3 auto_redeem_check.py >> /var/log/polyclaw-redeem.log 2>&1\n\nRequires web3 (use .venv/bin/python3, not system python)\nTracks redeemed positions in redeem_state.json to avoid duplicates\nNeeds CHAINSTACK_NODE and POLYCLAW_PRIVATE_KEY env vars" }, { "title": "Discipline Scanner", "body": "Automated take-profit scanner. Sells positions that are up 20%+ with slippage protection. Configurable via cfo_params.json (DISCIPLINE_TP_PCT key).\n\n# Manual run\ncd {baseDir} && export $(grep -v \"^#\" .env | xargs) && .venv/bin/python3 discipline_scanner.py\n\n# Cron (every 30 minutes)\n*/30 * * * * cd /path/to/polyclaw && export $(grep -v \"^#\" .env | xargs) && .venv/bin/python3 discipline_scanner.py >> /var/log/polyclaw-discipline.log 2>&1\n\nSkips positions worth less than $1\nTake-profit threshold defaults to 20% (configurable)" }, { "title": "Enhanced API (polyclaw_api.py)", "body": "CLI bridge for external integrations (e.g., Wells TG Bot via SSH). Provides structured JSON output for programmatic use.\n\npython3 polyclaw_api.py portfolio # All open positions with live prices (JSON)\npython3 polyclaw_api.py summary # Text summary of portfolio\npython3 polyclaw_api.py balance # CLOB + on-chain wallet balance\npython3 polyclaw_api.py risk # Current risk rules\npython3 polyclaw_api.py risk_check # Pre-trade risk check\npython3 polyclaw_api.py swap auto # Swap all non-USDC.e to USDC.e\npython3 polyclaw_api.py swap status # Show token balances\n\nportfolio is the recommended command for live position data (reads Data API, not local DB)\nbalance requires web3 — use .venv/bin/python3\nsummary reads local DB and can be stale — prefer portfolio for accuracy" }, { "title": "Security", "body": "For the MVP, the private key is stored in an environment variable for simplicity and Claude Code compatibility.\n\nSecurity Warning: Keep only small amounts in this wallet. Withdraw regularly to a secure wallet." }, { "title": "Environment Variables", "body": "VariableRequiredDescriptionCHAINSTACK_NODEYes (trading)Polygon RPC URLOPENROUTER_API_KEYYes (hedge)OpenRouter API key for LLM hedge discoveryPOLYCLAW_PRIVATE_KEYYes (trading)EVM private key (hex, with or without 0x prefix)HTTPS_PROXYRecommendedRotating residential proxy for CLOB (e.g., IPRoyal)CLOB_MAX_RETRIESNoMax CLOB retries with IP rotation (default: 5)\n\nSecurity Warning: Keep only small amounts in this wallet. Withdraw regularly to a secure wallet. The private key in an env var is convenient for automation but less secure than encrypted storage." }, { "title": "Trading Flow", "body": "Split Position - USDC.e is split into YES + NO tokens via CTF contract\nSell Unwanted - The unwanted side is sold via CLOB order book\nResult - You hold the wanted position, recovered partial cost from selling unwanted\n\nExample: Buy YES at $0.70\n\nSplit $100 USDC.e → 100 YES + 100 NO tokens\nSell 100 NO tokens at ~$0.30 → recover ~$27 USDC.e\nNet cost: ~$73 for 100 YES tokens (entry: $0.73)" }, { "title": "Polymarket Contracts (Polygon Mainnet)", "body": "USDC.e: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174\nCTF (Conditional Tokens): 0x4D97DCd97eC945f40cF65F87097ACe5EA0476045\nCTF Exchange: 0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E" }, { "title": "Dependencies", "body": "Install with uv (from skill directory):\n\ncd {baseDir}\nuv sync" }, { "title": "Limitations", "body": "Trading requires wallet approval setup (one-time)\nCLOB sells may fail if liquidity is insufficient" }, { "title": "CLOB Cloudflare Blocking", "body": "Polymarket's CLOB API uses Cloudflare protection that blocks POST requests from many IPs, including datacenter IPs and some residential ISPs. This affects the \"sell unwanted tokens\" step.\n\nSolution: Residential proxy with retry logic\n\nThe recommended setup uses a rotating residential proxy (e.g., IPRoyal, BrightData). The CLOB client automatically retries with new IPs until one works:\n\nexport HTTPS_PROXY=\"http://user:pass@geo.iproyal.com:12321\"\nexport CLOB_MAX_RETRIES=10 # Default is 5\n\nWith this setup, CLOB orders typically succeed within 5-10 retries as the proxy rotates through IPs until finding an unblocked one.\n\nAlternative workarounds:\n\nUse --skip-sell — Keep both YES and NO tokens, sell manually on polymarket.com\nNo proxy — Split still works; only CLOB sell is affected\n\nIf CLOB fails after all retries, your split still succeeded. The output tells you how many tokens to sell manually." }, { "title": "\"No wallet available\"", "body": "Set the POLYCLAW_PRIVATE_KEY environment variable:\n\nexport POLYCLAW_PRIVATE_KEY=\"0x...\"" }, { "title": "\"Insufficient USDC.e\"", "body": "Check balance with uv run python scripts/polyclaw.py wallet status. You need USDC.e (bridged USDC) on Polygon." }, { "title": "\"CLOB order failed\"", "body": "The CLOB sell may fail due to:\n\nInsufficient liquidity at the sell price\nIP blocked by Cloudflare (try proxy)\n\nYour split still succeeded - you have the tokens, just couldn't sell unwanted side." }, { "title": "\"Approvals not set\"", "body": "First trade requires contract approvals. Run:\n\nuv run python scripts/polyclaw.py wallet approve" }, { "title": "License", "body": "MIT" } ], "body": "PolyClaw\n\nTrading-enabled Polymarket skill for OpenClaw. Browse markets, manage wallets, execute trades, and track positions.\n\nFeatures\nMarket Browsing - Search and browse Polymarket prediction markets\nWallet Management - Env-var based wallet configuration\nTrading - Buy YES/NO positions via split + CLOB execution\nPosition Tracking - Track entry prices, current prices, and P&L\nHedge Discovery - LLM-powered covering portfolio discovery via logical implications\nQuick Start\n\nFirst, install dependencies (from skill directory):\n\ncd {baseDir}\nuv sync\n\nFirst-Time Setup (Required for Trading)\n\nBefore your first trade, set Polymarket contract approvals (one-time, costs ~0.01 POL in gas):\n\nuv run python scripts/polyclaw.py wallet approve\n\n\nThis submits 6 approval transactions to Polygon. You only need to do this once per wallet.\n\nBrowse Markets\n# Trending markets by volume\nuv run python scripts/polyclaw.py markets trending\n\n# Search markets\nuv run python scripts/polyclaw.py markets search \"election\"\n\n# Market details (returns full JSON with all fields)\nuv run python scripts/polyclaw.py market \n\n\nOutput options:\n\nDefault output is a formatted table (good for display)\nUse --full flag for full question text without truncation\nUse --json flag via scripts/markets.py --json trending for structured JSON output\nWallet Management\n# Check wallet status (address, balances)\nuv run python scripts/polyclaw.py wallet status\n\n# Set contract approvals (one-time)\nuv run python scripts/polyclaw.py wallet approve\n\n\nThe wallet is configured via the POLYCLAW_PRIVATE_KEY environment variable.\n\nTrading\n# Buy YES position for $50\nuv run python scripts/polyclaw.py buy YES 50\n\n# Buy NO position for $25\nuv run python scripts/polyclaw.py buy NO 25\n\nPositions\n# List all positions with P&L\nuv run python scripts/polyclaw.py positions\n\nHedge Discovery\n\nFind covering portfolios - pairs of market positions that hedge each other via contrapositive logic.\n\n# Scan trending markets for hedges\nuv run python scripts/polyclaw.py hedge scan\n\n# Scan markets matching a query\nuv run python scripts/polyclaw.py hedge scan --query \"election\"\n\n# Analyze specific markets for hedging relationship\nuv run python scripts/polyclaw.py hedge analyze \n\n\nOutput options:\n\nDefault output is a formatted table showing Tier, Coverage, Cost, Target, and Cover\nUse --json flag for structured JSON output\nUse --min-coverage 0.90 to filter by minimum coverage (default 0.85)\nUse --tier 1 to filter by tier (1=best, default 2)\n\nCoverage tiers:\n\nTier 1 (HIGH): >=95% coverage - near-arbitrage opportunities\nTier 2 (GOOD): 90-95% - strong hedges\nTier 3 (MODERATE): 85-90% - decent but noticeable risk\nTier 4 (LOW): <85% - speculative (filtered by default)\n\nLLM model: Uses nvidia/nemotron-nano-9b-v2:free via OpenRouter. Model selection matters — some models find spurious correlations while others (like DeepSeek R1) have output format issues. Override with --model if needed.\n\nAutomation Tools\nPortfolio Live Tracking\n\nReal-time position tracking via Polymarket Data API. Groups positions by (slug, outcome) and displays YES/NO side, current value, and P&L with cost basis from portfolio.json.\n\nuv run python portfolio_live.py\n\nFetches live on-chain positions from data-api.polymarket.com\nShows outcome side (YES/NO), current price, and unrealized P&L\nNo web3 dependency — uses REST API only\nAuto Redeem\n\nAutomatically detects and redeems settled (resolved) markets. Checks payoutDenominator on-chain via the CTF contract. When a market resolves, submits a redeemPositions transaction through the NegRiskAdapter.\n\n# Manual run\ncd {baseDir} && source .env && .venv/bin/python3 auto_redeem_check.py\n\n# Cron (every 15 minutes)\n*/15 * * * * cd /path/to/polyclaw && source .env && .venv/bin/python3 auto_redeem_check.py >> /var/log/polyclaw-redeem.log 2>&1\n\nRequires web3 (use .venv/bin/python3, not system python)\nTracks redeemed positions in redeem_state.json to avoid duplicates\nNeeds CHAINSTACK_NODE and POLYCLAW_PRIVATE_KEY env vars\nDiscipline Scanner\n\nAutomated take-profit scanner. Sells positions that are up 20%+ with slippage protection. Configurable via cfo_params.json (DISCIPLINE_TP_PCT key).\n\n# Manual run\ncd {baseDir} && export $(grep -v \"^#\" .env | xargs) && .venv/bin/python3 discipline_scanner.py\n\n# Cron (every 30 minutes)\n*/30 * * * * cd /path/to/polyclaw && export $(grep -v \"^#\" .env | xargs) && .venv/bin/python3 discipline_scanner.py >> /var/log/polyclaw-discipline.log 2>&1\n\nSkips positions worth less than $1\nTake-profit threshold defaults to 20% (configurable)\nEnhanced API (polyclaw_api.py)\n\nCLI bridge for external integrations (e.g., Wells TG Bot via SSH). Provides structured JSON output for programmatic use.\n\npython3 polyclaw_api.py portfolio # All open positions with live prices (JSON)\npython3 polyclaw_api.py summary # Text summary of portfolio\npython3 polyclaw_api.py balance # CLOB + on-chain wallet balance\npython3 polyclaw_api.py risk # Current risk rules\npython3 polyclaw_api.py risk_check # Pre-trade risk check\npython3 polyclaw_api.py swap auto # Swap all non-USDC.e to USDC.e\npython3 polyclaw_api.py swap status # Show token balances\n\nportfolio is the recommended command for live position data (reads Data API, not local DB)\nbalance requires web3 — use .venv/bin/python3\nsummary reads local DB and can be stale — prefer portfolio for accuracy\nSecurity\n\nFor the MVP, the private key is stored in an environment variable for simplicity and Claude Code compatibility.\n\nSecurity Warning: Keep only small amounts in this wallet. Withdraw regularly to a secure wallet.\n\nEnvironment Variables\nVariable\tRequired\tDescription\nCHAINSTACK_NODE\tYes (trading)\tPolygon RPC URL\nOPENROUTER_API_KEY\tYes (hedge)\tOpenRouter API key for LLM hedge discovery\nPOLYCLAW_PRIVATE_KEY\tYes (trading)\tEVM private key (hex, with or without 0x prefix)\nHTTPS_PROXY\tRecommended\tRotating residential proxy for CLOB (e.g., IPRoyal)\nCLOB_MAX_RETRIES\tNo\tMax CLOB retries with IP rotation (default: 5)\n\nSecurity Warning: Keep only small amounts in this wallet. Withdraw regularly to a secure wallet. The private key in an env var is convenient for automation but less secure than encrypted storage.\n\nTrading Flow\nSplit Position - USDC.e is split into YES + NO tokens via CTF contract\nSell Unwanted - The unwanted side is sold via CLOB order book\nResult - You hold the wanted position, recovered partial cost from selling unwanted\n\nExample: Buy YES at $0.70\n\nSplit $100 USDC.e → 100 YES + 100 NO tokens\nSell 100 NO tokens at ~$0.30 → recover ~$27 USDC.e\nNet cost: ~$73 for 100 YES tokens (entry: $0.73)\nPolymarket Contracts (Polygon Mainnet)\nUSDC.e: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174\nCTF (Conditional Tokens): 0x4D97DCd97eC945f40cF65F87097ACe5EA0476045\nCTF Exchange: 0x4bFb41d5B3570DeFd03C39a9A4D8dE6Bd8B8982E\nDependencies\n\nInstall with uv (from skill directory):\n\ncd {baseDir}\nuv sync\n\nLimitations\nTrading requires wallet approval setup (one-time)\nCLOB sells may fail if liquidity is insufficient\nCLOB Cloudflare Blocking\n\nPolymarket's CLOB API uses Cloudflare protection that blocks POST requests from many IPs, including datacenter IPs and some residential ISPs. This affects the \"sell unwanted tokens\" step.\n\nSolution: Residential proxy with retry logic\n\nThe recommended setup uses a rotating residential proxy (e.g., IPRoyal, BrightData). The CLOB client automatically retries with new IPs until one works:\n\nexport HTTPS_PROXY=\"http://user:pass@geo.iproyal.com:12321\"\nexport CLOB_MAX_RETRIES=10 # Default is 5\n\n\nWith this setup, CLOB orders typically succeed within 5-10 retries as the proxy rotates through IPs until finding an unblocked one.\n\nAlternative workarounds:\n\nUse --skip-sell — Keep both YES and NO tokens, sell manually on polymarket.com\nNo proxy — Split still works; only CLOB sell is affected\n\nIf CLOB fails after all retries, your split still succeeded. The output tells you how many tokens to sell manually.\n\nTroubleshooting\n\"No wallet available\"\n\nSet the POLYCLAW_PRIVATE_KEY environment variable:\n\nexport POLYCLAW_PRIVATE_KEY=\"0x...\"\n\n\"Insufficient USDC.e\"\n\nCheck balance with uv run python scripts/polyclaw.py wallet status. You need USDC.e (bridged USDC) on Polygon.\n\n\"CLOB order failed\"\n\nThe CLOB sell may fail due to:\n\nInsufficient liquidity at the sell price\nIP blocked by Cloudflare (try proxy)\n\nYour split still succeeded - you have the tokens, just couldn't sell unwanted side.\n\n\"Approvals not set\"\n\nFirst trade requires contract approvals. Run:\n\nuv run python scripts/polyclaw.py wallet approve\n\nLicense\n\nMIT" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/lmanchu/polyclaw-pro", "publisherUrl": "https://clawhub.ai/lmanchu/polyclaw-pro", "owner": "lmanchu", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/polyclaw-pro", "downloadUrl": "https://openagent3.xyz/downloads/polyclaw-pro", "agentUrl": "https://openagent3.xyz/skills/polyclaw-pro/agent", "manifestUrl": "https://openagent3.xyz/skills/polyclaw-pro/agent.json", "briefUrl": "https://openagent3.xyz/skills/polyclaw-pro/agent.md" } }