# Send PayClaw 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. 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. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/payclaw-io",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=payclaw-io",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "payclaw-io/SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "payclaw-io",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T23:16:39.658Z",
      "expiresAt": "2026-05-13T23:16:39.658Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=payclaw-io",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=payclaw-io",
        "contentDisposition": "attachment; filename=\"payclaw-io-0.7.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "payclaw-io"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### PayClaw — Badge + Spend for AI Agents

Agents are not bots. PayClaw proves it — then lets them pay.

Your AI agent looks like a bot to every merchant on the internet. PayClaw gives it two things:

Badge — Declares your agent as an authorized actor. A UCP-compatible credential that lets it through merchant defenses. Free. No card required.

Spend — 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.

🧪 Developer Sandbox is open. Real infrastructure, test money. Get sandbox access →

### 1. Add to your agent

{
  "mcpServers": {
    "payclaw": {
      "command": "npx",
      "args": ["-y", "@payclaw/mcp-server"],
      "env": {
        "PAYCLAW_API_URL": "https://api.payclaw.io"
      }
    }
  }
}

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

Requires Node.js 20+. Node 18 is end-of-life. If you see engine errors: node -v — install from nodejs.org or nvm install 20.

### 2. Use it

Your agent calls payclaw_getAgentIdentity before acting at any merchant. That's it.

### UCP Identity Linking

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.

For Merchants — how to add PayClaw to your UCP manifest
Protocol spec — io.payclaw.common.identity (MIT)

### Tools

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

### How Authorization Scales

ActionWhat HappensBrowseBadge declaration — UCP identity token issuedSearchBadge declaration — UCP identity token issuedCheckoutBadge + Spend — human approval → single-use Visa issued

### Example

You: "Buy me a cold brew from Starbucks"

Agent: Let me declare myself first...
       [calls payclaw_getAgentIdentity({ merchant: "starbucks.com" })]
       
       ✓ DECLARED — authorized actor at starbucks.com
       
       Found a cold brew for $5.95. Getting a card...
       [calls payclaw_getCard: merchant=Starbucks, amount=$5.95]
       
       ✅ Virtual Visa issued. Completing purchase...
       [calls payclaw_reportPurchase: success ✅]
       
       Done! Cold brew ordered. Card self-destructed.

### Security

Zero standing access — no card exists until your agent requests one
Single-use cards — merchant-locked, amount-capped, 15-minute expiry
Human approval — every purchase requires your explicit OK
Intent audit — every purchase compared against declared intent
$500 cap — hard ceiling on account balance
Your real card never enters the chat

### Badge Only?

If you only need identity (no payment): clawhub install payclaw-badge

### Links

payclaw.io
For Merchants
Trust & Verification
npm: @payclaw/mcp-server
Protocol spec: ucp-agent-badge
GitHub: badge-server
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: payclawinc
- Version: 0.7.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-06T23:16:39.658Z
- Expires at: 2026-05-13T23:16:39.658Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/payclaw-io)
- [Send to Agent page](https://openagent3.xyz/skills/payclaw-io/agent)
- [JSON manifest](https://openagent3.xyz/skills/payclaw-io/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/payclaw-io/agent.md)
- [Download page](https://openagent3.xyz/downloads/payclaw-io)