A secure, sandboxed MetaMask wallet interface for autonomous AI agents to execute blockchain transactions within user-defined safety limits.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install metamask-agent-wallet-skill
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 metamask-agent-wallet-skill 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 MetaMask Agent Wallet?
The MetaMask Agent Wallet skill empowers AI agents to interact with decentralized applications (dapps) and execute on-chain operations autonomously. By leveraging Openclaw Skills, developers can integrate MetaMask functionality into their agent workflows while maintaining strict control via a sandboxed browser environment. This skill prioritizes security by utilizing an isolated Chrome profile, ensuring that your primary assets remain untouched while the agent operates within a dedicated, limited-fund wallet.
Transactions are never executed blindly; every operation is passed through a robust permission engine. This engine validates the transaction against pre-defined constraints such as daily spending limits, protocol allowlists, and specific chain IDs. This makes it an ideal choice for developers looking to build sophisticated financial agents using Openclaw Skills without compromising on safety or transparency.
MetaMask Agent Wallet Use Cases
- Automating recurring token swaps on decentralized exchanges like Uniswap or 1inch.
- Managing treasury operations for small-scale projects or DAOs through pre-configured agent wallets.
- Executing programmatic payments and token distributions based on external triggers or data inputs.
- Developing automated yield farming or liquidity provision strategies using Openclaw Skills.
- Testing dapps and smart contract interactions in a controlled, automated environment.
How MetaMask Agent Wallet Works
- The agent initializes a sandboxed Playwright-controlled browser instance with a dedicated MetaMask profile located in a separate directory.
- Before any transaction is initiated, the skill evaluates the intent against the local permissions.json configuration.
- The guardrail system checks daily spend limits, per-transaction caps, and chain allowlists to ensure compliance with user policies.
- If a transaction exceeds the predefined approval threshold, the agent pauses execution and requests manual user confirmation.
- Authorized transactions are signed within the MetaMask extension and broadcast to the blockchain.
- Every action, intent, and outcome is recorded in detailed JSON logs for auditing, providing a full history of all Openclaw Skills activities.
MetaMask Agent Wallet Setup
First, clone the repository and install the necessary dependencies for the environment:
cd metamask-agent-skill
npm install
npx playwright install chromium
Run the setup command to initialize the isolated agent profile and set up your MetaMask extension with a new seed phrase:
npm run setup
Finally, fund your agent wallet with a small amount of ETH for gas and tokens for operations, then configure your permissions.json file to define your safety guardrails and allowed protocols.
MetaMask Agent Wallet Data Schema & Taxonomy
The skill maintains an organized data structure within the ~/.agent-wallet/ directory to ensure persistence and traceability for Openclaw Skills users.
| Component | Path | Description |
|---|---|---|
| Browser Profile | ~/.agent-wallet/chrome-profile |
The isolated environment containing MetaMask data and extension state. |
| Logs | ~/.agent-wallet/logs/ |
JSON files documenting every transaction attempt and result. |
| Configuration | permissions.json |
The core file for setting limits, allowlists, and thresholds. |
Log entries follow a structured format including timestamp, action (e.g., swap, send), intent (target address and data), guardResult (permission status), and the final txHash once confirmed on-chain.
MetaMask Agent Wallet Advanced Features
- Multi-chain support with granular allowlisting for Ethereum, Polygon, Arbitrum, and other EVM networks.
- Future-proof integration with Gator for on-chain permission attestations and decentralized policy management.
- Configurable approval thresholds (requireApproval.above) to balance agent autonomy with human oversight.
- Revocation master switch to instantly disable all agent wallet operations by setting a single flag.
- Detailed transaction simulation and guardrail validation integrated directly into the Openclaw Skills workflow.
SKILL.md
Loading
Related Openclaw Skills
Todoist CLI Manager
A robust CLI tool for managing Todoist tasks, projects, and labels via the REST API v2.
Just Calendar CLI
A terminal-based interface for managing calendar data and habit tracking stored directly in Google Drive via the justcalendar.ai platform.
Cubistic Public Bot Integration
A technical framework for onboarding and managing external bots within the Cubistic 3D ecosystem using Proof-of-Work verification.
Cubistic Bot Runner
A Node.js-based bot runner for the Cubistic shared 3D cube world using automated proof-of-work painting scripts.
Refund Radar
A privacy-first financial auditor that scans bank statements to identify recurring charges, flag suspicious transactions, and generate refund request templates.
WalletPilot
WalletPilot provides a secure framework for AI agents to automate interactions with over 10 major crypto wallets across EVM and Solana chains.
Featured*
