How to set up MetaMask Agent Wallet and make your first trade

Configurar MetaMask Agent Wallet requiere tres pasos: instalar el CLI mm, añadir skills a tu agente de IA y pegar un único prompt. Tu agente te guiará para iniciar sesión y elegir tu configuración de seguridad. Una vez que hayas financiado la wallet, podrá intercambiar tokens a partir de una solicitud en lenguaje natural. Los perps y los mercados de predicción incluyen un paso de financiación propio, que se explica en sus respectivas guías. Esta guía sigue el quickstart oficial, desde la instalación hasta la primera operación.

Esta es una guía de configuración, no una guía explicativa. Para entender qué es una agentic wallet, consulta qué es una agentic wallet. Para conocer cómo funcionan el ciclo de vida de las transacciones y el pipeline de seguridad, consulta cómo funcionan las agentic wallets y seguridad de las agentic wallets.

Antes de empezar

Necesitas:

• Node.js 22.18 o posterior. Compruébalo con node --version.

• Un agente de IA compatible con skills, como Claude Code, Codex, Cursor, OpenClaw o Hermes Agent. (¿Sin skills? El paso 3 incluye una ruta solo por terminal.)

• Fondos que puedas enviar desde otra wallet o un exchange.

Paso 1: Instala el CLI

El CLI mm es la herramienta con la que tu agente inicia sesión, consulta saldos y envía transacciones.

npm install -g @metamask/agent-wallet@latest

Yarn, pnpm y Bun también funcionan (yarn global add, pnpm add -g o bun add --global, con el mismo paquete). Ejecuta mm doctor después para confirmar la versión del CLI y la compatibilidad con las skills. Es normal que aparezcan avisos sobre skills faltantes hasta el paso 2.

Paso 2: Añade skills a tu agente

Las skills le enseñan a tu agente qué comandos mm debe ejecutar y cuándo pedirte confirmación antes de mover fondos.

npx skills add MetaMask/agent-skills

Paso 3: Inicia la configuración con un único prompt

Abre tu agente y pega:

Set up MetaMask Agent Wallet: help me pick a sign-in method, wallet mode, and trading mode, then show my address.

Tu agente te preguntará qué método de inicio de sesión prefieres y luego ejecutará los comandos de configuración. Los dos pasos siguientes explican las opciones que te pedirá elegir.

¿Prefieres la terminal o ejecutar un agente sin skills? Ejecuta mm doctor, mm login, mm init y luego mm doctor de nuevo. La guía de configuración del CLI explica cada comando.

Paso 4: Inicia sesión con un método y mantenlo siempre

Google, correo electrónico y MetaMask Mobile QR cargan cada uno una dirección de server wallet diferente, incluso si usas la misma dirección para el inicio de sesión por correo y por Google (cuando eliges Mobile QR, no se utiliza ninguna dirección de correo). Elige un método, úsalo siempre y ejecuta mm wallet address después de cada inicio de sesión para confirmar que estás viendo la dirección que has financiado.

Para Google o correo electrónico, tu agente abre el panel de Agent Wallet en tu navegador. Inicia sesión, haz clic en Authorize y, si se te solicita, copia el token del CLI desde el navegador y pégalo en tu terminal. El inicio de sesión por correo electrónico añade un código de verificación de tu bandeja de entrada: introdúcelo en el navegador antes de hacer clic en Authorize. Ese código no es el token del CLI, así que no lo pegues en la terminal.

Para MetaMask Mobile QR, tu agente muestra un código QR en la terminal. Abre MetaMask Mobile, escanea el código y aprueba la conexión en la app.

Paso 5: Elige tu wallet mode y trading mode

Tu agente te pregunta cómo debe gestionar los fondos:

Si usas tu propia wallet, define la variable de entorno MM_MNEMONIC en lugar de pasar la frase por línea de comandos:

export MM_MNEMONIC = ""

Con una server wallet, tu agente también te pedirá que elijas un trading mode:

Guard Mode es la opción recomendada para la mayoría de los usuarios. Puedes cambiar de modo más adelante con mm wallet trading-mode set guard o mm wallet trading-mode set beast. Para una comparación detallada de cada restricción, consulta trading modes.

Paso 6: Financia tu wallet

Cuando finalice la configuración, tu agente mostrará la dirección de tu wallet. Confirma que coincide con lo que esperas y luego envía fondos desde otra wallet o un exchange. Puedes pedírsela a tu agente en cualquier momento:

Show my wallet address and balance.

Dos cosas que debes saber antes de enviar:

• Los saldos son por cadena. Financia la cadena en la que planeas operar. Ejecuta mm chains list para ver las redes compatibles y qué funciones (swap, predict, perps) admite cada una.

• Comprueba la cobertura de la cadena. En las cadenas marcadas con "No" en la columna Transaction Shield de la lista de cadenas compatibles, el análisis de amenazas no está disponible. Ethereum, Base, Arbitrum, Optimism y Polygon se encuentran entre las cadenas cubiertas.

Antes de tu primera transacción, ejecuta mm doctor y confirma que tanto authenticated como initialized muestran true. Si alguno es false, sigue las indicaciones del resultado y vuelve a ejecutarlo.

Paso 7: Realiza tu primera operación

Pídele a tu agente un swap pequeño:

Swap 0.01 ETH to USDC on Base.

Tu agente obtendrá una cotización, te mostrará la ruta y el resultado, y ejecutará la operación tras tu confirmación. Si prefieres empezar con algo de menor riesgo, pregunta "What's my USDC balance?" o "What's the current price of ETH?". Las solicitudes de solo lectura se ejecutan sin necesidad de confirmación.

Guard Mode te pedirá tu intervención en dos momentos al principio. Se te solicitará que establezcas tu límite de salida renovable de 24 horas en tu primera transacción, y cualquier operación fuera de tus listas de permitidos o que supere ese límite quedará en pausa para una aprobación de doble factor. Tu agente no puede continuar con una transacción marcada hasta que respondas. Las aprobaciones llegarán como un enlace por correo electrónico si iniciaste sesión con Google o correo, o como una notificación push en MetaMask Mobile si usaste QR (revisa el menú de notificaciones si no aparece ninguna notificación push).

Si la configuración se detiene

Empieza con mm doctor. Indica si has iniciado sesión y si estás inicializado, y sus sugerencias te dicen qué corregir. Para los códigos de error más comunes:

La página de solución de problemas cubre más casos.

Qué hacer a continuación

Una vez que tu primera operación se complete, elige una clase de activo. Para posiciones apalancadas en Hyperliquid, consulta cómo operar perps con MetaMask Agent Wallet. Para swaps en la misma cadena y bridges entre cadenas, consulta cómo intercambiar y hacer bridge de tokens. Para Polymarket, consulta cómo operar en mercados de predicción. La documentación también cubre yield vaults y pagos x402.