agirails-payments

✓Verified·Scanned 2/18/2026

This skill provides an ACTP payments SDK and OpenClaw integration to enable AI agents to send/receive USDC escrow payments on Base L2. It requires AGENT_PRIVATE_KEY/AGENT_ADDRESS, instructs running bash {baseDir}/scripts/setup.sh, and uses network endpoints like https://ipfs.io/ipfs/ and RPC providers (https://alchemy.com, https://quicknode.com); these behaviors are purpose-aligned and low risk.

from clawhub.ai·v2.1.0·91.2 KB·0 installs

Scanned from 2.1.0 at 7de6dab · Transparency log ↗

$ vett add clawhub.ai/unima3x/agirails-payments

AGIRAILS Payments - OpenClaw Skill

Official OpenClaw skill for AI agent payments via the ACTP (Agent Commerce Transaction Protocol).

What is this?

This skill enables AI agents running on OpenClaw/Clawdbot to:

Pay for services from other agents
Receive payments for providing services
Track transactions through the 8-state machine
Handle disputes with blockchain-secured escrow

Manual installation

# Clone to your skills directory
git clone https://github.com/agirails/openclaw-skill.git ~/.openclaw/skills/agirails

Prerequisites

AGIRAILS SDK installed in your project:

npm install @agirails/sdk   # TypeScript
pip install agirails        # Python

Environment variables:

export AGENT_PRIVATE_KEY="0x..."   # Wallet private key
export AGENT_ADDRESS="0x..."       # Wallet address

USDC on Base - Bridge via bridge.base.org

Usage

Once installed, just tell your AI agent:

"Pay 10 USDC to 0xProviderAddress for translation service"

The skill provides documentation for:

Basic API (one-liner payments)
Standard API (full control)
Advanced API (provider flows, proof encoding)

Skill Contents

openclaw-skill/
├── SKILL.md                         # Main skill documentation
├── README.md                        # This file
├── references/
│   ├── state-machine.md             # 8-state machine reference
│   ├── requester-template.md        # Full requester agent template
│   └── provider-template.md         # Full provider agent template
├── examples/
│   ├── simple-payment.md            # All 3 API levels explained
│   └── full-lifecycle.md            # Complete transaction flow
├── openclaw/                        # OpenClaw integration
│   ├── QUICKSTART.md                # 5-minute setup guide
│   ├── agent-config.json            # Ready-to-use configs
│   ├── SOUL-treasury.md             # Buyer agent template
│   ├── SOUL-provider.md             # Seller agent template
│   ├── cron-examples.json           # Automation jobs
│   ├── validation-patterns.md       # Delivery validators
│   └── security-checklist.md        # Pre-launch audit
└── scripts/
    ├── setup.sh                     # Automated setup
    ├── test-balance.ts              # Check wallet balance
    └── test-purchase.ts             # Test on testnet

State Machine

INITIATED → QUOTED → COMMITTED → IN_PROGRESS → DELIVERED → SETTLED
                          ↓            ↓             ↓
                     CANCELLED    DISPUTED ─────────→↑

Important: IN_PROGRESS is required before DELIVERED.