MetaMask Agent Walletのセットアップは3つのステップで完了します:mm CLIのインストール、AIエージェントへのスキルの追加、そしてプロンプトの貼り付けです。エージェントがサインイン方法と安全設定の選択をガイドします。ウォレットに資金を入金すると、自然言語のリクエストからトークンのスワップが可能になります。パープスと予測市場には独自の資金調達ステップがあり、それぞれのガイドで説明しています。このガイドでは、公式のクイックスタートに従い、インストールから最初のトレードまでを解説します。
これはセットアップガイドであり、概念の解説ではありません。エージェンティックウォレットとは何かについては、エージェンティックウォレットとはをご覧ください。トランザクションのライフサイクルとセキュリティパイプラインの仕組みについては、エージェンティックウォレットの仕組みとエージェンティックウォレットのセキュリティをご参照ください。
始める前に
以下が必要です:
Node.js 22.18以降。node --versionで確認してください。
Claude Code、Codex、Cursor、OpenClaw、Hermes Agentなど、スキルをサポートするAIエージェント。(スキルがない場合は、ステップ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:1つのプロンプトでセットアップを開始する
エージェントを開き、以下を貼り付けてください:
Set up MetaMask Agent Wallet: help me pick a sign-in method, wallet mode, and trading mode, then show my address.
エージェントが希望するサインイン方法を尋ね、セットアップコマンドを実行します。次の2つのステップでは、エージェントが確認を求める選択肢について説明します。
ターミナルを使用したい場合、またはスキルなしでエージェントを実行する場合は、mm doctor、mm login、mm initの順に実行し、最後にmm doctorを再度実行してください。各コマンドの詳細はCLIセットアップガイドをご覧ください。
ステップ4:1つの方法でサインインし、継続して使用する
方法 | サインイン方法 | 後で承認が届く場所 |
Google | ブラウザダッシュボードでGoogleで続行 | メールリンク |
メールパスワードレス | ブラウザダッシュボードでメールで続行 | メールリンク |
MetaMask Mobile QR | MetaMask MobileでQRコードをスキャン | MetaMask Mobileのプッシュ通知 |
Google、メール、MetaMask Mobile QRはそれぞれ異なるサーバーウォレットアドレスを読み込みます。メールとGoogleログインで同じアドレスを使用しても同様です(Mobile QRを選択した場合、メールアドレスは使用されません)。1つの方法を選択し、毎回同じ方法を使用してください。また、サインインのたびにmm wallet addressを実行して、資金を送金したアドレスと一致していることを確認してください。
Googleまたはメールでサインインすると、エージェントがブラウザでAgent Walletダッシュボードを開きます。サインインしてAuthorizeをクリックし、プロンプトが表示された場合はブラウザからCLIトークンをコピーしてターミナルに貼り付けてください。メールサインインでは、受信トレイからの確認コードが追加されます:Authorizeをクリックする前にブラウザでコードを入力してください。このコードはCLIトークンではないため、ターミナルに貼り付けないでください。
MetaMask Mobile QRの場合、エージェントがターミナルにQRコードを表示します。MetaMask Mobileを開き、コードをスキャンして、アプリで接続を承認してください。
ステップ5:ウォレットモードとトレーディングモードを選択する
エージェントが資金の管理方法を確認します:
ウォレットモード | 最適な用途 |
サーバーウォレット | ほとんどのユーザー向け。キーはTEEで安全に保管されるため、エージェントはメインウォレットにアクセスすることなく専用ウォレットを使用できます。 |
自分のウォレットを持ち込む | すでにシードフレーズを持っており、キーを自分のマシンに保管したい場合。 |
自分のウォレットを持ち込む場合は、コマンドラインでフレーズを渡すのではなく、MM_MNEMONIC環境変数を設定してください:
export MM_MNEMONIC = ""
サーバーウォレットの場合、エージェントはトレーディングモードも確認します:
トレーディングモード | 最適な用途 |
Guard Mode(推奨) | 日常的な使用。許可リスト、24時間のローリング出金制限、およびポリシー外の操作に対するあなたの承認が必要です。 |
Beast Mode | 制限を少なくしたいパワーユーザー向け。脅威スキャンは有効のままで、悪意のあるトランザクションは引き続き承認が必要です。 |
Guard Modeはほとんどのユーザーに推奨される選択肢です。後からmm wallet trading-mode set guardまたはmm wallet trading-mode set beastでモードを変更できます。ガードレールごとの詳細な比較については、トレーディングモードをご覧ください。
ステップ6:ウォレットに資金を入金する
セットアップが完了すると、エージェントがウォレットアドレスを表示します。期待通りのアドレスと一致していることを確認し、別のウォレットまたは取引所から資金を送金してください。いつでもエージェントに確認できます:
Show my wallet address and balance.
送金前に知っておくべき2点:
残高はチェーンごとに管理されます。 トレードする予定のチェーンに資金を入金してください。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 Modeでは、初期段階で2か所での入力が求められます。最初のトランザクション時に24時間のローリング出金制限を設定するよう求められ、許可リストまたはその制限を超えるものは二要素承認のために一時停止されます。フラグが立てられたトランザクションは、あなたが応答するまでエージェントは処理を進めることができません。Googleまたはメールでサインインしていればメールリンクとして、QRを使用した場合はMetaMask Mobileのプッシュ通知として承認が届きます(プッシュ通知が表示されない場合は通知メニューを確認してください)。
セットアップが停止した場合
まずmm doctorを実行してください。サインイン済みかどうかと初期化状態を報告し、修正すべき内容のヒントを表示します。一般的なエラーコードについては:
表示内容 | 対処方法 |
UNSUPPORTED_NODE
| Node.js 22.18以降にアップグレードし、mm doctorを再度実行してください。 |
NOT_INITIALIZED
| mm initを実行し、その後mm doctorを実行してください。
|
PAIRING_EXPIRED、INVALID_OTP、またはブラウザサインイン中のターミナルタイムアウト
| mm login browserを再度実行してください。Authorizeの後に表示されるCLIトークンをすぐに貼り付けてください。メール確認コードは貼り付けないでください。
|
QRサインイン中のMWP_TIMEOUTまたはMWP_CANCELLED | mm login qrを再度実行し、新しいコードをスキャンして、速やかに承認してください。
|
再サインイン後に異なるウォレットアドレスが表示される | 異なるサインイン方法を使用しています。mm logoutを実行し、ウォレットに資金を入金した際に使用した方法でサインインしてください。 |
トラブルシューティングページでは、さらに多くのケースを説明しています。
次のステップ
最初のトレードが完了したら、アセットクラスを選択してください。Hyperliquidでのレバレッジポジションについては、MetaMask Agent Walletでパープスをトレードする方法をご覧ください。同一チェーンのスワップとクロスチェーンブリッジについては、トークンのスワップとブリッジの方法をご覧ください。Polymarketについては、予測市場のトレード方法をご覧ください。ドキュメントにはイールドボールトとx402ペイメントについても記載されています。
サーバーウォレットを使用する場合は異なります。このモードでは、鍵はサーバー側の信頼できる実行環境で管理・保護されるため、エージェントがメインウォレットにアクセスすることはなく、セルフカストディが維持されます。Bring Your Own Walletを使用する場合は、BIP-39ニーモニックを提供し、鍵はご自身のマシン上に保管されます。MM_MNEMONIC環境変数で設定してください。コマンドラインフラグとして使用しないでください。
Claude Code、Codex、Cursor、OpenClaw、Hermes Agentなど、スキルをサポートするハーネス。スキルがない場合でも、Agent Walletは引き続き使用可能です。その場合、エージェントは--helpコマンドを使用してCLIの操作方法を確認するフォールバック動作を行います。
必ずしもそうとは限りません。ウォレットのネイティブ残高でガス代を賄えない場合、CLIはサポートされているチェーン上で、ERC-20送金および対象となるスワップの見積もりをガスレスリレー経由でルーティングします。ネイティブトークンの送金は対象外であり、一部のフローでは引き続きネイティブガスが必要です。たとえば、予測市場へのデポジットにはPolygon上でPOLが必要です。mm chains list --jsonを実行すると、各チェーンのrelaySupportedフラグが表示されます。
はい、mm wallet trading-mode set guardまたはmm wallet trading-mode set beastで設定できます。変更には二要素承認が必要で、Beast Modeへの切り替え時にはまず確認が求められます。
mm doctorを実行してください。authenticatedとinitializedがどちらもtrueになっている必要があります。次に、mm wallet addressを実行して入金したアドレスを確認し、mm wallet balanceを実行して資金が届いていることを確認してください。