Skip to main content

OpenClaw

Beta — The ampersend SDK (v0.0.16) and x402 protocol are under active development. APIs and workspace conventions may change between releases.

Give an OpenClaw agent an ampersend wallet and spending controls so it can autonomously pay for x402-enabled APIs.

By default, OpenClaw agents can call APIs but cannot pay for them. This integration gives your agent:

  • A smart account wallet provisioned through ampersend
  • Transparent x402 payment handling via the ampersend ClawHub skill
  • Spending controls — including per-transaction, daily, and monthly limits configured in the ampersend dashboard

Once configured, the agent can pay for APIs automatically while remaining constrained by your spending limits.

Prerequisites​

  • Access to the ampersend platform
  • An OpenClaw agent runtime
  • Ability to install ClawHub skills

Setup​

1. Create an ampersend agent​

Go to ampersend

Create a new agent. Each agent is provisioned with:

  • Smart Account wallet
  • Private key
  • Unique agent address

This wallet is used by the OpenClaw agent to authorize payments.

Save the private key. You will need it when configuring the skill.

2. Configure spending controls​

Before connecting the agent to OpenClaw, configure spending limits in the ampersend dashboard.

These limits are enforced by the SDK and prevent uncontrolled spending.

ControlDescription
Per-transaction limitMaximum amount allowed for a single payment
Daily limitMaximum total spend per day
Monthly limitMaximum total spend per calendar month
Auto top-upAutomatically replenishes the wallet up to the daily limit
Seller allowlistRestricts which APIs the agent can pay

See Configure an Agent for full configuration details.

3. Install the ampersend ClawHub skill​

Install the skill using ClawHub.

npm i -g clawhub
clawhub install ampersend

The skill enables automatic payment handling inside the OpenClaw runtime.

4. Configure the skill with your agent wallet​

Set the environment variables for the agent wallet.

AMPERSEND_API_URL=https://api.ampersend.ai
AMPERSEND_AGENT_ADDRESS=0x...
AMPERSEND_PRIVATE_KEY=0x...

Restart the OpenClaw agent runtime so the skill loads.

How It Works​

The integration relies on two components.

ampersend wallet​

When you create an agent on the ampersend platform, a smart account wallet is provisioned with a unique address and private key.
This wallet is used by your OpenClaw agent to authorize API payments.

Ampersend ClawHub skill​

The Ampersend skill is installed through ClawHub, OpenClaw's skill registry.
The skill runs inside the agent runtime and handles x402 payments automatically.

When the agent calls a paid API, the skill intercepts the response, signs the payment with the agent wallet, and retries the request with the payment attached.

The agent receives the response as a normal API result.

Payment Flow​

Agent calls API
  └─ API returns 402 Payment Required
       └─ Ampersend skill signs + attaches payment
            └─ Request retried → API responds

Runtime Behavior​

After setup, the agent interacts with paid APIs the same way it interacts with any other API.

When a request requires payment:

  1. API returns 402 Payment Required with amount, token (USDC), and recipient address
  2. The ampersend skill checks the request against configured spending limits
  3. If within limits, the skill signs the payment authorization using the agent wallet
  4. The request is retried with the signed payment header
  5. The API verifies the payment and executes the request
  6. The agent receives the response

If a payment would exceed a configured spending limit, the transaction is blocked before submission.

Supported Services​

StatusCapability
✅x402-enabled APIs
✅HTTP endpoints
✅USDC payments on Base
❌API key-based services
❌Subscription or fiat billing

Skill Page​

The Ampersend skill is published on ClawHub at: https://clawhub.ai/matiasedgeandnode/ampersend