{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agentic-x402",
    "name": "Agentic X402",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ya7ya/agentic-x402",
    "canonicalUrl": "https://clawhub.ai/ya7ya/agentic-x402",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/agentic-x402",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentic-x402",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "bin/cli.ts",
      "bin/x402.js",
      "config/example.env",
      "package.json"
    ],
    "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-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/agentic-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/agentic-x402",
    "agentPageUrl": "https://openagent3.xyz/skills/agentic-x402/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agentic-x402/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agentic-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": "x402 Agent Skill",
        "body": "Pay for x402-gated APIs and content using USDC on Base. This skill enables agents to autonomously make crypto payments when accessing paid web resources."
      },
      {
        "title": "Quick Reference",
        "body": "CommandDescriptionx402 setupCreate or configure walletx402 balanceCheck USDC and ETH balancesx402 pay <url>Pay for a gated resourcex402 fetch <url>Fetch with auto-paymentx402 create-linkCreate payment link (seller)x402 link-info <addr>Get payment link details"
      },
      {
        "title": "Installation",
        "body": "npm i -g agentic-x402\n\nOnce installed, the x402 command is available globally:\n\nx402 --help\nx402 --version"
      },
      {
        "title": "Setup",
        "body": "Run the interactive setup to create a new wallet:\n\nx402 setup\n\nThis will:\n\nGenerate a new wallet (recommended) or accept an existing key\nSave configuration to ~/.x402/.env\nDisplay your wallet address for funding\n\nImportant: Back up your private key immediately after setup!"
      },
      {
        "title": "Manual Configuration",
        "body": "Alternatively, set the environment variable directly:\n\nexport EVM_PRIVATE_KEY=0x...your_private_key...\n\nOr create a config file:\n\nmkdir -p ~/.x402\necho \"EVM_PRIVATE_KEY=0x...\" > ~/.x402/.env\nchmod 600 ~/.x402/.env\n\nVerify setup:\n\nx402 balance"
      },
      {
        "title": "When you encounter HTTP 402 Payment Required",
        "body": "Use x402 pay to make the payment and access the content:\n\nx402 pay https://api.example.com/paid-endpoint\n\nThe command will:\n\nCheck payment requirements\nVerify amount is within limits\nProcess the payment\nReturn the gated content"
      },
      {
        "title": "Automatic payment with fetch",
        "body": "Use x402 fetch for seamless payment handling:\n\nx402 fetch https://api.example.com/data --json\n\nThis wraps fetch with x402 payment handling - if the resource requires payment, it's handled automatically."
      },
      {
        "title": "Payment limits",
        "body": "By default, payments are limited to $10 USD. Override with --max:\n\nx402 pay https://expensive-api.com/data --max 50\n\nOr set globally:\n\nexport X402_MAX_PAYMENT_USD=25"
      },
      {
        "title": "Dry run",
        "body": "Preview payment without executing:\n\nx402 pay https://api.example.com/data --dry-run"
      },
      {
        "title": "Creating Payment Links (Seller)",
        "body": "Create payment links to monetize your own content using x402-links-server:"
      },
      {
        "title": "Setup for link creation",
        "body": "Add to .env:\n\nX402_LINKS_API_URL=https://your-x402-links-server.com"
      },
      {
        "title": "Create a link",
        "body": "Gate a URL:\n\nx402 create-link --name \"Premium API\" --price 1.00 --url https://api.example.com/premium\n\nGate text content:\n\nx402 create-link --name \"Secret\" --price 0.50 --text \"The secret message...\"\n\nWith webhook notification:\n\nx402 create-link --name \"Guide\" --price 5.00 --url https://mysite.com/guide --webhook https://mysite.com/payment-hook"
      },
      {
        "title": "Get link info",
        "body": "x402 link-info 0x1234...5678\nx402 link-info https://21.cash/pay/0x1234...5678"
      },
      {
        "title": "x402 balance",
        "body": "Check wallet balances.\n\nx402 balance [--json] [--full]\n\nFlagDescriptionDefault--jsonOutput as JSON (address, network, chainId, balances)—--fullShow full wallet address instead of truncated—-h, --helpShow help—"
      },
      {
        "title": "x402 pay",
        "body": "Pay for an x402-gated resource.\n\nx402 pay <url> [options]\n\nFlagDescriptionDefault<url>The URL of the x402-gated resource (positional)required--methodHTTP methodGET--bodyRequest body (for POST/PUT requests)—--headerAdd custom header (can be used multiple times)—--maxMaximum payment in USD (overrides config)from config--dry-runShow payment details without paying—-h, --helpShow help—"
      },
      {
        "title": "x402 fetch",
        "body": "Fetch with automatic payment.\n\nx402 fetch <url> [options]\n\nFlagDescriptionDefault<url>The URL to fetch (positional)required--methodHTTP methodGET--bodyRequest body (for POST/PUT)—--headerAdd header as \"Key: Value\"—--jsonOutput as JSON only (for piping to other tools)—--rawOutput raw response body only (no headers or status)—-h, --helpShow help—"
      },
      {
        "title": "x402 create-link",
        "body": "Create a payment link.\n\nx402 create-link --name <name> --price <usd> [options]\n\nFlagDescriptionDefault--nameName of the payment linkrequired--pricePrice in USD (e.g., \"5.00\" or \"0.10\")required--urlURL to gate behind payment—--textText content to gate behind payment—--descDescription of the link—--webhookWebhook URL for payment notifications—--jsonOutput as JSON—-h, --helpShow help—\n\nNote: Either --url or --text is required. The link is deployed as a smart contract on Base."
      },
      {
        "title": "x402 link-info",
        "body": "Get payment link details.\n\nx402 link-info <router-address> [--json]\n\nFlagDescriptionDefault<address>Router contract address or full payment URL (positional)required--jsonOutput as JSON—-h, --helpShow help—"
      },
      {
        "title": "Environment Variables",
        "body": "VariableDescriptionDefaultEVM_PRIVATE_KEYWallet private key (0x-prefixed)requiredX402_NETWORKmainnet (Base, chain 8453) or testnet (Base Sepolia, chain 84532)mainnetX402_MAX_PAYMENT_USDSafety limit — payments exceeding this are rejected unless --max is used10X402_FACILITATOR_URLCustom facilitator URLCoinbase (mainnet) / x402.org (testnet)X402_SLIPPAGE_BPSSlippage tolerance in basis points (100 bps = 1%)50X402_VERBOSEEnable verbose logging (1 = on, 0 = off)0X402_LINKS_API_URLBase URL of x402-links-server (e.g., https://21.cash)—"
      },
      {
        "title": "Supported Networks",
        "body": "NetworkChain IDCAIP-2 IDBase Mainnet8453eip155:8453Base Sepolia84532eip155:84532"
      },
      {
        "title": "Payment Token",
        "body": "All payments use USDC (USD Coin) on the selected network.\n\nBase Mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\nBase Sepolia: 0x036CbD53842c5426634e7929541eC2318f3dCF7e"
      },
      {
        "title": "How x402 Works",
        "body": "Client requests a resource\nServer responds with 402 Payment Required + payment details\nClient signs a payment authorization (USDC transfer)\nClient retries request with payment signature\nServer verifies payment via facilitator\nServer settles payment on-chain\nServer returns the gated content\n\nThe x402 protocol is gasless for buyers - the facilitator sponsors gas fees."
      },
      {
        "title": "\"Missing required environment variable: EVM_PRIVATE_KEY\"",
        "body": "Set your wallet private key:\n\nexport EVM_PRIVATE_KEY=0x...\n\nOr create a .env file in your working directory, or install globally and use ~/.x402/.env."
      },
      {
        "title": "\"Payment exceeds max limit\"",
        "body": "Increase the limit:\n\nx402 pay https://... --max 50"
      },
      {
        "title": "Low balance warnings",
        "body": "Fund your wallet with:\n\nUSDC for payments\nETH for gas (small amount, ~0.001 ETH)"
      },
      {
        "title": "Network mismatch",
        "body": "Ensure your wallet has funds on the correct network:\n\nX402_NETWORK=mainnet → Base mainnet\nX402_NETWORK=testnet → Base Sepolia"
      },
      {
        "title": "Backup Your Private Key",
        "body": "Your private key is stored in ~/.x402/.env. If lost, your funds cannot be recovered."
      },
      {
        "title": "Recommended Backup Methods",
        "body": "Password Manager (Recommended)\n\nStore in 1Password, Bitwarden, or similar\nCreate a secure note with your private key\nTag it for easy retrieval\n\n\n\nEncrypted File\n# Encrypt with GPG\ngpg -c ~/.x402/.env\n# Creates ~/.x402/.env.gpg - store this backup securely\n\n\n\nPaper Backup (for larger amounts)\n\nWrite down the private key\nStore in a safe or safety deposit box\nNever store digitally unencrypted"
      },
      {
        "title": "View Your Private Key",
        "body": "cat ~/.x402/.env | grep EVM_PRIVATE_KEY"
      },
      {
        "title": "Recovery",
        "body": "To restore from backup:\n\nmkdir -p ~/.x402\necho \"EVM_PRIVATE_KEY=0x...your_backed_up_key...\" > ~/.x402/.env\nchmod 600 ~/.x402/.env\nx402 balance  # verify"
      },
      {
        "title": "Security Best Practices",
        "body": "Use a dedicated wallet — Never use your main wallet with automated agents\nLimit funds — Only transfer what you need for payments\nSet payment limits — Configure X402_MAX_PAYMENT_USD to cap exposure\nTest first — Use X402_NETWORK=testnet with test tokens before mainnet\nProtect the config — ~/.x402/.env has 600 permissions; keep it that way\nNever share — Your private key gives full access to your wallet"
      },
      {
        "title": "Links",
        "body": "x402 Protocol Docs\nx402 GitHub\nnpm: agentic-x402\nBase Network"
      }
    ],
    "body": "x402 Agent Skill\n\nPay for x402-gated APIs and content using USDC on Base. This skill enables agents to autonomously make crypto payments when accessing paid web resources.\n\nQuick Reference\nCommand\tDescription\nx402 setup\tCreate or configure wallet\nx402 balance\tCheck USDC and ETH balances\nx402 pay <url>\tPay for a gated resource\nx402 fetch <url>\tFetch with auto-payment\nx402 create-link\tCreate payment link (seller)\nx402 link-info <addr>\tGet payment link details\nInstallation\nnpm i -g agentic-x402\n\n\nOnce installed, the x402 command is available globally:\n\nx402 --help\nx402 --version\n\nSetup\n\nRun the interactive setup to create a new wallet:\n\nx402 setup\n\n\nThis will:\n\nGenerate a new wallet (recommended) or accept an existing key\nSave configuration to ~/.x402/.env\nDisplay your wallet address for funding\n\nImportant: Back up your private key immediately after setup!\n\nManual Configuration\n\nAlternatively, set the environment variable directly:\n\nexport EVM_PRIVATE_KEY=0x...your_private_key...\n\n\nOr create a config file:\n\nmkdir -p ~/.x402\necho \"EVM_PRIVATE_KEY=0x...\" > ~/.x402/.env\nchmod 600 ~/.x402/.env\n\n\nVerify setup:\n\nx402 balance\n\nPaying for Resources\nWhen you encounter HTTP 402 Payment Required\n\nUse x402 pay to make the payment and access the content:\n\nx402 pay https://api.example.com/paid-endpoint\n\n\nThe command will:\n\nCheck payment requirements\nVerify amount is within limits\nProcess the payment\nReturn the gated content\nAutomatic payment with fetch\n\nUse x402 fetch for seamless payment handling:\n\nx402 fetch https://api.example.com/data --json\n\n\nThis wraps fetch with x402 payment handling - if the resource requires payment, it's handled automatically.\n\nPayment limits\n\nBy default, payments are limited to $10 USD. Override with --max:\n\nx402 pay https://expensive-api.com/data --max 50\n\n\nOr set globally:\n\nexport X402_MAX_PAYMENT_USD=25\n\nDry run\n\nPreview payment without executing:\n\nx402 pay https://api.example.com/data --dry-run\n\nCreating Payment Links (Seller)\n\nCreate payment links to monetize your own content using x402-links-server:\n\nSetup for link creation\n\nAdd to .env:\n\nX402_LINKS_API_URL=https://your-x402-links-server.com\n\nCreate a link\n\nGate a URL:\n\nx402 create-link --name \"Premium API\" --price 1.00 --url https://api.example.com/premium\n\n\nGate text content:\n\nx402 create-link --name \"Secret\" --price 0.50 --text \"The secret message...\"\n\n\nWith webhook notification:\n\nx402 create-link --name \"Guide\" --price 5.00 --url https://mysite.com/guide --webhook https://mysite.com/payment-hook\n\nGet link info\nx402 link-info 0x1234...5678\nx402 link-info https://21.cash/pay/0x1234...5678\n\nCommand Reference\nx402 balance\n\nCheck wallet balances.\n\nx402 balance [--json] [--full]\n\nFlag\tDescription\tDefault\n--json\tOutput as JSON (address, network, chainId, balances)\t—\n--full\tShow full wallet address instead of truncated\t—\n-h, --help\tShow help\t—\nx402 pay\n\nPay for an x402-gated resource.\n\nx402 pay <url> [options]\n\nFlag\tDescription\tDefault\n<url>\tThe URL of the x402-gated resource (positional)\trequired\n--method\tHTTP method\tGET\n--body\tRequest body (for POST/PUT requests)\t—\n--header\tAdd custom header (can be used multiple times)\t—\n--max\tMaximum payment in USD (overrides config)\tfrom config\n--dry-run\tShow payment details without paying\t—\n-h, --help\tShow help\t—\nx402 fetch\n\nFetch with automatic payment.\n\nx402 fetch <url> [options]\n\nFlag\tDescription\tDefault\n<url>\tThe URL to fetch (positional)\trequired\n--method\tHTTP method\tGET\n--body\tRequest body (for POST/PUT)\t—\n--header\tAdd header as \"Key: Value\"\t—\n--json\tOutput as JSON only (for piping to other tools)\t—\n--raw\tOutput raw response body only (no headers or status)\t—\n-h, --help\tShow help\t—\nx402 create-link\n\nCreate a payment link.\n\nx402 create-link --name <name> --price <usd> [options]\n\nFlag\tDescription\tDefault\n--name\tName of the payment link\trequired\n--price\tPrice in USD (e.g., \"5.00\" or \"0.10\")\trequired\n--url\tURL to gate behind payment\t—\n--text\tText content to gate behind payment\t—\n--desc\tDescription of the link\t—\n--webhook\tWebhook URL for payment notifications\t—\n--json\tOutput as JSON\t—\n-h, --help\tShow help\t—\n\nNote: Either --url or --text is required. The link is deployed as a smart contract on Base.\n\nx402 link-info\n\nGet payment link details.\n\nx402 link-info <router-address> [--json]\n\nFlag\tDescription\tDefault\n<address>\tRouter contract address or full payment URL (positional)\trequired\n--json\tOutput as JSON\t—\n-h, --help\tShow help\t—\nEnvironment Variables\nVariable\tDescription\tDefault\nEVM_PRIVATE_KEY\tWallet private key (0x-prefixed)\trequired\nX402_NETWORK\tmainnet (Base, chain 8453) or testnet (Base Sepolia, chain 84532)\tmainnet\nX402_MAX_PAYMENT_USD\tSafety limit — payments exceeding this are rejected unless --max is used\t10\nX402_FACILITATOR_URL\tCustom facilitator URL\tCoinbase (mainnet) / x402.org (testnet)\nX402_SLIPPAGE_BPS\tSlippage tolerance in basis points (100 bps = 1%)\t50\nX402_VERBOSE\tEnable verbose logging (1 = on, 0 = off)\t0\nX402_LINKS_API_URL\tBase URL of x402-links-server (e.g., https://21.cash)\t—\nSupported Networks\nNetwork\tChain ID\tCAIP-2 ID\nBase Mainnet\t8453\teip155:8453\nBase Sepolia\t84532\teip155:84532\nPayment Token\n\nAll payments use USDC (USD Coin) on the selected network.\n\nBase Mainnet: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\nBase Sepolia: 0x036CbD53842c5426634e7929541eC2318f3dCF7e\nHow x402 Works\nClient requests a resource\nServer responds with 402 Payment Required + payment details\nClient signs a payment authorization (USDC transfer)\nClient retries request with payment signature\nServer verifies payment via facilitator\nServer settles payment on-chain\nServer returns the gated content\n\nThe x402 protocol is gasless for buyers - the facilitator sponsors gas fees.\n\nTroubleshooting\n\"Missing required environment variable: EVM_PRIVATE_KEY\"\n\nSet your wallet private key:\n\nexport EVM_PRIVATE_KEY=0x...\n\n\nOr create a .env file in your working directory, or install globally and use ~/.x402/.env.\n\n\"Payment exceeds max limit\"\n\nIncrease the limit:\n\nx402 pay https://... --max 50\n\nLow balance warnings\n\nFund your wallet with:\n\nUSDC for payments\nETH for gas (small amount, ~0.001 ETH)\nNetwork mismatch\n\nEnsure your wallet has funds on the correct network:\n\nX402_NETWORK=mainnet → Base mainnet\nX402_NETWORK=testnet → Base Sepolia\nBackup Your Private Key\n\nYour private key is stored in ~/.x402/.env. If lost, your funds cannot be recovered.\n\nRecommended Backup Methods\n\nPassword Manager (Recommended)\n\nStore in 1Password, Bitwarden, or similar\nCreate a secure note with your private key\nTag it for easy retrieval\n\nEncrypted File\n\n# Encrypt with GPG\ngpg -c ~/.x402/.env\n# Creates ~/.x402/.env.gpg - store this backup securely\n\n\nPaper Backup (for larger amounts)\n\nWrite down the private key\nStore in a safe or safety deposit box\nNever store digitally unencrypted\nView Your Private Key\ncat ~/.x402/.env | grep EVM_PRIVATE_KEY\n\nRecovery\n\nTo restore from backup:\n\nmkdir -p ~/.x402\necho \"EVM_PRIVATE_KEY=0x...your_backed_up_key...\" > ~/.x402/.env\nchmod 600 ~/.x402/.env\nx402 balance  # verify\n\nSecurity Best Practices\nUse a dedicated wallet — Never use your main wallet with automated agents\nLimit funds — Only transfer what you need for payments\nSet payment limits — Configure X402_MAX_PAYMENT_USD to cap exposure\nTest first — Use X402_NETWORK=testnet with test tokens before mainnet\nProtect the config — ~/.x402/.env has 600 permissions; keep it that way\nNever share — Your private key gives full access to your wallet\nLinks\nx402 Protocol Docs\nx402 GitHub\nnpm: agentic-x402\nBase Network"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ya7ya/agentic-x402",
    "publisherUrl": "https://clawhub.ai/ya7ya/agentic-x402",
    "owner": "ya7ya",
    "version": "0.2.6",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agentic-x402",
    "downloadUrl": "https://openagent3.xyz/downloads/agentic-x402",
    "agentUrl": "https://openagent3.xyz/skills/agentic-x402/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agentic-x402/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agentic-x402/agent.md"
  }
}