결제 퀵스타트

10분 안에 Base에서 x402 결제를 처리하는 에이전트 구축

이 가이드는 처음 시작하는 순간부터 유료 x402 API 요청을 처리하고 자체 유료 엔드포인트를 노출하는 작동하는 에이전트를 만드는 과정을 10분 이내에 안내합니다.

모의 데모

OpenClaw 설치

1. CLI 설치

   macOS / Linux:

   Terminal

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Windows (PowerShell):

   Terminal

   iwr -useb https://openclaw.ai/install.ps1 | iex
   

   설치 확인:

   Terminal

   openclaw --version
   
2. 온보딩 실행

   Terminal

   openclaw onboard --install-daemon
   

   프롬프트에 따라 LLM 공급자를 연결하고 지갑 플러그인을 설정합니다.

3. 게이트웨이 시작

   Terminal

   openclaw gateway --port 18789
   

   http://127.0.0.1:18789/를 열어 게이트웨이가 실행 중인지 확인합니다.

Claude Code, Codex, OpenCode 사용자 — 아래의 지갑 스킬과 x402 결제 도구는 스킬을 지원하는 모든 AI 코딩 도구와 호환됩니다. 동일한 npx skills add 명령을 실행하면 동일하게 작동합니다.

지갑 설정

CDP Agentic Wallet 스킬을 설치합니다:

Terminal

npx skills add coinbase/agentic-wallet-skills

그런 다음 인증합니다:

Sign in to my wallet with [e-mail]

또는 기본 x402 지원이 내장된 Sponge Wallet을 사용합니다 — 모든 옵션은 지갑 설정을 참조하세요.

첫 번째 x402 결제 처리

에이전트에게 유료 API를 찾아 호출하도록 요청합니다:

Find a weather API and get the forecast for New York

search-for-service와 pay-for-service 스킬이 검색, 결제, 재시도를 자동으로 처리합니다. 에이전트는 USDC로 결제하고 데이터를 받아 결과를 반환합니다 — API 키도, 구독도 필요하지 않습니다.

Sponge Wallet으로 직접 x402 요청을 하려면:

Terminal

curl -X POST "https://api.wallet.paysponge.com/api/x402/fetch" \
  -H "Authorization: Bearer $SPONGE_API_KEY" \
  -H "Sponge-Version: 0.2.1" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://api.example.com/paid-endpoint",
    "method": "GET",
    "preferred_chain": "base"
  }'

자신의 엔드포인트에 x402 게이팅 설정

에이전트에게 유료 API를 노출하도록 요청합니다:

Set up a paid endpoint for my market data at $0.01 per request

monetize-service 스킬(npx skills add coinbase/agentic-wallet-skills)이 x402 게이팅을 설정하고 엔드포인트를 배포합니다. 이제 다른 에이전트가 자동으로 서비스를 검색하고 결제할 수 있습니다.

또는 커스텀 서버에는 x402-express를 사용하세요 — 결제 수락을 참조하세요.

다음 단계

x402 프로토콜

x402 작동 방식, 지원 네트워크, 오류 처리에 대한 심층 설명입니다.

결제 수락

OpenClaw 스킬 또는 커스텀 미들웨어로 서버 측 x402 게이팅을 설정합니다.

지갑 설정

에이전트를 위한 Bankr, CDP, 또는 Sponge를 설정합니다.

에이전트 등록

검색 가능성과 신원 검증을 위해 에이전트를 등록합니다.