Skip to content

Clawd402/documentation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Introduction

Clawd402 is a protocol integration layer that enables OpenClaw AI agents to autonomously transact using the x402 payment protocol. Transform OpenClaw agents from read-only information processors into economically autonomous entities capable of purchasing data, subscribing to services, and executing value transfers—without human intervention.

What is Clawd402?

Clawd402 bridges autonomous agent frameworks with HTTP-native payment infrastructure, eliminating payment friction in the emerging agentic economy. Instead of building custom payment logic for every agent workflow, Clawd402 provides a standardized interface that handles:

  • x402 Payment Discovery: Automatic HTTP 402 response handling and payment request parsing
  • Multi-Chain Settlement: USDC/EURC payments across Base, Polygon, Solana, and Stellar (2-second average settlement)
  • Payment & Receipt Management: Make payments for services and receive payments for work performed
  • Security & Approval Policies: Configurable spending limits and approval workflows for autonomous operation
  • OpenClaw Native Integration: Natural language payment instructions via OpenClaw tool system

Core capabilities

Capability Purpose
HTTP 402 Payment Protocol Automatic payment discovery and negotiation via x402 standard
Multi-Chain Payments USDC/EURC settlements on Base, Polygon, Solana, Stellar
Make & Receive Payments Purchase services AND earn revenue as autonomous agent
Subscription Management Automated recurring payments for continuous service access
Instant Settlement Average 2-second blockchain confirmation (vs 2-3 days traditional)
Low-Cost Transfers ~$0.03 per transaction (vs 3% credit card fees)
Non-Custodial Security Agents maintain control of private keys with hardware wallet support
Approval Workflows Spending limits, human-in-the-loop for high-value transactions

How it works

import { Clawd402Tool } from '@clawd402/openclaw-plugin'

// Add payment capabilities to OpenClaw agent
const paymentTool = new Clawd402Tool({
  chains: ['base', 'polygon', 'solana'],
  wallet: { type: 'hardware', device: 'ledger' },
  approvalPolicy: {
    maxPerTransaction: 100,  // USDC
    dailyLimit: 1000,
    requireApproval: (amount) => amount > 50
  }
})

agent.addTool(paymentTool)

// Agent can now make payments via natural language
agent.run("Purchase premium weather data for NYC using x402 protocol")
// → Clawd402 intercepts HTTP 402, parses payment details,
//   constructs USDC transaction, settles on Base chain (~2 seconds)

// Agent can also receive payments for services
agent.run("Analyze this dataset and charge $10 USDC via x402")

Use cases

Autonomous Research Agents: Purchase access to premium data sources, research reports, and paid APIs without human intervention

AI-Powered API Marketplaces: Monetize specialized AI models with per-request pricing for agent consumers (micropayments economically viable)

Agentic Workforce Compensation: AI agents earn payments for services rendered (code review, data analysis, task completion)

Cross-Agent Service Marketplaces: Agents discover, negotiate, and pay for services from other agents autonomously

Subscription Services: Agents automatically renew monthly subscriptions to data feeds, enhanced API limits, and continuous services

Architecture overview

┌─────────────────────────────────────────────────────────────┐
│                 OpenClaw Agent Runtime                      │
│     "Purchase premium weather data for NYC" → Intent        │
└────────────────────────┬────────────────────────────────────┘
                         │ OpenClaw Tool Interface
                         ▼
┌─────────────────────────────────────────────────────────────┐
│                  Clawd402 Integration Layer                 │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  Payment Discovery (HTTP 402 → Payment Details)     │   │
│  │  Transaction Construction (USDC on Base/Polygon)     │   │
│  │  Settlement Verification (2-second confirmation)     │   │
│  │  Security & Approval (Spending limits, policies)     │   │
│  └──────────────────────────────────────────────────────┘   │
└────────────────────────┬────────────────────────────────────┘
                         │ x402 Protocol (HTTP 402 + Blockchain)
                         ▼
┌─────────────────────────────────────────────────────────────┐
│               Multi-Chain Settlement Layer                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐   │
│  │   Base   │  │ Polygon  │  │  Solana  │  │ Stellar  │   │
│  │USDC/EURC │  │USDC/EURC │  │   USDC   │  │  USDC    │   │
│  │ EIP-3009 │  │ EIP-3009 │  │  Native  │  │  Native  │   │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘   │
│         Average Settlement: 2 seconds                       │
└─────────────────────────────────────────────────────────────┘

Next steps

Quickstart
Install Clawd402 and execute your first transaction in 5 minutes
Guides
Step-by-step tutorials for common integration patterns
API Reference
Complete documentation for SDK methods and REST endpoints
Security
Best practices for production deployment

Get help

About

Documentation for the entire Clawd402 project.

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors