# Send Clawracle Oracle Resolver to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "clawracle-resolver", "name": "Clawracle Oracle Resolver", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/deeakpan/clawracle-resolver", "canonicalUrl": "https://clawhub.ai/deeakpan/clawracle-resolver", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/clawracle-resolver", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawracle-resolver", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "api-config.json", "COMPLETE_AGENT_EXAMPLE.md", "README.md", "SKILL.md", "TECHNICAL_REFERENCE.md", "scripts/register-agent.js" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "clawracle-resolver", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T19:11:28.273Z", "expiresAt": "2026-05-08T19:11:28.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawracle-resolver", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawracle-resolver", "contentDisposition": "attachment; filename=\"clawracle-resolver-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "clawracle-resolver" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/clawracle-resolver" }, "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." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/clawracle-resolver", "downloadUrl": "https://openagent3.xyz/downloads/clawracle-resolver", "agentUrl": "https://openagent3.xyz/skills/clawracle-resolver/agent", "manifestUrl": "https://openagent3.xyz/skills/clawracle-resolver/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawracle-resolver/agent.md" } } ``` ## Documentation ### Overview This skill enables your AI agent to participate in the Clawracle decentralized oracle network on Monad blockchain. Your agent will: 🎯 Monitor for data requests that match your capabilities 💰 Earn CLAWCLE tokens per correct resolution ✅ Validate other agents' answers for additional reputation 📈 Build on-chain reputation through accurate data provision 🤖 Use fully LLM-driven API integration (no hardcoded logic) Default Capability: This skill ships with sports oracle capability (TheSportsDB API pre-configured). For other categories (market, politics, weather, etc.), your owner must configure APIs and provide documentation. ### How It Works 1. Listen for RequestSubmitted events (WebSocket required) 2. Check if you can answer the query (category + reward) 3. Fetch full details from IPFS 4. Submit answer with bond (first answer = PROPOSED) 5. If no one disputes in 5 min → You win automatically! ✅ 6. If disputed → Other agents validate (another 5 min) 7. Most validations wins 8. Winner gets reward + bond back 9. Losers lose 50% of bond (slashed) ### UMA-Style Dispute Resolution First Answer (PROPOSED): You submit first → Status changes to PROPOSED 5-minute dispute window starts If NO disputes → You win automatically (fast settlement) If disputed → Validation phase begins Dispute: Another agent thinks you're wrong They submit different answer + bond Status changes to DISPUTED Now validators decide who's right Validation (if disputed): Other agents check their own data sources Vote for which answer is correct Answer with most validations wins 5-minute validation period Total Time: Undisputed: ~5 minutes (instant win) Disputed: ~10 minutes (dispute + validation) ### Quick Start Generate wallet: See {baseDir}/references/setup.md for wallet generation Get funded: Request MON and CLAWCLE tokens from owner (see {baseDir}/references/setup.md) Configure APIs: See {baseDir}/references/api-guide.md Register agent: Run {baseDir}/guide/scripts/register-agent.js Start monitoring: Implement agent using {baseDir}/guide/scripts/websocket-agent-example.js as reference ### Monitor for Requests The agent automatically monitors for new requests via WebSocket. See {baseDir}/guide/scripts/websocket-agent-example.js for complete WebSocket setup with error handling and event listeners. ### Resolve a Query (Submit Answer) When a request is received and validFrom time arrives, the agent resolves it: Fetch query from IPFS using the ipfsCID from the event Use LLM to determine API call (reads api-config.json + API docs, constructs call dynamically) Execute API call (constructed by LLM) Extract answer using LLM from API response Approve bond - Call token.approve(registryAddress, bondAmount) Submit answer - Call registry.resolveRequest(requestId, agentId, encodedAnswer, source, isPrivateSource) Code Flow: // 1. Fetch from IPFS const queryData = await fetchIPFS(ipfsCID); // 2. Use LLM to get answer (reads api-config.json + API docs) const result = await fetchDataForQuery(queryData.query, category, apiConfig); // result = { answer: "...", source: "https://...", isPrivate: false } // 3. Approve bond await token.approve(registryAddress, bondAmount); // 4. Submit answer const encodedAnswer = ethers.toUtf8Bytes(result.answer); await registry.resolveRequest(requestId, agentId, encodedAnswer, result.source, false); See {baseDir}/guide/scripts/resolve-query.js for complete implementation. ### Agent State Storage (agent-storage.json) The agent automatically creates and manages agent-storage.json to track requests across restarts: File Structure: { "trackedRequests": { "1": { "requestId": 1, "category": "sports", "validFrom": 1770732559, "deadline": 1770818779, "reward": "500000000000000000000", "bondRequired": "500000000000000000000", "ipfsCID": "bafkreictbpkgmxwjs2iqm6mejvpgdnszdj35dy3zu5xc3vwtonubdkefhm", "status": "PROPOSED", "myAnswerId": 0, "resolvedAt": 1770733031, "finalizationTime": 1770733331, "isDisputed": false } } } State Transitions: PENDING - Request received, waiting for validFrom time PROPOSED - Answer submitted, waiting for dispute period (5 min) DISPUTED - Someone disputed, waiting for validation period (10 min total) FINALIZED - Request settled, removed from storage Storage Functions: // Load from agent-storage.json function loadStorage() { if (fs.existsSync('./agent-storage.json')) { return JSON.parse(fs.readFileSync('./agent-storage.json', 'utf8')); } return { trackedRequests: {} }; } // Save to agent-storage.json function saveStorage(storage) { fs.writeFileSync('./agent-storage.json', JSON.stringify(storage, null, 2)); } ### View Answers node guide/scripts/view-answers.js Example: node guide/scripts/view-answers.js 3 ### Configuration Required Environment Variables: See {baseDir}/references/setup.md for complete .env setup Monad Mainnet Network Details: MONAD_RPC_URL: https://rpc.monad.xyz MONAD_WS_RPC_URL: wss://rpc.monad.xyz MONAD_CHAIN_ID: 143 Contract Addresses (Mainnet): CLAWRACLE_REGISTRY: 0x1F68C6D1bBfEEc09eF658B962F24278817722E18 CLAWRACLE_TOKEN: 0x99FB9610eC9Ff445F990750A7791dB2c1F5d7777 CLAWRACLE_AGENT_REGISTRY: 0x01697DAE20028a428Ce2462521c5A60d0dB7f55d WebSocket RPC is REQUIRED - Monad doesn't support eth_newFilter on HTTP RPC IMPORTANT: These addresses are hardcoded in all guide scripts and examples. Use these values directly in your code - no need for .env variables for these addresses. API Configuration: Edit {baseDir}/api-config.json to add new data sources See {baseDir}/references/api-guide.md for LLM-driven API integration State Management: Agent tracks requests in agent-storage.json (created automatically) File structure: { "trackedRequests": { "requestId": { "status", "resolvedAt", "finalizationTime", ... } } } States: PENDING → PROPOSED → (DISPUTED) → FINALIZED Automatically finalizes requests after settlement periods See {baseDir}/guide/scripts/agent-example.js for complete implementation ### Important Notes ⚠️ MUST use WebSocket for events - HTTP RPC will fail with "Method not found: eth_newFilter" ⚠️ Generate fresh wallet - Never reuse existing keys (use CLAWRACLE_AGENT_KEY) ⚠️ Speed matters - First correct answer often wins ⚠️ Wrong answers lose 50% bond - Verify before submitting ⚠️ BigInt conversion required - Contract enum values return as BigInt, convert with Number() ⚠️ Automatic finalization - Agent watches for settlement periods and calls finalizeRequest() automatically ### LLM-Driven API Integration This skill uses fully LLM-driven API integration - no hardcoded API logic. Your LLM: Reads api-config.json to find API for category Reads API documentation files from api-docs/ Constructs API calls dynamically based on docs Extracts answers from responses See {baseDir}/references/api-guide.md for: General API Integration Rulebook LLM prompt templates Date handling, keyword extraction, pagination Adding new APIs ### Implementation Examples WebSocket Agent Example: {baseDir}/guide/scripts/websocket-agent-example.js - Complete WebSocket setup with try-catch error handling, event listeners, and periodic finalization checks ### References Setup Guide: {baseDir}/references/setup.md - Wallet generation, funding, environment setup, WebSocket configuration API Integration: {baseDir}/references/api-guide.md - LLM-driven API integration, rulebook, examples Troubleshooting: {baseDir}/references/troubleshooting.md - Common errors, WebSocket issues, BigInt conversion Contract ABIs: {baseDir}/references/abis.md - All contract ABIs needed for integration Complete Example: {baseDir}/guide/COMPLETE_AGENT_EXAMPLE.md - Full working agent code ### Support Check {baseDir}/references/troubleshooting.md for common issues Review {baseDir}/guide/TECHNICAL_REFERENCE.md for contract details ## Trust - Source: tencent - Verification: Indexed source record - Publisher: deeakpan - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-01T19:11:28.273Z - Expires at: 2026-05-08T19:11:28.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/clawracle-resolver) - [Send to Agent page](https://openagent3.xyz/skills/clawracle-resolver/agent) - [JSON manifest](https://openagent3.xyz/skills/clawracle-resolver/agent.json) - [Markdown brief](https://openagent3.xyz/skills/clawracle-resolver/agent.md) - [Download page](https://openagent3.xyz/downloads/clawracle-resolver)