v402 — OpenClaw Skill

OpenClaw / AgentSkills-compatible skill that teaches AI agents the v402 HTTP payment protocol on Solana. The agent learns to detect 402 responses, enforce spending policies, submit USDC payments on-chain, and verify Ed25519-signed receipts.

Install

Via ClawHub

clawhub install v402

Via Direct URL

npx skills add https://github.com/valeo-cash/v402 --skill openclaw

Manual

cp -r packages/integrations/openclaw ~/.openclaw/skills/v402
bash ~/.openclaw/skills/v402/scripts/install.sh

Configuration

Add to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "v402": {
        "enabled": true,
        "env": {
          "V402_WALLET_PRIVATE_KEY": "<base58-solana-private-key>",
          "V402_DAILY_CAP": "5.0",
          "V402_PER_CALL_CAP": "1.0",
          "V402_ALLOWED_TOOLS": "web_search,get_token_price,get_balance"
        }
      }
    }
  }
}

What the Agent Can Do

• Detect 402 responses — automatically parse V402-Intent headers
• Enforce spending policy — daily caps, per-call limits, tool and merchant allowlists
• Submit payments — USDC SPL transfers on Solana with on-chain confirmation
• Verify receipts — Ed25519 signature verification and on-chain transaction lookup
• Automated flow — single-command v402-http.mjs call handles the entire 402 cycle

Slash Commands

File Structure

openclaw/
├── SKILL.md                    # Agent instructions (injected into system prompt)
├── README.md                   # This file
├── scripts/
│   ├── install.sh              # Dependency installer
│   ├── package.json            # Script dependencies (Solana libs)
│   ├── v402-policy.mjs         # Spending policy manager
│   ├── v402-pay.mjs            # Solana USDC payment submission
│   ├── v402-verify.mjs         # On-chain receipt verification
│   └── v402-http.mjs           # Full automated 402 flow
├── references/
│   └── protocol-spec.md        # v402 protocol specification
└── tests/
    └── openclaw-skill.test.ts  # Vitest integration tests

Distribution

Links

• v402 Protocol
• Protocol Spec v2
• npm packages

License

MIT