8月18日、AWSが「Build OpenClaw agents that transact with Amazon Bedrock AgentCore payments」と題した記事を公開した。AIエージェントが自律的にWeb APIへ支払いを行う「agentic payments」の実装パターンを、Amazon Bedrock AgentCore paymentsとOpenClawの統合を通じて詳解するチュートリアルだ。ウォレット認証情報をモデルに持たせることなく、どうセキュアな決済フローを構築するか——その設計判断の細部まで踏み込んだ内容となっている。
AIエージェントが「自分で支払う」時代
自律型AIエージェントがWeb APIやMCPサーバーを呼び出す際、HTTP 402 Payment Requiredレスポンスに直面することがある。人間がその都度承認に介入していては、エージェントの自律性が損なわれる。かといって、ウォレットの認証情報やセッション作成権限をモデルに直接持たせるのはセキュリティ上のリスクが大きい。
今回の記事はこの問題を解決するアーキテクチャパターンを、Amazon Bedrock AgentCore paymentsとOpenClaw(AIアシスタントフレームワーク)の統合を通じて実演するチュートリアルだ。
OpenClawはOpenClaw Foundationが主導するオープンソースのAIエージェントフレームワークで、プラグイン機構を通じてエージェントに外部能力を追加できる設計が特徴だ。MCP(Model Context Protocol)サーバーとの親和性が高く、agentic workflowの実行基盤として採用が広がっている。
設計の核心:「管理権限」と「実行権限」の分離
このアーキテクチャで最も重要な点は、人間が行う支払い管理と、モデルが実行する支払い処理を明確に分離していることだ。
- 人間(管理者)が行う操作:ウォレットのプロビジョニング、支払いセッションの作成、許可する受取先アドレスの登録、予算上限と有効期限の設定
- モデル(エージェント)が行える操作:承認済みセッション内での支払い実行のみ
モデルは新しいセッションを作成することも、既存セッションの予算を拡張することもできない。プロンプトインジェクションによって悪意のある入力がモデルを操作したとしても、受取先・資産・ネットワーク・1回あたりの上限・累積予算・有効期限の範囲内に被害が限定される設計だ。
モデルに公開されるツールは以下の2つのみに限定されている:
get_payment_session_status:設定済みの支払いセッションの状態確認get_paid_content:承認済みURLへのアクセスと支払い処理
セットアップ用コマンドやシェル操作ツールがモデルから見える状態になっていれば、パッケージが異なるか改ざんされている可能性があるとして、導入を中止するよう記事は明示的に警告している。
支払いフローの詳細
使用するプロトコルは**x402 v2**(HTTP 402ベースのプログラマティック決済プロトコル)だ。HTTP 402ステータスコードはかつて「Payment Required」として仕様に定義されながら長らく未使用のままだったが、近年のagentic payments文脈で実用的な決済シグナルとして注目されており、x402はその標準化を推進するプロトコルとして位置づけられている。ステーブルコイン(USDC)を使った少額決済(0.001 USDCなど)を、カード決済の最低手数料が障壁にならない形で実行できる。
典型的な支払いフローは以下のとおりだ:
- エージェントが
get_payment_session_statusでセッションが有効かを確認 get_paid_contentで対象URLにアクセス → HTTP 402レスポンスとx402チャレンジを受信- プラグインがチャレンジのオリジン・パスを要求URLと照合し、ネットワーク・資産・受取先・金額をポリシーと照合
ProcessPaymentを呼び出し、同一リクエストには同一の冪等性トークンを再利用(二重払い防止)- 署名済み認可の
validAfter時刻まで待機後、元のリクエストを支払い署名付きで再送 - レスポンスボディは10 KiB上限でキャップされ、
untrusted: trueフラグが付与されてモデルに返される
returnBodyをtrueにすると応答本文がエージェントに返されるが、コンテンツにプロンプトインジェクション指示が含まれるリスクがあるため、メタデータとダイジェストのみで十分なケースではfalseに設定することが推奨されている。
ウォレットと対応ネットワーク
AgentCore paymentsが対応するウォレットプロバイダーは現時点でCoinbase CDPとStripe(Privy経由)の2種類。いずれもステーブルコイン対応の組み込みウォレットを提供し、デビットカードによるファット入金も(提供地域次第で)対応する。
テスト環境はBase Sepolia(イーサリアムのL2チェーンであるBaseのテストネット)、本番はBaseを想定した構成が用意されている。EVM互換チェーンやSolanaへのカスタマイズも可能とされている。
実装手順の概要
# プラグインのインストール
openclaw plugins install clawhub:@aws/aws-agents-pay
# スキル情報の確認
openclaw skills info agents-pay
# インストール済みプラグインの検査(モデルに見えるツールの確認)
openclaw plugins inspect aws-agents-pay
# ゲートウェイの再起動
openclaw gateway restart
支払いポリシーの設定では、maxPaymentAmountAtomicで1回の支払い上限を指定する。USDCは小数点以下6桁の精度を持ち、100000が最小単位(atomic単位)での表現となるため、100000 = 0.10 USDCに相当する。初めて設定する際はこの桁数に注意が必要だ。
支払いセッションが利用不可・期限切れ・予算枯渇の場合、モデルは自力で回復できない。管理者が信頼された端末から新しいセッションを作成する必要がある。
OpenClaw Foundationのコメント
OpenClaw FoundationのPatrick Erichsen氏は次のようにコメントしている。
「支払いはOpenClawのプラグインがすでに行っていること——よく定義されたツールを通じてエージェントに新しい能力を与えること——の自然な拡張です。エージェントが自律的に動作する中でagentic paymentsがより重要になるにつれて、AWS AgentCoreとの連携をさらに深めていくことを楽しみにしています。」
— Patrick Erichsen、Member of Technical Staff(テクニカルスタッフ), OpenClaw Foundation
詳細はBuild OpenClaw agents that transact with Amazon Bedrock AgentCore paymentsを参照していただきたい。