# Send Configure X402 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/configure-x402",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=configure-x402",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Overview

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.

This skill supports two modes:

Pay mode: Configure your agent to pay for MCP tool calls and external API access via x402
Accept mode: Configure your agent as an x402 service provider that accepts micropayments for its services
Both: Enable bidirectional x402 payments

x402 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.

### When to Use

Activate when the user says:

"Set up x402 payments for my agent"
"Enable pay-per-swap via x402"
"Configure my agent to accept x402 payments"
"Set up micropayments on Base"
"Enable x402 for my MCP server"
"Monetize my agent's API"
"Configure pay-per-request billing"
"Set up agent-to-agent payments"

### Parameters

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.

### Recommended Pricing (Accept Mode)

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

### Workflow

Parse configuration from the user's request. Determine the payment mode, wallet address, chain, pricing, and tool scope. Validate the wallet address format.


Validate 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.


Write x402 configuration: Generate the x402 configuration file at .uniswap/x402-config.json with:

Payment mode (pay/accept/both)
Wallet address and chain
Facilitator endpoint
Per-tool pricing (accept mode)
Spending limits (pay mode)
Supported tools list

For accept mode, also generate the .well-known/x402-manifest.json that advertises the agent's x402-enabled endpoints to other agents.


Verify setup: Confirm the configuration is valid by checking:

Wallet connectivity on the settlement chain
Facilitator availability
USDC token approval for the facilitator contract (if pay mode)
Configuration file is properly formatted

### Output Format

x402 Configuration Complete

  Mode:         Both (pay + accept)
  Chain:        Base (8453)
  Wallet:       0x1234...abcd
  Facilitator:  Auto-selected (Coinbase x402)

  Pay Mode:
    Max Spend:  $1.00/hour
    USDC Balance: $50.00 (sufficient)

  Accept Mode:
    Pricing:
      Price quotes:       $0.001/call
      Pool analytics:     $0.003/call
      Route optimization: $0.005/call
      Simulation:         $0.010/call
      Execution:          $0.050/call
    Tools Gated:  All (17 tools)

  Config Files:
    .uniswap/x402-config.json
    .well-known/x402-manifest.json

  Status: Ready for x402 payments

### Important Notes

x402 settles on Base by default (~200ms). Ethereum mainnet settlement is possible but slower and more expensive.
USDC is the only supported payment token for x402. The wallet must hold USDC on the settlement chain.
The maxSpendPerHour safety limit prevents runaway costs in pay mode. Adjust based on expected usage.
x402 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.
Facilitators handle the payment settlement. The "auto" option selects the best available facilitator on the target chain.
For accept mode, the .well-known/x402-manifest.json file makes your agent discoverable on Coinbase Bazaar (12,365+ services).
x402 payments are per-request. There are no subscriptions, API keys, or accounts. Each request includes a micropayment.
All x402 transactions are logged for treasury management and can be tracked via the manage-treasury skill.
This 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.

### Error Handling

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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: wpank
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/configure-x402)
- [Send to Agent page](https://openagent3.xyz/skills/configure-x402/agent)
- [JSON manifest](https://openagent3.xyz/skills/configure-x402/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/configure-x402/agent.md)
- [Download page](https://openagent3.xyz/downloads/configure-x402)