gotchi-finder

What This Skill Does

The gotchi-finder skill is a specialized tool for the OpenClaw AI ecosystem that bridges the gap between Base mainnet on-chain data and interactive, visual representations of Aavegotchi NFTs. At its core, the tool fetches raw on-chain data—including traits, kinship, levels, and wearable configurations—and processes them into user-friendly outputs. Unlike simple data lookups, this skill goes a step further by rendering the SVG-based Aavegotchi art into standard or high-resolution PNG formats, ensuring the assets are perfectly optimized for sharing in messaging platforms like Telegram.

Installation

To add this capability to your OpenClaw agent, use the standardized package installation command in your terminal or integrated clawhub interface. The package is maintained within the official skill repository, ensuring updates and security patches are synchronized with core agent developments:

clawhub install openclaw/skills/skills/aaigotchi/gotchi-finder

Once installed, the agent will have the ability to interpret IDs passed to the find-gotchi.sh script, automating the retrieval, conversion, and formatting processes required to display a Gotchi’s profile.

Use Cases

The primary use case for this skill is NFT community management and individual collector analysis. By providing a 'TOTAL BRS' calculation, users can instantly identify the 'true' rarity tier of a Gotchi, including the complex math of wearables modifiers. It serves as a rapid-response tool for Discord or Telegram channels where holders need to showcase their assets or verify specific traits before trading or participating in DAO governance. Furthermore, the ability to generate high-resolution images makes this a potent tool for creators and social media managers looking to generate promotional content for specific assets.

Example Prompts

1. "OpenClaw, find Gotchi #9638 and give me the full stats and a preview image."
2. "Can you show me the hi-res image for Gotchi #552? I want to see the traits and the wearable setup in detail."
3. "Fetch all information for Aavegotchi ID 1240 including the SVG vector format for my personal archive."

Tips & Limitations

• Efficiency: Always start with the default command to get a quick preview. Only use the --format hires or --format all flags when you specifically need high-fidelity exports to save on agent processing time.
• Data Integrity: The skill fetches live data from the Base mainnet; if the network experiences high congestion, there may be a slight delay in metadata retrieval.
• Compatibility: This skill is designed to handle all states, including Portals. If you query an unopened Portal, it will provide the specific metadata available for that pre-summoning state. Note that the SVG conversion relies on the on-chain data being fully indexed; ensure your connection to the Base provider is stable for the best experience.