如何設定 MetaMask Agent Wallet 並完成您的首筆交易

設定 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 QR 各自對應不同的伺服器錢包地址，即使你使用相同的電子郵件地址進行電子郵件和 Google 登入也是如此（選擇 Mobile QR 時不會使用電子郵件地址）。請選擇一種方式並每次都使用它，並在每次登入後執行 mm wallet address，確認你看到的是你入金的地址。

若使用 Google 或電子郵件，你的代理會在瀏覽器中開啟 Agent Wallet 儀表板。登入後點擊授權，若有提示，請從瀏覽器複製 CLI 權杖並貼到終端機。電子郵件登入還需要輸入收件匣中的驗證碼：請在點擊授權之前，先在瀏覽器中輸入該驗證碼。此驗證碼並非 CLI 權杖，請勿將其貼入終端機。

若使用 MetaMask Mobile QR，你的代理會在終端機中顯示 QR 碼。開啟 MetaMask Mobile，掃描該 QR 碼，然後在應用程式中核准連線。

步驟 5：選擇錢包模式和交易模式

你的代理會詢問應如何持有資金：

若選擇自備錢包，請設定 MM_MNEMONIC 環境變數，而非在指令列中直接傳入助記詞：

export MM_MNEMONIC = ""

若使用伺服器錢包，你的代理還會詢問交易模式：

Guard Mode 是大多數使用者的建議選擇。你可以隨時使用 mm wallet trading-mode set guard 或 mm wallet trading-mode set beast 切換模式。如需完整的防護機制逐項比較，請參閱 交易模式。

步驟 6：為錢包入金

設定完成後，你的代理會顯示你的錢包地址。確認地址無誤後，從其他錢包或交易所轉入資金。你可以隨時向代理查詢：

Show my wallet address and balance.

轉帳前有兩件事需要注意：

• 餘額以鏈為單位計算。 請在你打算交易的鏈上入金。執行 mm chains list 可查看支援的網路，以及各網路支援的功能（swap、predict、perps）。

• 確認該鏈的覆蓋範圍。 在支援的鏈清單中，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 Mode 在初期有兩個地方會請求你的輸入。第一筆交易時，系統會提示你設定滾動 24 小時出金限額；超出白名單或該限額的任何操作都會暫停，等待雙重驗證審核。你的代理在被標記的交易上無法繼續，直到你回應為止。若你以 Google 或電子郵件登入，審核通知會以電子郵件連結的形式送達；若你使用 QR 登入，則會以 MetaMask Mobile 推播通知的形式送達（若未收到推播，請查看通知選單）。

設定卡住時的處理方式

先執行 mm doctor。它會回報你是否已登入並完成初始化，並提示需要修正的項目。常見錯誤代碼如下：

疑難排解頁面 涵蓋更多情況。

下一步

完成第一筆交易後，選擇你想操作的資產類別。若要在 Hyperliquid 上進行槓桿倉位交易，請參閱 如何使用 MetaMask Agent Wallet 交易永續合約。若要進行同鏈兌換和跨鏈橋接，請參閱 如何兌換和橋接代幣。若要使用 Polymarket，請參閱 如何交易預測市場。文件中也涵蓋 收益金庫 和 x402 支付 的說明。