A specialized tool for retrieving Aavegotchi metadata and generating on-chain images directly from the Base blockchain.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gotchi-finder
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 gotchi-finder 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 Gotchi Finder?
The Gotchi Finder is a robust utility designed for Openclaw Skills that allows developers and agents to query Aavegotchi NFTs by ID on the Base mainnet. It provides a seamless way to access on-chain SVG data, convert it into high-quality PNG formats, and extract comprehensive trait data, including the Total Base Rarity Score (BRS). This tool is essential for anyone building gaming integrations or analytics bots within the Aavegotchi ecosystem using Openclaw Skills.
By leveraging the Base mainnet Diamond contract, the skill ensures that users get the most accurate, real-time data regarding their digital ghosts. It handles the technical heavy lifting of SVG-to-PNG conversion using the Sharp library, making it easy to display gotchis in standard chat interfaces or web applications.
Gotchi Finder Use Cases
- Automated Aavegotchi trait and rarity lookups via ID for Discord or Telegram bots using Openclaw Skills.
- Generating high-resolution 1024x1024 PNG images of gotchis for social sharing or marketing materials.
- Verifying true power levels (Total BRS) including wearable modifiers for competitive gaming and strategy.
- Integrating real-time blockchain character data and artwork into custom Openclaw Skills workflows.
How Gotchi Finder Works
- The user or agent triggers the script with a specific Gotchi ID through the CLI.
- The tool connects to the Base mainnet RPC to query the Aavegotchi Diamond contract and public subgraphs.
- Metadata, status codes, and raw SVG data are retrieved directly from the blockchain.
- The SVG is processed through the Sharp library to generate standard (512x512) or high-resolution (1024x1024) PNG images.
- A formatted response containing the image path and a metadata caption is generated for the Openclaw Skills messaging tool.
Gotchi Finder Setup
Navigate to your workspace directory and install the necessary Node.js dependencies to begin using this tool within Openclaw Skills:
cd ~/.openclaw/workspace/skills/gotchi-finder
npm install
Ensure you have the BASE_MAINNET_RPC environment variable configured in your environment to allow the skill to communicate with the blockchain.
Gotchi Finder Data Schema & Taxonomy
The skill organizes data by Gotchi ID and generates the following files for each request:
| File Name | Description |
|---|---|
gotchi-{ID}.json |
Comprehensive metadata including traits, BRS, and owner info. |
gotchi-{ID}.svg |
Original scalable vector graphics retrieved from the contract. |
gotchi-{ID}.png |
Standard 512x512 preview image used for default displays. |
gotchi-{ID}-hires.png |
High-definition 1024x1024 image for professional use cases. |
Gotchi Finder Advanced Features
- Multi-format support allowing users to choose between preview, PNG, hi-res, or raw SVG outputs.
- Integrated rarity tier classification ranging from Common to Godlike based on the Total BRS calculation.
- Specialized show-gotchi.sh script designed for seamless integration with AI agent message tools.
- 100% read-only architecture ensuring maximum security with zero wallet or private key requirements for Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
gotchi-equip
A specialized skill for managing Aavegotchi wearable loadouts on the Base network through Bankr submissions.
Aavegotchi Traits
Fetch detailed Aavegotchi NFT metadata, traits, and rarity scores on the Base network using IDs or names.
Hello World
A foundational greeting skill for the Openclaw platform that demonstrates basic command processing and personalization.
Wavelet World Model
A sophisticated tool for transforming sequential state data into multi-resolution world models using Discrete Wavelet Transforms.
Gotchi Pocket
A technical tool for managing Aavegotchi pocket wallets and ERC20 tokens on the Base network using secure Bankr integration.
Pet Operator
A specialized toolset for delegating Aavegotchi petting rights to automated operator wallets on the Base network.
METADATA
Featured*
