如何设置 MetaMask Agent 钱包并完成首笔交易

设置 MetaMask Agent Wallet 只需三步：安装 mm CLI、为 AI 智能体添加技能，然后粘贴一条提示语。智能体将引导你完成登录并选择安全设置。钱包充值后，即可通过自然语言请求完成代币兑换。永续合约和预测市场各有独立的充值步骤，详见相关指南。本指南遵循官方 快速入门 文档，从安装到首次交易，一步步带你完成。

本文是操作指南，而非概念解析。如需了解智能体钱包的定义，请参阅 什么是智能体钱包。如需了解交易生命周期和安全流程的运作方式，请参阅 智能体钱包的工作原理 和 智能体钱包安全性。

开始之前

你需要准备：

• Node.js 22.18 或更高版本。使用 node --version 查看当前版本。

• 支持技能功能的 AI 智能体，例如 Claude Code、Codex、Cursor、OpenClaw 或 Hermes Agent。（不支持技能？第 3 步提供了仅使用终端的操作路径。）

• 可从其他钱包或交易所转入的资金。

第 1 步：安装 CLI

mm CLI 是智能体用于登录、查询余额和发送交易的工具。

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

Yarn、pnpm 和 Bun 同样适用（分别使用 yarn global add、pnpm add -g 或 bun add --global，包名相同）。安装完成后运行 mm doctor，确认 CLI 版本和技能兼容性。在完成第 2 步之前，出现关于缺少技能的提示属于正常现象。

第 2 步：为智能体添加技能

技能告诉智能体应运行哪些 mm 命令，以及在转移资金前何时需要向你确认。

npx skills add MetaMask/agent-skills

第 3 步：用一条提示语启动设置

打开智能体并粘贴以下内容：

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

智能体会询问你希望使用哪种登录方式，然后运行设置命令。接下来的两步将介绍它会要求你做出的选择。

偏好使用终端，或运行不带技能的智能体？依次运行 mm doctor、mm login、mm init，然后再次运行 mm doctor。CLI 设置指南 详细介绍了每条命令。

第 4 步：选择一种登录方式并持续使用

Google、邮箱和 MetaMask Mobile 二维码各自对应不同的服务器钱包地址，即使你使用同一邮箱地址进行邮箱和 Google 登录也是如此（选择 Mobile 二维码时不使用邮箱地址）。请选择一种方式并始终使用该方式，每次登录后运行 mm wallet address 确认显示的地址与你充值的地址一致。

使用 Google 或邮箱登录时，智能体会在浏览器中打开 Agent Wallet 控制台。登录后点击授权，如有提示，将浏览器中显示的 CLI 令牌复制并粘贴到终端。邮箱登录还需要输入收件箱中的验证码：在点击授权之前，先在浏览器中输入该验证码。该验证码不是 CLI 令牌，请勿将其粘贴到终端。

使用 MetaMask Mobile 二维码登录时，智能体会在终端显示一个二维码。打开 MetaMask Mobile，扫描二维码，然后在应用中批准连接。

第 5 步：选择钱包模式和交易模式

智能体会询问你希望如何持有资金：

如果使用自带钱包，请通过设置 MM_MNEMONIC 环境变量传入助记词，而非在命令行中直接输入：

export MM_MNEMONIC = ""

使用服务器钱包时，智能体还会询问交易模式：

Guard 模式是大多数用户的推荐选择。你可以随时通过 mm wallet trading-mode set guard 或 mm wallet trading-mode set beast 切换模式。如需查看各项安全限制的详细对比，请参阅 交易模式。

第 6 步：为钱包充值

设置完成后，智能体会显示你的钱包地址。确认地址无误后，从其他钱包或交易所转入资金。你可以随时向智能体查询：

Show my wallet address and balance.

转账前需了解两点：

• 余额按链计算。 请在你计划交易的链上充值。运行 mm chains list 查看支持的网络及各网络支持的功能（兑换、预测、永续合约）。

• 确认该链的覆盖范围。 在 支持的链 列表中，Transaction Shield 列标注为"No"的链不支持威胁扫描。Ethereum、Base、Arbitrum、Optimism 和 Polygon 均在覆盖范围内。

在首次交易前，运行 mm doctor，确认 authenticated 和 initialized 均显示 true。如有任一项为 false，请按照输出中的提示操作，然后再次运行。

第 7 步：完成首次交易

向智能体发起一笔小额兑换：

Swap 0.01 ETH to USDC on Base.

智能体会获取报价，向你展示路由和预计输出，确认后执行交易。如果想先进行低风险的热身操作，可以询问"What's my USDC balance?"或"What's the current price of ETH?"只读请求无需确认即可执行。

Guard 模式在初期会在两处请求你的操作。首次交易时，系统会提示你设置滚动 24 小时出金限额；超出白名单或该限额的操作将暂停并触发双重验证。智能体在你响应之前无法继续处理被标记的交易。如果你使用 Google 或邮箱登录，审批通知将以邮件链接形式发送；如果使用二维码登录，则以 MetaMask Mobile 推送通知形式发送（如未收到推送，请检查通知菜单）。

设置卡住了怎么办

首先运行 mm doctor。它会报告你的登录和初始化状态，并提示需要修复的问题。常见错误代码处理方法如下：

故障排查页面 涵盖了更多情况。

下一步

完成首次交易后，选择你感兴趣的资产类别。如需在 Hyperliquid 上进行杠杆仓位交易，请参阅 如何使用 MetaMask Agent Wallet 交易永续合约。如需进行同链兑换和跨链桥接，请参阅 如何兑换和桥接代币。如需使用 Polymarket，请参阅 如何交易预测市场。文档还涵盖了 收益金库 和 x402 支付 的相关内容。