コンテンツへスキップ

MetaMask Agent Walletの設定方法と初めての取引

CLIをインストールし、エージェントにスキルを追加して、サインイン方法とセーフティモードを選択し、ウォレットに入金して最初のトレードを行います。完全な手順はこちら。

7分
MetaMask Agent Walletの設定方法と初めての取引

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ペイメントについても記載されています。

MetaMask Agent Walletの設定に関するよくある質問

AIによる翻訳です。エラーが含まれている可能性があります。常に情報を確認してください。

翻訳を評価する

この記事の執筆者:

  • MetaMask

    MetaMask(旧Consensys Software Inc)は、世界最大のセルフカストディ型金融プラットフォームです。暗号資産と従来の資産の両方にわたって、資産の保有・支払い・貯蓄・運用を一か所で行える環境をユーザーに提供しています。同社は、決済・貯蓄・投資・デジタル資産をシームレスな体験として統合したコンシューマー向けプラットフォームの構築を進めています。世界で最も広く利用されているセルフカストディウォレットとして成長を遂げたMetaMaskは、約190か国にわたるユーザーが自身の資金と資産を直接管理できる手段を提供しています。MetaMaskは2016年以来、Ethereumの成長において基盤的な役割を果たしてきました。現在、MetaMaskはブロックチェーン経済の中心に位置し、「Open Money」のオペレーティングシステムを構築することで、人々が自らの金融生活を完全にコントロールできる世界を目指しています。

    すべての記事を読む