ens

What This Skill Does

The ENS (Ethereum Name Service) skill empowers the OpenClaw agent to seamlessly interact with the decentralized naming ecosystem on the Ethereum mainnet. At its core, the skill provides bi-directional translation between human-readable .eth domains and hexadecimal wallet addresses. By leveraging multiple resolution strategies—including The Graph subgraphs, the web3.bio API, and viem-based fallback logic—the agent ensures high availability and accuracy when dealing with decentralized identity. Beyond simple lookups, this skill allows for the retrieval of rich profile metadata, such as avatar links, social media records, and physical text records, enabling a more personalized user experience. Furthermore, it supports the management lifecycle of ENS names, including checking registration availability, renewal status, and updating records for existing domains.

Installation

You can install this skill directly via the OpenClaw command-line interface by running the following command in your terminal:

clawhub install openclaw/skills/skills/fabriziogianni7/ens-skill

Ensure that you have your environment configured, specifically if you intend to use the primary subgraph resolution method, which requires a valid GRAPH_API_KEY to be exported in your environment variables.

Use Cases

This skill is essential for any interaction involving Ethereum-based transactions or identity. Use it whenever a user inputs an .eth name, such as requesting a token transfer to 'vitalik.eth'. It is also vital for UI/UX improvements, allowing the agent to replace long, confusing hexadecimal strings with recognized names in chat history. Additionally, the skill acts as a management dashboard for users wishing to check if a specific name is taken, look up the expiration date of their assets, or resolve ENS-associated social profiles for verification purposes.

Example Prompts

1. "Send 0.05 ETH to vitalik.eth."
2. "Look up the ENS profile for nick.eth and tell me their linked social accounts."
3. "Is 'my-custom-name.eth' currently available for registration?"

Tips & Limitations

Always prioritize forward resolution before executing any financial transaction; the agent should never pass an .eth string directly to a transaction tool. Use the provided resolution priority: Subgraph first for detailed metadata, web3.bio for general information, and the viem fallback for absolute reliability when APIs are unreachable. Note that registration and renewal operations require interaction with the mainnet; ensure your wallet is connected and has sufficient gas. The skill is read-heavy by default, so cache results if you are performing multiple lookups for the same user in a single session to reduce latency and API usage.