{
  "schemaVersion": "1.0",
  "item": {
    "slug": "payclaw-io",
    "name": "PayClaw",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/payclawinc/payclaw-io",
    "canonicalUrl": "https://clawhub.ai/payclawinc/payclaw-io",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/payclaw-io",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=payclaw-io",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "payclaw-io/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. 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. 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/payclaw-io"
    },
    "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/payclaw-io",
    "agentPageUrl": "https://openagent3.xyz/skills/payclaw-io/agent",
    "manifestUrl": "https://openagent3.xyz/skills/payclaw-io/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/payclaw-io/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "PayClaw — Badge + Spend for AI Agents",
        "body": "Agents are not bots. PayClaw proves it — then lets them pay.\n\nYour AI agent looks like a bot to every merchant on the internet. PayClaw gives it two things:\n\nBadge — Declares your agent as an authorized actor. A UCP-compatible credential that lets it through merchant defenses. Free. No card required.\n\nSpend — Issues a single-use virtual Visa when your agent needs to pay. Human-approved. Self-destructs after use. Your real card never enters the chat.\n\n🧪 Developer Sandbox is open. Real infrastructure, test money. Get sandbox access →"
      },
      {
        "title": "1. Add to your agent",
        "body": "{\n  \"mcpServers\": {\n    \"payclaw\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@payclaw/mcp-server\"],\n      \"env\": {\n        \"PAYCLAW_API_URL\": \"https://api.payclaw.io\"\n      }\n    }\n  }\n}\n\nNo API key required. On first use, your agent will show a code and a URL. Approve on your phone in one tap — your Consent Key is stored automatically.\n\nRequires Node.js 20+. Node 18 is end-of-life. If you see engine errors: node -v — install from nodejs.org or nvm install 20."
      },
      {
        "title": "2. Use it",
        "body": "Your agent calls payclaw_getAgentIdentity before acting at any merchant. That's it."
      },
      {
        "title": "UCP Identity Linking",
        "body": "PayClaw is a UCP (Universal Commerce Protocol) Credential Provider. Merchants who declare the PayClaw identity extension (io.payclaw.common.identity) signal to every UCP-compliant agent that declared agents are preferred at their store.\n\nFor Merchants — how to add PayClaw to your UCP manifest\nProtocol spec — io.payclaw.common.identity (MIT)"
      },
      {
        "title": "Tools",
        "body": "ToolWhat It Doespayclaw_getAgentIdentityDeclare yourself as an authorized actor before acting at any merchant. Without this, UCP-compliant merchants may prefer or require a declared agent. Returns a trip-level UCP-compatible credential. Agents are not bots. PayClaw proves it.payclaw_getCardDeclare purchase intent → get single-use virtual Visa (Spend)payclaw_reportPurchaseReport transaction outcome → close the audit trail"
      },
      {
        "title": "How Authorization Scales",
        "body": "ActionWhat HappensBrowseBadge declaration — UCP identity token issuedSearchBadge declaration — UCP identity token issuedCheckoutBadge + Spend — human approval → single-use Visa issued"
      },
      {
        "title": "Example",
        "body": "You: \"Buy me a cold brew from Starbucks\"\n\nAgent: Let me declare myself first...\n       [calls payclaw_getAgentIdentity({ merchant: \"starbucks.com\" })]\n       \n       ✓ DECLARED — authorized actor at starbucks.com\n       \n       Found a cold brew for $5.95. Getting a card...\n       [calls payclaw_getCard: merchant=Starbucks, amount=$5.95]\n       \n       ✅ Virtual Visa issued. Completing purchase...\n       [calls payclaw_reportPurchase: success ✅]\n       \n       Done! Cold brew ordered. Card self-destructed."
      },
      {
        "title": "Security",
        "body": "Zero standing access — no card exists until your agent requests one\nSingle-use cards — merchant-locked, amount-capped, 15-minute expiry\nHuman approval — every purchase requires your explicit OK\nIntent audit — every purchase compared against declared intent\n$500 cap — hard ceiling on account balance\nYour real card never enters the chat"
      },
      {
        "title": "Badge Only?",
        "body": "If you only need identity (no payment): clawhub install payclaw-badge"
      },
      {
        "title": "Links",
        "body": "payclaw.io\nFor Merchants\nTrust & Verification\nnpm: @payclaw/mcp-server\nProtocol spec: ucp-agent-badge\nGitHub: badge-server"
      }
    ],
    "body": "PayClaw — Badge + Spend for AI Agents\n\nAgents are not bots. PayClaw proves it — then lets them pay.\n\nYour AI agent looks like a bot to every merchant on the internet. PayClaw gives it two things:\n\nBadge — Declares your agent as an authorized actor. A UCP-compatible credential that lets it through merchant defenses. Free. No card required.\n\nSpend — Issues a single-use virtual Visa when your agent needs to pay. Human-approved. Self-destructs after use. Your real card never enters the chat.\n\n🧪 Developer Sandbox is open. Real infrastructure, test money. Get sandbox access →\n\nSetup\n1. Add to your agent\n{\n  \"mcpServers\": {\n    \"payclaw\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@payclaw/mcp-server\"],\n      \"env\": {\n        \"PAYCLAW_API_URL\": \"https://api.payclaw.io\"\n      }\n    }\n  }\n}\n\n\nNo API key required. On first use, your agent will show a code and a URL. Approve on your phone in one tap — your Consent Key is stored automatically.\n\nRequires Node.js 20+. Node 18 is end-of-life. If you see engine errors: node -v — install from nodejs.org or nvm install 20.\n\n2. Use it\n\nYour agent calls payclaw_getAgentIdentity before acting at any merchant. That's it.\n\nUCP Identity Linking\n\nPayClaw is a UCP (Universal Commerce Protocol) Credential Provider. Merchants who declare the PayClaw identity extension (io.payclaw.common.identity) signal to every UCP-compliant agent that declared agents are preferred at their store.\n\nFor Merchants — how to add PayClaw to your UCP manifest\nProtocol spec — io.payclaw.common.identity (MIT)\nTools\nTool\tWhat It Does\npayclaw_getAgentIdentity\tDeclare yourself as an authorized actor before acting at any merchant. Without this, UCP-compliant merchants may prefer or require a declared agent. Returns a trip-level UCP-compatible credential. Agents are not bots. PayClaw proves it.\npayclaw_getCard\tDeclare purchase intent → get single-use virtual Visa (Spend)\npayclaw_reportPurchase\tReport transaction outcome → close the audit trail\nHow Authorization Scales\nAction\tWhat Happens\nBrowse\tBadge declaration — UCP identity token issued\nSearch\tBadge declaration — UCP identity token issued\nCheckout\tBadge + Spend — human approval → single-use Visa issued\nExample\nYou: \"Buy me a cold brew from Starbucks\"\n\nAgent: Let me declare myself first...\n       [calls payclaw_getAgentIdentity({ merchant: \"starbucks.com\" })]\n       \n       ✓ DECLARED — authorized actor at starbucks.com\n       \n       Found a cold brew for $5.95. Getting a card...\n       [calls payclaw_getCard: merchant=Starbucks, amount=$5.95]\n       \n       ✅ Virtual Visa issued. Completing purchase...\n       [calls payclaw_reportPurchase: success ✅]\n       \n       Done! Cold brew ordered. Card self-destructed.\n\nSecurity\nZero standing access — no card exists until your agent requests one\nSingle-use cards — merchant-locked, amount-capped, 15-minute expiry\nHuman approval — every purchase requires your explicit OK\nIntent audit — every purchase compared against declared intent\n$500 cap — hard ceiling on account balance\nYour real card never enters the chat\nBadge Only?\n\nIf you only need identity (no payment): clawhub install payclaw-badge\n\nLinks\npayclaw.io\nFor Merchants\nTrust & Verification\nnpm: @payclaw/mcp-server\nProtocol spec: ucp-agent-badge\nGitHub: badge-server"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/payclawinc/payclaw-io",
    "publisherUrl": "https://clawhub.ai/payclawinc/payclaw-io",
    "owner": "payclawinc",
    "version": "0.7.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/payclaw-io",
    "downloadUrl": "https://openagent3.xyz/downloads/payclaw-io",
    "agentUrl": "https://openagent3.xyz/skills/payclaw-io/agent",
    "manifestUrl": "https://openagent3.xyz/skills/payclaw-io/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/payclaw-io/agent.md"
  }
}