{
  "schemaVersion": "1.0",
  "item": {
    "slug": "configure-x402",
    "name": "Configure X402",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/wpank/configure-x402",
    "canonicalUrl": "https://clawhub.ai/wpank/configure-x402",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/configure-x402",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=configure-x402",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/configure-x402"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/configure-x402",
    "agentPageUrl": "https://openagent3.xyz/skills/configure-x402/agent",
    "manifestUrl": "https://openagent3.xyz/skills/configure-x402/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/configure-x402/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "Configures the x402 HTTP-native payment protocol for agent-to-agent micropayments settled on Base. x402 uses the HTTP 402 \"Payment Required\" status code to enable pay-per-request billing — agents pay fractions of a cent per API call in USDC, with ~200ms settlement, no API keys, no accounts, and no subscriptions.\n\nThis skill supports two modes:\n\nPay mode: Configure your agent to pay for MCP tool calls and external API access via x402\nAccept mode: Configure your agent as an x402 service provider that accepts micropayments for its services\nBoth: Enable bidirectional x402 payments\n\nx402 has processed 100M+ agent-to-agent transactions across 80+ ecosystem projects (Feb 2026). It eliminates API key onboarding friction and creates revenue streams from every agent interaction."
      },
      {
        "title": "When to Use",
        "body": "Activate when the user says:\n\n\"Set up x402 payments for my agent\"\n\"Enable pay-per-swap via x402\"\n\"Configure my agent to accept x402 payments\"\n\"Set up micropayments on Base\"\n\"Enable x402 for my MCP server\"\n\"Monetize my agent's API\"\n\"Configure pay-per-request billing\"\n\"Set up agent-to-agent payments\""
      },
      {
        "title": "Parameters",
        "body": "ParameterRequiredDefaultDescriptionmodeNobothPayment mode: \"pay\" (pay for services), \"accept\" (accept payments), or \"both\"walletAddressYes--USDC wallet address on Base for sending/receiving paymentschainNobaseSettlement chain (Base recommended for ~200ms settlement)pricePerCallNosee pricingPrice per MCP tool call in USDC (for accept mode). Defaults to recommended pricing below.supportedToolsNoallWhich MCP tools to gate behind x402 payments (for accept mode). \"all\" or comma-separated list.maxSpendPerHourNo$1.00Maximum x402 spend per hour (for pay mode). Safety limit to prevent runaway costs.facilitatorNoautox402 facilitator to use. \"auto\" selects the best available facilitator on Base."
      },
      {
        "title": "Recommended Pricing (Accept Mode)",
        "body": "Tool CategoryPrice per CallExamplesPrice quotes$0.001get_token_price, get_quotePool analytics$0.003get_pool_info, get_pool_volume_historyRoute optimization$0.005get_pools_by_token_pair, search_tokensSimulation$0.01simulate_transactionExecution$0.05execute_swap, add_liquidity"
      },
      {
        "title": "Workflow",
        "body": "Parse configuration from the user's request. Determine the payment mode, wallet address, chain, pricing, and tool scope. Validate the wallet address format.\n\n\nValidate wallet: Verify the wallet address exists on the target chain and has a USDC balance (for pay mode) or can receive USDC (for accept mode). Check that the chain supports x402 settlement.\n\n\nWrite x402 configuration: Generate the x402 configuration file at .uniswap/x402-config.json with:\n\nPayment mode (pay/accept/both)\nWallet address and chain\nFacilitator endpoint\nPer-tool pricing (accept mode)\nSpending limits (pay mode)\nSupported tools list\n\nFor accept mode, also generate the .well-known/x402-manifest.json that advertises the agent's x402-enabled endpoints to other agents.\n\n\nVerify setup: Confirm the configuration is valid by checking:\n\nWallet connectivity on the settlement chain\nFacilitator availability\nUSDC token approval for the facilitator contract (if pay mode)\nConfiguration file is properly formatted"
      },
      {
        "title": "Output Format",
        "body": "x402 Configuration Complete\n\n  Mode:         Both (pay + accept)\n  Chain:        Base (8453)\n  Wallet:       0x1234...abcd\n  Facilitator:  Auto-selected (Coinbase x402)\n\n  Pay Mode:\n    Max Spend:  $1.00/hour\n    USDC Balance: $50.00 (sufficient)\n\n  Accept Mode:\n    Pricing:\n      Price quotes:       $0.001/call\n      Pool analytics:     $0.003/call\n      Route optimization: $0.005/call\n      Simulation:         $0.010/call\n      Execution:          $0.050/call\n    Tools Gated:  All (17 tools)\n\n  Config Files:\n    .uniswap/x402-config.json\n    .well-known/x402-manifest.json\n\n  Status: Ready for x402 payments"
      },
      {
        "title": "Important Notes",
        "body": "x402 settles on Base by default (~200ms). Ethereum mainnet settlement is possible but slower and more expensive.\nUSDC is the only supported payment token for x402. The wallet must hold USDC on the settlement chain.\nThe maxSpendPerHour safety limit prevents runaway costs in pay mode. Adjust based on expected usage.\nx402 uses the HTTP 402 \"Payment Required\" status code. When a client hits an x402-gated endpoint without payment, it receives a 402 response with payment instructions.\nFacilitators handle the payment settlement. The \"auto\" option selects the best available facilitator on the target chain.\nFor accept mode, the .well-known/x402-manifest.json file makes your agent discoverable on Coinbase Bazaar (12,365+ services).\nx402 payments are per-request. There are no subscriptions, API keys, or accounts. Each request includes a micropayment.\nAll x402 transactions are logged for treasury management and can be tracked via the manage-treasury skill.\nThis skill does not execute any on-chain transactions. It only generates configuration files. The actual x402 payment flow happens at runtime when the MCP server processes requests."
      },
      {
        "title": "Error Handling",
        "body": "ErrorUser-Facing MessageSuggested ActionInvalid wallet\"Invalid wallet address format.\"Provide a valid Ethereum address (0x...)No USDC balance\"Wallet has no USDC on [chain]. x402 payments require USDC.\"Fund the wallet with USDC on BaseChain not supported\"[chain] does not support x402 settlement.\"Use Base (recommended) or EthereumFacilitator unavailable\"No x402 facilitator available on [chain].\"Try Base (most facilitators available)Config write failed\"Could not write x402 configuration: [reason].\"Check file permissionsWallet not configured\"No agent wallet found. Set up a wallet first.\"Use setup-agent-wallet skill firstInvalid pricing\"Price per call must be positive and in USDC.\"Provide valid pricing values"
      }
    ],
    "body": "Configure x402\nOverview\n\nConfigures the x402 HTTP-native payment protocol for agent-to-agent micropayments settled on Base. x402 uses the HTTP 402 \"Payment Required\" status code to enable pay-per-request billing — agents pay fractions of a cent per API call in USDC, with ~200ms settlement, no API keys, no accounts, and no subscriptions.\n\nThis skill supports two modes:\n\nPay mode: Configure your agent to pay for MCP tool calls and external API access via x402\nAccept mode: Configure your agent as an x402 service provider that accepts micropayments for its services\nBoth: Enable bidirectional x402 payments\n\nx402 has processed 100M+ agent-to-agent transactions across 80+ ecosystem projects (Feb 2026). It eliminates API key onboarding friction and creates revenue streams from every agent interaction.\n\nWhen to Use\n\nActivate when the user says:\n\n\"Set up x402 payments for my agent\"\n\"Enable pay-per-swap via x402\"\n\"Configure my agent to accept x402 payments\"\n\"Set up micropayments on Base\"\n\"Enable x402 for my MCP server\"\n\"Monetize my agent's API\"\n\"Configure pay-per-request billing\"\n\"Set up agent-to-agent payments\"\nParameters\nParameter\tRequired\tDefault\tDescription\nmode\tNo\tboth\tPayment mode: \"pay\" (pay for services), \"accept\" (accept payments), or \"both\"\nwalletAddress\tYes\t--\tUSDC wallet address on Base for sending/receiving payments\nchain\tNo\tbase\tSettlement chain (Base recommended for ~200ms settlement)\npricePerCall\tNo\tsee pricing\tPrice per MCP tool call in USDC (for accept mode). Defaults to recommended pricing below.\nsupportedTools\tNo\tall\tWhich MCP tools to gate behind x402 payments (for accept mode). \"all\" or comma-separated list.\nmaxSpendPerHour\tNo\t$1.00\tMaximum x402 spend per hour (for pay mode). Safety limit to prevent runaway costs.\nfacilitator\tNo\tauto\tx402 facilitator to use. \"auto\" selects the best available facilitator on Base.\nRecommended Pricing (Accept Mode)\nTool Category\tPrice per Call\tExamples\nPrice quotes\t$0.001\tget_token_price, get_quote\nPool analytics\t$0.003\tget_pool_info, get_pool_volume_history\nRoute optimization\t$0.005\tget_pools_by_token_pair, search_tokens\nSimulation\t$0.01\tsimulate_transaction\nExecution\t$0.05\texecute_swap, add_liquidity\nWorkflow\n\nParse configuration from the user's request. Determine the payment mode, wallet address, chain, pricing, and tool scope. Validate the wallet address format.\n\nValidate wallet: Verify the wallet address exists on the target chain and has a USDC balance (for pay mode) or can receive USDC (for accept mode). Check that the chain supports x402 settlement.\n\nWrite x402 configuration: Generate the x402 configuration file at .uniswap/x402-config.json with:\n\nPayment mode (pay/accept/both)\nWallet address and chain\nFacilitator endpoint\nPer-tool pricing (accept mode)\nSpending limits (pay mode)\nSupported tools list\n\nFor accept mode, also generate the .well-known/x402-manifest.json that advertises the agent's x402-enabled endpoints to other agents.\n\nVerify setup: Confirm the configuration is valid by checking:\n\nWallet connectivity on the settlement chain\nFacilitator availability\nUSDC token approval for the facilitator contract (if pay mode)\nConfiguration file is properly formatted\nOutput Format\nx402 Configuration Complete\n\n  Mode:         Both (pay + accept)\n  Chain:        Base (8453)\n  Wallet:       0x1234...abcd\n  Facilitator:  Auto-selected (Coinbase x402)\n\n  Pay Mode:\n    Max Spend:  $1.00/hour\n    USDC Balance: $50.00 (sufficient)\n\n  Accept Mode:\n    Pricing:\n      Price quotes:       $0.001/call\n      Pool analytics:     $0.003/call\n      Route optimization: $0.005/call\n      Simulation:         $0.010/call\n      Execution:          $0.050/call\n    Tools Gated:  All (17 tools)\n\n  Config Files:\n    .uniswap/x402-config.json\n    .well-known/x402-manifest.json\n\n  Status: Ready for x402 payments\n\nImportant Notes\nx402 settles on Base by default (~200ms). Ethereum mainnet settlement is possible but slower and more expensive.\nUSDC is the only supported payment token for x402. The wallet must hold USDC on the settlement chain.\nThe maxSpendPerHour safety limit prevents runaway costs in pay mode. Adjust based on expected usage.\nx402 uses the HTTP 402 \"Payment Required\" status code. When a client hits an x402-gated endpoint without payment, it receives a 402 response with payment instructions.\nFacilitators handle the payment settlement. The \"auto\" option selects the best available facilitator on the target chain.\nFor accept mode, the .well-known/x402-manifest.json file makes your agent discoverable on Coinbase Bazaar (12,365+ services).\nx402 payments are per-request. There are no subscriptions, API keys, or accounts. Each request includes a micropayment.\nAll x402 transactions are logged for treasury management and can be tracked via the manage-treasury skill.\nThis skill does not execute any on-chain transactions. It only generates configuration files. The actual x402 payment flow happens at runtime when the MCP server processes requests.\nError Handling\nError\tUser-Facing Message\tSuggested Action\nInvalid wallet\t\"Invalid wallet address format.\"\tProvide a valid Ethereum address (0x...)\nNo USDC balance\t\"Wallet has no USDC on [chain]. x402 payments require USDC.\"\tFund the wallet with USDC on Base\nChain not supported\t\"[chain] does not support x402 settlement.\"\tUse Base (recommended) or Ethereum\nFacilitator unavailable\t\"No x402 facilitator available on [chain].\"\tTry Base (most facilitators available)\nConfig write failed\t\"Could not write x402 configuration: [reason].\"\tCheck file permissions\nWallet not configured\t\"No agent wallet found. Set up a wallet first.\"\tUse setup-agent-wallet skill first\nInvalid pricing\t\"Price per call must be positive and in USDC.\"\tProvide valid pricing values"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/wpank/configure-x402",
    "publisherUrl": "https://clawhub.ai/wpank/configure-x402",
    "owner": "wpank",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/configure-x402",
    "downloadUrl": "https://openagent3.xyz/downloads/configure-x402",
    "agentUrl": "https://openagent3.xyz/skills/configure-x402/agent",
    "manifestUrl": "https://openagent3.xyz/skills/configure-x402/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/configure-x402/agent.md"
  }
}