Skip to main content

OpenClaw

Beta

The Ampersend OpenClaw integration is currently in beta. Features, APIs, and configuration may change as the integration evolves.

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 the Ampersend Platform

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