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

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.