evm-wallet-skill

What This Skill Does

The evm-wallet-skill is a specialized agent module designed for self-sovereign management of Ethereum-compatible (EVM) blockchain assets. By enabling an OpenClaw AI agent to interact with major chains including Ethereum, Base, Polygon, Arbitrum, and Optimism, it removes the need for centralized intermediaries. The skill handles wallet creation, balance inquiries, token transfers, and complex DeFi interactions like swaps and smart contract calls. Crucially, it adheres to a 'security-first' design where all private keys are stored locally on the host machine with restricted file permissions (chmod 600), ensuring that the agent remains in full control of its treasury without requiring API keys or cloud-hosted custody services.

Installation

Installation requires identifying the correct OpenClaw skill directory on your system. Once the SKILL_DIR is set, you can bootstrap the installation by cloning the evm-wallet-skill repository into that path and running npm install. All interactions are initiated via CLI commands from within the skill directory. The initial setup requires running node src/setup.js --json once to initialize the local wallet file (~/.evm-wallet.json). Remember that all subsequent commands should be executed with the --json flag to ensure the agent can reliably parse the output for decision-making.

Use Cases

• Asset Management: Quickly check balances across multiple networks or for specific ERC20 tokens.
• Transfers: Sending ETH or ERC20 tokens to collaborators or service providers directly from the agent's wallet.
• DeFi Swaps: Utilizing the Odos aggregator to find the most efficient routing for trading tokens, allowing the agent to manage its liquidity effectively.
• Smart Contract Interfacing: Performing specific on-chain operations defined by external contracts for automated workflows.

Example Prompts

1. "Check my total balance across all supported chains and report back in USD."
2. "Send 0.05 ETH on the Base network to 0x71C7656... and confirm the transaction details."
3. "Can you swap 100 USDC for WETH on Arbitrum? Please get a quote and show me the expected output first."

Tips & Limitations

Always prioritize security: never share your private key file. When performing transfers or swaps, always present the estimated gas fees and transaction summary to the user for explicit approval. The skill is limited to the EVM chains supported by the underlying scripts; non-EVM chains (like Solana or Bitcoin) are not supported. Ensure your server has a stable RPC connection for the selected chains, as the script relies on standard blockchain network interaction.