# Send MetaMask Agent Wallet to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "metamask-agent-wallet-skill",
    "name": "MetaMask Agent Wallet",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/andreolf/metamask-agent-wallet-skill",
    "canonicalUrl": "https://clawhub.ai/andreolf/metamask-agent-wallet-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/metamask-agent-wallet-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=metamask-agent-wallet-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/metamask-agent-wallet-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/metamask-agent-wallet-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/metamask-agent-wallet-skill",
    "agentUrl": "https://openagent3.xyz/skills/metamask-agent-wallet-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/metamask-agent-wallet-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/metamask-agent-wallet-skill/agent.md"
  }
}
```
## Documentation

### MetaMask Agent Wallet Skill

Controls a sandboxed MetaMask wallet for autonomous blockchain transactions with configurable permission guardrails.

### Overview

This skill allows AI agents to interact with dapps and execute transactions through a dedicated MetaMask wallet. All operations are subject to user-defined constraints (spend limits, protocol allowlists, approval thresholds).

Security Model: The agent controls a separate wallet in an isolated browser profile. Never use your main wallet.

### 1. Install Dependencies

cd metamask-agent-skill
npm install
npx playwright install chromium

### 2. Create Agent Wallet Profile

npm run setup

This will:

Create a fresh Chrome profile at ~/.agent-wallet/chrome-profile
Install MetaMask extension
Guide you through wallet creation (use a NEW seed phrase)

### 3. Fund the Wallet

Transfer a small amount to your agent wallet:

ETH for gas (0.01-0.05 ETH recommended)
Tokens for operations (start small, e.g., $50 USDC)

### 4. Configure Permissions

Edit permissions.json to set your constraints:

{
  "constraints": {
    "spendLimit": {
      "daily": "50000000",    // $50 in 6-decimal format
      "perTx": "10000000"     // $10 max per transaction
    },
    "allowedChains": [1, 137, 42161],
    "allowedProtocols": ["0x...uniswap", "0x...1inch"]
  }
}

### Connect to Dapp

connect <dapp-url>

Navigates to dapp and connects the agent wallet.

Example: connect https://app.uniswap.org

### Execute Swap

swap <amount> <token-in> for <token-out> [on <dex>]

Executes a token swap on an allowed DEX.

Example: swap 0.01 ETH for USDC on uniswap

### Send Tokens

send <amount> <token> to <address>

Sends tokens to an address (within spend limits).

Example: send 10 USDC to 0x1234...

### Sign Message

sign <message>

Signs an arbitrary message. Use with caution.

### Check Balance

balance [token]

Returns wallet balances.

### View Transaction History

history [count]

Shows recent agent transactions with outcomes.

### Constraints

All operations check against permissions.json before execution:

ConstraintDescriptionspendLimit.dailyMax USD value per 24h periodspendLimit.perTxMax USD value per transactionallowedChainsWhitelisted chain IDsallowedProtocolsWhitelisted contract addressesblockedMethodsForbidden function selectorsrequireApproval.aboveThreshold requiring user confirmation

### Approval Flow

When a transaction exceeds requireApproval.above:

Agent pauses execution
Transaction details are logged
Agent reports: "Transaction requires approval: [details]"
User must explicitly approve before agent continues

### Safety

Isolated Profile: Agent uses separate Chrome profile, never your main browser
Separate Wallet: Agent wallet is completely separate from your main wallet
Spend Caps: Hard limits prevent runaway spending
Protocol Allowlist: Only whitelisted contracts can be called
Full Logging: Every transaction intent and outcome is logged
Revocation: Set "revoked": true in permissions.json to disable all actions

### Logging

All transactions are logged to ~/.agent-wallet/logs/:

{
  "timestamp": 1706900000000,
  "action": "swap",
  "intent": { "to": "0x...", "value": "0", "data": "0x..." },
  "guardResult": { "allowed": true },
  "outcome": "confirmed",
  "txHash": "0x..."
}

Use history command to view recent transactions.

### "Protocol not allowed"

Add the contract address to allowedProtocols in permissions.json.

### "Exceeds daily limit"

Wait 24h or increase spendLimit.daily.

### MetaMask popup not detected

Ensure the browser profile path is correct and MetaMask is installed.

### Transaction simulation failed

The dapp may be trying to call a blocked method or unsupported chain.

### Architecture

src/
├── index.ts          # Main entry point
├── browser.ts        # Playwright browser management
├── wallet.ts         # MetaMask interaction primitives
├── guard.ts          # Permission enforcement
├── logger.ts         # Transaction logging
├── price.ts          # USD price estimation
├── types.ts          # TypeScript types
└── config.ts         # Configuration loading

### Integration with Gator

When Gator accounts are available, permissions.json can be replaced with on-chain permission attestations. The guard will validate against Gator's permission registry instead of local config.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: andreolf
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/metamask-agent-wallet-skill)
- [Send to Agent page](https://openagent3.xyz/skills/metamask-agent-wallet-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/metamask-agent-wallet-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/metamask-agent-wallet-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/metamask-agent-wallet-skill)