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

MetaMask Agent Wallet einzurichten dauert drei Schritte: Installiere die mm CLI, füge deinem KI-Agenten Skills hinzu und füge einen einzigen Prompt ein. Dein Agent führt dich dann durch die Anmeldung und die Auswahl deiner Sicherheitseinstellungen. Sobald du die Wallet aufgeladen hast, kann sie Token auf Basis einer Anfrage in natürlicher Sprache tauschen. Perps und Prediction Markets erfordern einen eigenen Finanzierungsschritt, der in den jeweiligen Anleitungen beschrieben wird. Diese Anleitung folgt dem offiziellen Quickstart von der Installation bis zum ersten Trade.

Dies ist eine Einrichtungsanleitung, keine Erklärung. Was eine Agentic Wallet ist, erfährst du unter Was ist eine Agentic Wallet. Wie der Transaktionslebenszyklus und die Sicherheitspipeline funktionieren, erfährst du unter Wie Agentic Wallets funktionieren und Agentic Wallet Security.

Bevor du beginnst

Du benötigst:

• Node.js 22.18 oder höher. Prüfe dies mit node --version.

• Einen KI-Agenten, der Skills unterstützt, z. B. Claude Code, Codex, Cursor, OpenClaw oder Hermes Agent. (Keine Skills? Schritt 3 beschreibt einen Weg nur über das Terminal.)

• Guthaben, das du von einer anderen Wallet oder einer Börse senden kannst.

Schritt 1: CLI installieren

Die mm CLI ermöglicht es deinem Agenten, sich anzumelden, Guthaben zu prüfen und Transaktionen zu senden.

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

Yarn, pnpm und Bun funktionieren ebenfalls (yarn global add, pnpm add -g oder bun add --global, mit demselben Paket). Führe anschließend mm doctor aus, um die CLI-Version und die Skill-Kompatibilität zu bestätigen. Hinweise zu fehlenden Skills sind bis Schritt 2 zu erwarten.

Schritt 2: Skills zu deinem Agenten hinzufügen

Skills zeigen deinem Agenten, welche mm-Befehle er ausführen soll und wann er deine Bestätigung einholen muss, bevor Guthaben bewegt wird.

npx skills add MetaMask/agent-skills

Schritt 3: Einrichtung mit einem einzigen Prompt starten

Öffne deinen Agenten und füge Folgendes ein:

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

Dein Agent fragt, welche Anmeldemethode du verwenden möchtest, und führt dann die Einrichtungsbefehle aus. Die nächsten beiden Schritte erläutern die Auswahlmöglichkeiten, die er dir stellt.

Bevorzugst du das Terminal oder möchtest du einen Agenten ohne Skills verwenden? Führe mm doctor, mm login, mm init und dann erneut mm doctor aus. Die CLI-Einrichtungsanleitung beschreibt jeden Befehl.

Schritt 4: Mit einer Methode anmelden und dabei bleiben

Google, E-Mail und MetaMask Mobile QR laden jeweils eine andere Server-Wallet-Adresse, auch wenn du dieselbe Adresse für E-Mail- und Google-Login verwendest (bei Mobile QR wird keine E-Mail-Adresse verwendet). Wähle eine Methode, verwende sie jedes Mal und führe nach jeder Anmeldung mm wallet address aus, um zu bestätigen, dass du die aufgeladene Adresse siehst.

Für Google oder E-Mail öffnet dein Agent das Agent Wallet Dashboard in deinem Browser. Melde dich an, klicke auf Authorize und kopiere dann den CLI-Token aus dem Browser und füge ihn bei Aufforderung in dein Terminal ein. Bei der E-Mail-Anmeldung kommt ein Bestätigungscode aus deinem Posteingang hinzu: Gib ihn im Browser ein, bevor du auf Authorize klickst. Dieser Code ist nicht der CLI-Token – füge ihn also nicht ins Terminal ein.

Für MetaMask Mobile QR zeigt dein Agent einen QR-Code im Terminal an. Öffne MetaMask Mobile, scanne den Code und bestätige die Verbindung in der App.

Schritt 5: Wallet-Modus und Trading-Modus wählen

Dein Agent fragt, wie er Guthaben verwahren soll:

Wenn du deine eigene Wallet mitbringst, setze die Umgebungsvariable MM_MNEMONIC, anstatt die Phrase in der Befehlszeile zu übergeben:

export MM_MNEMONIC = ""

Bei einer Server Wallet fragt dein Agent auch nach einem Trading-Modus:

Guard Mode ist die empfohlene Wahl für die meisten Nutzer. Du kannst den Modus später mit mm wallet trading-mode set guard oder mm wallet trading-mode set beast ändern. Den vollständigen Vergleich aller Sicherheitsmechanismen findest du unter Trading Modes.

Schritt 6: Wallet aufladen

Wenn die Einrichtung abgeschlossen ist, zeigt dein Agent deine Wallet-Adresse an. Bestätige, dass sie deinen Erwartungen entspricht, und sende dann Guthaben von einer anderen Wallet oder einer Börse. Du kannst deinen Agenten jederzeit danach fragen:

Show my wallet address and balance.

Zwei wichtige Hinweise, bevor du sendest:

• Guthaben ist chain-spezifisch. Lade die Chain auf, auf der du handeln möchtest. Führe mm chains list aus, um unterstützte Netzwerke und die jeweils verfügbaren Funktionen (Swap, Predict, Perps) anzuzeigen.

• Prüfe die Chain-Abdeckung. Auf Chains, die in der Spalte „Transaction Shield" der Liste der unterstützten Chains mit „No" markiert sind, ist die Bedrohungserkennung nicht verfügbar. Ethereum, Base, Arbitrum, Optimism und Polygon gehören zu den abgedeckten Chains.

Führe vor deiner ersten Transaktion mm doctor aus und bestätige, dass sowohl authenticated als auch initialized den Wert true anzeigen. Falls einer der Werte false ist, folge den Hinweisen in der Ausgabe und führe den Befehl erneut aus.

Schritt 7: Ersten Trade durchführen

Bitte deinen Agenten um einen kleinen Swap:

Swap 0.01 ETH to USDC on Base.

Dein Agent ruft ein Angebot ab, zeigt dir Route und Ausgabe an und führt den Trade nach deiner Bestätigung aus. Wenn du lieber mit etwas Risikoärmerem beginnen möchtest, frage: „What's my USDC balance?" oder „What's the current price of ETH?" Nur-Lese-Anfragen werden ohne Bestätigungsaufforderung ausgeführt.

Guard Mode fordert deine Eingabe zu Beginn an zwei Stellen an. Bei deiner ersten Transaktion wirst du aufgefordert, dein rollierendes 24-Stunden-Abflusslimit festzulegen, und alles außerhalb deiner Allowlists oder dieses Limits wird für eine Zwei-Faktor-Genehmigung pausiert. Dein Agent kann bei einer markierten Transaktion nicht fortfahren, bis du reagierst. Genehmigungen kommen als E-Mail-Link, wenn du dich mit Google oder E-Mail angemeldet hast, oder als Push-Benachrichtigung in MetaMask Mobile, wenn du QR verwendet hast (prüfe das Benachrichtigungsmenü, falls keine Push-Benachrichtigung erscheint).

Wenn die Einrichtung stockt

Beginne mit mm doctor. Es meldet, ob du angemeldet und initialisiert bist, und die Hinweise erklären, was zu beheben ist. Für die häufigsten Fehlercodes:

Die Troubleshooting-Seite behandelt weitere Fälle.

Wie es weitergeht

Sobald dein erster Trade abgeschlossen ist, wähle eine Asset-Klasse. Für gehebelte Positionen auf Hyperliquid, siehe Wie man Perps mit MetaMask Agent Wallet handelt. Für Same-Chain-Swaps und Cross-Chain-Bridges, siehe Wie man Token swappt und bridget. Für Polymarket, siehe Wie man Prediction Markets handelt. Die Dokumentation behandelt außerdem Yield Vaults und x402-Zahlungen.