ClawMPP

Machine Payments Protocol integration for OpenClaw. One wallet, every AI service, no API keys.

Fund your agent's wallet once and pay per call for any MPP-enabled service (Anthropic, OpenAI, Dune, Alchemy, etc.) in the Tempo directory — no accounts, no API keys, no subscriptions.

Quick Start

As an OpenClaw plugin

Install ClawMPP in your OpenClaw extensions directory:

npm install clawmpp

Add to your openclaw.json:

{
  "plugins": {
    "entries": {
      "clawmpp": {
        "enabled": true
      }
    }
  }
}

Create a standalone config at ~/.openclaw/clawmpp/config.json:

{
  "enabled": true,
  "tempo": {
    "address": "0xYOUR_WALLET_ADDRESS",
    "maxDeposit": "1"
  },
  "limits": {
    "per_call": 1.00,
    "per_session": 20.00,
    "daily": 100.00
  },
  "auto_approve_under": 0.25
}

Set the wallet private key as an environment variable:

export CLAWMPP_PRIVATE_KEY=0x...

Standalone CLI

# Create a wallet
npx clawmpp wallet create

# Configure limits
npx clawmpp config set limits.daily 50

# Check status
npx clawmpp status

# Test a payment
CLAWMPP_PRIVATE_KEY=0x... npx clawmpp test

Wallet Setup

Testnet

Generate a wallet and fund it via the Tempo faucet:

npx clawmpp setup --testnet

Or use the mppx CLI directly:

npx mppx account create    # auto-funded on testnet
npx mppx account fund      # fund again if needed

On Windows, use scripts/testnet-setup.mts which bypasses the OS keychain requirement:

npx tsx scripts/testnet-setup.mts

Mainnet

1. Generate a wallet with npx clawmpp wallet create
2. Import the private key into MetaMask
3. Bridge USDC to Tempo mainnet (chain ID 4217) — use the native USDC token (0x20C000000000000000000000b9537d11c60E8b50), not bridged USDC.e
4. Set "testnet": false in your config

Plugin Tools

When loaded in OpenClaw, ClawMPP registers three tools for the agent:

| Tool | Description | |------|-------------| | mpp_fetch | Make HTTP requests with automatic MPP payment handling | | mpp_spending | Check spending summary and remaining budget | | mpp_wallet | Get the active wallet address |

And a slash command: /mppstatus — shows spending summary and wallet info.

Spending Controls

All payments are subject to configurable limits:

• per_call — max USD per single payment (default: $1.00)
• per_session — max USD per session (default: $20.00)
• daily — max USD per day (default: $100.00)
• auto_approve_under — auto-approve payments below this amount (default: $0.25)
• allowed_services / blocked_services — whitelist/blacklist by hostname

Configuration

ClawMPP reads config from two sources, in priority order:

1. OpenClaw plugin config — plugins.entries.clawmpp.config in openclaw.json
2. Standalone file — ~/.openclaw/clawmpp/config.json

If the plugin config block is empty, the standalone file is used as fallback.

Session Deposits

Services that use streaming (like OpenAI) require session payment channels. Configure with:

{
  "tempo": {
    "maxDeposit": "1"
  }
}

• deposit — fixed deposit amount in human-readable units (e.g. "1" = $1)
• maxDeposit — cap on server-suggested deposit (recommended)

License

MIT