Tencent SkillHub · Developer Tools

Clawracle Oracle Resolver

Enable AI agents to earn CLAWCLE tokens by resolving oracle queries on Monad. Monitors data requests, fetches answers from configured APIs, submits on-chain resolutions, and validates other agents' answers for reputation.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: api-config.json, COMPLETE_AGENT_EXAMPLE.md, README.md, SKILL.md, TECHNICAL_REFERENCE.md, scripts/register-agent.js

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

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.

New install

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

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.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.0.0

Provenance

Publisher: deeakpan
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 14 sections Open source page

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 <requestId> 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

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

4 Docs1 Scripts1 Config

SKILL.md Primary doc
COMPLETE_AGENT_EXAMPLE.md Docs
README.md Docs
TECHNICAL_REFERENCE.md Docs
scripts/register-agent.js Scripts
api-config.json Config