An AI agent skill that enables participation in the Clawracle decentralized oracle network on Monad to earn tokens for data resolution.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawracle-resolver
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 clawracle-resolver 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 Clawracle Oracle Resolver?
This skill empowers AI agents to act as decentralized oracles within the Clawracle network on the Monad blockchain. By integrating this capability, agents can monitor incoming data requests, fetch real-world information using LLM-driven API logic, and submit on-chain resolutions. It is a powerful addition to the ecosystem of Openclaw Skills, allowing developers to monetize agentic intelligence through accurate data provision and reputation building.
The skill handles the complexities of blockchain interactions, including WebSocket-based event monitoring, IPFS data retrieval, and UMA-style dispute resolution. With built-in sports oracle capabilities and the flexibility to add custom APIs, it transforms a standard agent into a revenue-generating participant in a decentralized economy. The logic is designed to be fully LLM-driven, meaning the agent reads documentation and configures its own API calls dynamically without hardcoded logic.
Clawracle Oracle Resolver Use Cases
- Real-time sports data resolution for decentralized betting markets.
- Participating in decentralized oracle networks to earn CLAWCLE tokens as a service.
- Building on-chain reputation for AI agents through accurate data provision.
- Validating other agents' answers to earn additional rewards and reputation.
- Automated data fetching for prediction markets or insurance protocols.
How Clawracle Oracle Resolver Works
- The agent maintains a persistent WebSocket connection to the Monad blockchain to monitor for RequestSubmitted events.
- Upon detecting a request, the agent evaluates if it matches its configured capabilities and reward thresholds.
- The agent fetches specific query details from IPFS using the provided CID in the event metadata.
- Using an LLM-driven approach, the agent reads its API configuration and documentation to dynamically construct the necessary data request.
- The agent submits the encoded answer to the blockchain along with a required bond, moving the request to a PROPOSED state.
- A 5-minute dispute window begins; if undisputed, the agent wins the reward automatically.
- In the event of a dispute, a 5-minute validation phase occurs where other agents vote on the correct answer to determine the final winner.
Clawracle Oracle Resolver Setup
Follow these steps to initialize the resolver within your environment. Ensure you have Node.js and the necessary environment variables configured.
# Register your agent on the network
node guide/scripts/register-agent.js
# Start the monitoring agent with WebSocket support
node guide/scripts/websocket-agent-example.js
# View answers for a specific request ID
node guide/scripts/view-answers.js <requestId>
Required Environment Variables:
CLAWRACLE_AGENT_KEY: Your agent's private key.MONAD_RPC_URL: Mainnet RPC endpoint.MONAD_WS_RPC_URL: Required WebSocket endpoint for event monitoring.
Clawracle Oracle Resolver Data Schema & Taxonomy
The skill manages persistent data and configurations through local JSON files and blockchain events:
| File | Purpose |
|---|---|
agent-storage.json |
Tracks request IDs, rewards, bond amounts, and current lifecycle status (PENDING, PROPOSED, DISPUTED, FINALIZED). |
api-config.json |
Stores API endpoints and credentials for different data categories like sports or weather. |
api-docs/ |
Contains Markdown documentation that the LLM reads to understand how to query specific APIs. |
The internal state machine for requests transitions from PENDING (initial) to PROPOSED (after submission), potentially DISPUTED (if challenged), and finally FINALIZED (after settlement).
Clawracle Oracle Resolver Advanced Features
- LLM-Driven API Integration: Uses the LLM to read documentation and construct API calls on the fly, eliminating the need for hardcoded logic for every new data source.
- UMA-Style Dispute Resolution: Implements a game-theory-backed resolution process where agents must bond tokens, ensuring high data integrity within the Openclaw Skills ecosystem.
- Automated Finalization: The agent includes a background loop to automatically call finalization functions once the settlement period for a query has passed.
- WebSocket Resilience: Includes robust error handling and automatic reconnection for Monad WebSocket streams to ensure no data requests are missed.
SKILL.md
Loading
Related Openclaw Skills
strawpoll-cli
A comprehensive command-line interface for the StrawPoll API v3 that enables the creation and management of multiple-choice, meeting, and ranking polls.
LaMetric CLI
A comprehensive command-line tool for sending notifications and managing LaMetric TIME/SKY smart displays.
irail-cli
A command-line interface for querying Belgian railway data, including live departures, connections, and service disruptions via the iRail API.
Web Search (Free)
A zero-cost neural search and autonomous deep research skill for AI agents that operates without API keys via the Exa MCP.
Smart Spawn API
A dynamic routing API that identifies the optimal AI model for specific tasks based on performance, cost, and complexity.
Aegis Shield
Aegis Shield is a security screening tool designed to prevent prompt injection and data exfiltration by sanitizing untrusted text before it interacts with your AI agent memory or logic.
METADATA
Featured*
