payclaw

Review·Scanned 2/18/2026

This skill implements a CLI for agent-to-agent USDC payments, wallet management, and escrow using Circle wallets. It runs the circle-wallet CLI via execSync, stores the apiKey in path.join(process.env.HOME, '.openclaw','payclaw','config.json'), and may contact https://faucet.circle.com.

from clawhub.ai·v1.0.0·45.3 KB·0 installs
Scanned from 1.0.0 at 38bffee · Transparency log ↗
$ vett add clawhub.ai/rojasjuniore/payclawReview findings below

PayClaw 💸

Agent-to-Agent USDC Payments for OpenClaw.

Built for the USDC Hackathon on Moltbook.

What It Does

PayClaw enables any OpenClaw agent to:

  • 🏦 Create a USDC wallet (Circle Developer-Controlled Wallets)
  • 💰 Receive payments from other agents or humans
  • 💸 Send payments to any wallet address
  • 🤝 Escrow funds between agents for trustless transactions
  • 🔗 Works on Arc Testnet (USDC native L1)

Why It Matters

Agents need money to work.

Today, if your agent needs to:

  • Pay for an API call
  • Hire another agent
  • Receive payment for a task
  • Hold funds in escrow for a deal

...there's no easy way to do it. PayClaw solves this.

Installation

clawhub install payclaw
cd ~/.openclaw/skills/payclaw
npm install && npm run build && npm link

Setup

# Configure with Circle API key
payclaw setup --api-key YOUR_CIRCLE_API_KEY

# Create your agent's wallet
payclaw wallet create "MyAgent"

# Get testnet USDC
payclaw faucet

Commands

Wallet Management

payclaw wallet create [name]     # Create new wallet
payclaw wallet list              # List all wallets
payclaw wallet balance           # Check balance
payclaw wallet address           # Show wallet address

Payments

payclaw pay <address> <amount>   # Send USDC
payclaw request <amount> [memo]  # Generate payment request
payclaw history                  # Transaction history

Escrow (Agent-to-Agent)

payclaw escrow create <amount> <recipient> [--condition "task completed"]
payclaw escrow list              # List active escrows
payclaw escrow release <id>      # Release funds to recipient
payclaw escrow refund <id>       # Refund to sender

Agent Discovery

payclaw agents list              # List agents with PayClaw wallets
payclaw agents find <name>       # Find agent's wallet address
payclaw agents register          # Register your agent in directory

Usage Examples

Pay Another Agent

# Find agent's wallet
payclaw agents find "DataBot"
# Output: 0x1234...5678

# Send payment
payclaw pay 0x1234...5678 10 --memo "For data analysis task"
# Output: ✅ Sent 10 USDC to DataBot (0x1234...)
#         TX: 0xabc...def

Create Escrow for Task

# Client creates escrow
payclaw escrow create 50 0xFreelancerWallet --condition "Deliver logo design"
# Output: 🔒 Escrow created: ESC-001
#         Amount: 50 USDC
#         Recipient: 0xFreelancer...
#         Condition: Deliver logo design

# After task completion, client releases
payclaw escrow release ESC-001
# Output: ✅ Released 50 USDC to 0xFreelancer...

Receive Payment

# Generate payment request
payclaw request 25 --memo "API access for 1 month"
# Output: 💰 Payment Request
#         To: 0xYourWallet...
#         Amount: 25 USDC
#         Memo: API access for 1 month
#         
#         Share this with payer:
#         payclaw pay 0xYourWallet 25 --memo "API access for 1 month"

Agent Integration

// In your OpenClaw skill
import { PayClaw } from 'payclaw';

const payclaw = new PayClaw();

// Check if payment received
const balance = await payclaw.getBalance();

// Send payment
await payclaw.send('0x...', 10, 'For task completion');

// Create escrow
const escrow = await payclaw.createEscrow(50, '0x...', 'Task condition');

Supported Chains

  • Arc Testnet (default) - Circle's native USDC L1
  • Base Sepolia
  • Polygon Amoy
  • Ethereum Sepolia

Security

  • Private keys never leave Circle's infrastructure
  • Gas-free transactions via Circle Gas Station
  • Testnet only for hackathon (no real funds)

Architecture

┌─────────────────┐     ┌─────────────────┐
│  OpenClaw Agent │────▶│    PayClaw      │
└─────────────────┘     └────────┬────────┘
                                 │
                                 ▼
                        ┌─────────────────┐
                        │  Circle Wallets │
                        │    (Testnet)    │
                        └────────┬────────┘
                                 │
                                 ▼
                        ┌─────────────────┐
                        │   Arc Testnet   │
                        │     (USDC)      │
                        └─────────────────┘

Hackathon Track

Best OpenClaw Skill - This skill extends OpenClaw agents with native USDC payment capabilities, enabling a new paradigm of agent-to-agent commerce.

Links

License

MIT


Built for the OpenClaw USDC Hackathon on Moltbook 💵