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":""}'

Response:

{
  "request_id": "",
  "pay_url": "https://clawpay.ai/pay/",
  "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/

If status is paid, deliver.

Receiver: deliver the result (optional)

curl -X POST https://clawpay.ai/v1/requests//deliver \
  -H "Content-Type: application/json" \
  -d '{"payload":""}'

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