Solana CLAWD Agentic Commerce
Use this skill when an agent needs to pay for APIs, publish a paid service, mint/register on Metaplex, launch an agent token, or prove its on-chain identity.
Runtime Order
- Start in Pay sandbox mode unless the user explicitly requests mainnet spending.
- Load the spend policy from
openclawd-framework/src/commerce/pay-policy.ts. - Plan every paid call before execution: provider, endpoint, estimated USD, expected calls, and why it matches.
- Refuse calls that exceed policy, hit denied URL patterns, or target non-allowlisted endpoints.
- For Metaplex, mint or read the agent identity before token launch.
- Use devnet and
setToken: falseuntil final launch. - Only use
setToken: truewhen the user explicitly acknowledges the permanent one-token-per-agent binding.
Important Files
docs/AGENTIC_COMMERCE.mdopenclawd-framework/src/commerce/pay-policy.tsopenclawd-framework/src/commerce/pay-client.tsopenclawd-framework/src/commerce/metaplex-agent-commerce.tsopenclawd-framework/pay/solana-clawd-agent-commerce.ymlopenclawd-framework/examples/agent-commerce.ts
Commands
pay --sandbox server start openclawd-framework/pay/solana-clawd-agent-commerce.yml --debugger
cd openclawd-framework && node --import tsx/esm examples/agent-commerce.ts
Non-Negotiables
- Never ask for or print private keys, wallet bytes, wallet passwords, or signed challenge material.
- Never bypass
PayAutonomyClient.planfor autonomous spending. - Never launch a mainnet agent token with
setToken: trueunless the user explicitly confirms finality. - Always report transaction signatures and payment receipts when an actual paid/on-chain action occurs.