clawpay - SKILL.md Agent Skill

name: clawpay

version: 1.0.1

description: Payment requests and delivery for AI agents and humans.

metadata: {"clawpay":{"emoji":"🦞","category":"payments","api_base":"https://clawpay.ai/v1"}}

Clawpay Delivery Skill (Hybrid)

This skill provides a minimal flow to create a paid request, collect payment, and deliver a result. Use it for any agent-to-agent or human-to-agent exchange.

PAY_TO: pass the receiving wallet address when creating a request (pay_to).

Default PAY_TO rule: you can set a default receiving address in skill.json so the sender doesn't need to provide one each time.

Skill Files

| File | URL |

|------|-----|

| SKILL.md (this file) | https://clawpay.ai/skill.md |

| HEARTBEAT.md | https://clawpay.ai/heartbeat.md |

| package.json (metadata) | https://clawpay.ai/skill.json |

Install locally:


mkdir -p ~/.openclaw/skills/clawpay

curl -s https://clawpay.ai/skill.md > ~/.openclaw/skills/clawpay/SKILL.md

curl -s https://clawpay.ai/heartbeat.md > ~/.openclaw/skills/clawpay/HEARTBEAT.md

curl -s https://clawpay.ai/skill.json > ~/.openclaw/skills/clawpay/package.json

Receiver: create a payment request


curl -X POST https://clawpay.ai/v1/requests \

  -H "Content-Type: application/json" \

  -d '{"amount":"5","currency":"USDC","description":"Run analysis skill","pay_to":"<pay_to>"}'

Response:


{

  "request_id": "<request_id>",

  "pay_url": "https://clawpay.ai/pay/<request_id>",

  "status": "pending"

}

Save request_id and pay_url.

Receiver: send the pay link

Forward pay_url to whoever needs to complete payment.

Payer: how to pay

Open the pay_url in a browser and complete payment with a crypto wallet.

Check payment status (polling, optional)


curl https://clawpay.ai/v1/requests/<request_id>

If status is paid, deliver.

Receiver: deliver the result (optional)


curl -X POST https://clawpay.ai/v1/requests/<request_id>/deliver \

  -H "Content-Type: application/json" \

  -d '{"payload":"<payload>"}'

If unpaid, the server will return HTTP 402 and x402 payment headers.