Dexter
Dexter
Docs

Clawdexter

@dexterai/clawdexter is an OpenClaw plugin, not a hosted Claude MCP server.

It brings the OpenDexter x402 workflow into OpenClaw so agents can:

  • discover paid x402 APIs
  • preview pricing
  • sign payments with your configured wallet
  • buy API results autonomously inside the OpenClaw runtime

Use it when you want OpenClaw agents to discover and pay for x402 resources with locally configured wallet keys.

What The Package Does

The source-accurate tool surface exposed by Clawdexter is:

  • x402_search
  • x402_check
  • x402_fetch
  • x402_pay
  • x402_wallet

These tools let an OpenClaw agent:

  • search the OpenDexter marketplace
  • inspect payment terms without paying
  • make a paid call with automatic x402 settlement
  • explicitly perform a pay-and-call flow
  • inspect wallet configuration and spend limits

When To Use @dexterai/clawdexter

Choose Clawdexter when:

  • you are already using OpenClaw
  • you want x402 purchasing inside that runtime
  • you want local control over wallet keys
  • you are comfortable configuring payment limits in OpenClaw

Choose @dexterai/opendexter instead when:

  • you want a more generic local package for CLI or editor-based MCP runtimes
  • you are not committed to OpenClaw specifically
  • you want the local-wallet story outside the OpenClaw plugin model

Install

The package README documents Clawdexter as an OpenClaw plugin install:

openclaw plugins install @dexterai/clawdexter

Then configure it in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "clawdexter": {
      "svmPrivateKey": "base58_solana_private_key",
      "evmPrivateKey": "0x_hex_evm_private_key",
      "maxPaymentUSDC": "0.50"
    }
  }
}

You can configure one wallet or both:

  • Solana keys are base58-encoded
  • EVM keys are hex, with or without 0x

Configuration

These are the actual config fields declared in openclaw.plugin.json and the package source:

OptionTypeDefaultDescription
svmPrivateKeystringnoneSolana wallet private key for x402 payments on Solana
evmPrivateKeystringnoneEVM wallet private key for Base, Polygon, Arbitrum, Optimism, and Avalanche
defaultNetworkstring"solana"Preferred network when an endpoint supports multiple chains
maxPaymentUSDCstring"0.50"Maximum payment per request in USDC
marketplaceUrlstringDexter marketplace APIOverride marketplace search endpoint
directoryUrlstringhttps://x402.dexter.cash/api/x402/directoryOverride x402 directory endpoint
disableTelemetrybooleanfalseDisable anonymous usage telemetry

Wallet And Spending Requirements

Before using Clawdexter in production, make sure:

  • your configured wallet holds spendable USDC
  • the wallet only contains funds you are comfortable letting the agent use
  • your maxPaymentUSDC value reflects a safe upper bound for a single payment

Runtime Flow

The normal Clawdexter flow is:

  1. Install the package into OpenClaw.
  2. Configure wallet credentials and payment limits.
  3. Fund the wallet with USDC.
  4. Ask the OpenClaw agent to use a paid API.
  5. The agent discovers a matching x402 resource, checks price, signs the payment, and returns the paid result.

That means you do not need to manually buy credits or pre-negotiate subscriptions with each API. The agent pays when it actually needs the result.

Tool Reference

Search the Dexter marketplace for paid x402 resources.

Supported parameters from the package README:

ParameterTypeDescription
querystringSearch term like "token analysis" or "image generation"
networkstringFilter by solana, base, polygon, arbitrum, optimism, or avalanche
verifiedbooleanOnly return quality-verified endpoints
categorystringFilter by category
maxPriceUsdcnumberMaximum price per call
sortstringSort by marketplace, relevance, quality score, settlements, volume, or recent
limitnumberMax results, default 20, max 50

x402_fetch

Call an x402-protected API with automatic payment.

This is the recommended tool for most paid API calls. The package README describes it as:

  1. send the request
  2. receive 402 Payment Required
  3. sign the USDC payment
  4. retry with the payment proof
  5. return the API response and spend receipt

Parameters:

ParameterTypeDescription
urlstringThe x402 resource URL
methodstringHTTP method, default GET
bodystringJSON request body for POST or PUT

x402_pay

Explicit pay-and-call version of the same x402 flow.

Use this when you want the action framed as:

  1. search
  2. check
  3. pay and call

Parameters:

ParameterTypeDescription
urlstringThe x402 endpoint URL
methodstringHTTP method
paramsobjectQuery params for GET or JSON body for POST
headersobjectCustom HTTP headers

x402_check

Probe an endpoint for payment requirements without paying.

It returns:

  • whether payment is required
  • pricing per chain
  • accepted networks
  • pay-to addresses
  • the x402 protocol version

Parameters:

ParameterTypeDescription
urlstringThe URL to check
methodstringHTTP method to probe, default GET

x402_wallet

Show configured wallets, active network, and per-call spend limit.

The package exposes this as the wallet inspection tool for the current local OpenClaw setup.

Built-In Spending Controls

Clawdexter is designed to support autonomous spending without turning into an uncontrolled wallet drain.

  • Per-transaction limit: cap the maximum USDC amount for a single payment
  • Session budget: optionally cap total spend across a conversation or workflow
  • Wallet-balance bound: the agent cannot spend more than the wallet holds
  • Optional confirmation patterns: useful for higher-value actions depending on your agent setup

What It Is Good For

Typical Clawdexter use cases include:

  • market research agents that buy premium sentiment or analytics endpoints
  • trading assistants that pay for real-time data only when needed
  • content-generation agents that buy premium generation or enrichment APIs
  • automation agents that need one-off paid API calls inside a larger workflow

Supported Networks

The package README explicitly documents support for:

  • Solana USDC payments
  • Base USDC payments
  • Polygon
  • Arbitrum
  • Optimism
  • Avalanche

Solana uses svmPrivateKey.

The EVM networks share evmPrivateKey.

Architecture

The package README describes the architecture this way:

  • OpenClaw agent requests data from x402-enabled APIs
  • the endpoint returns 402 Payment Required
  • Clawdexter signs the payment locally using @dexterai/x402
  • the paid call is retried
  • the API returns data
  • marketplace discovery and ranking come from Dexter / OpenDexter services

The key trust property is that wallet keys stay local. Funds are not custodied by the package.

Choosing Between Clawdexter And Other Dexter Access Modes

Use Clawdexter if your question is:

  • "How do I give an OpenClaw agent a wallet?"
  • "How do I let OpenClaw pay for x402 APIs?"
  • "How do I keep the x402 payment loop inside OpenClaw itself?"

Use the broader OpenDexter docs if your question is:

  • "Which Dexter access mode should I choose?"
  • "Should I use the hosted MCP, authenticated MCP, local package, or OpenClaw plugin?"
  • "How does the same discovery model differ across runtimes?"

For that comparison, continue to OpenDexter Access Modes.

Troubleshooting Checklist

These troubleshooting cases are documented directly in the package README:

"No wallet configured"

Set at least one configured key in plugin config:

{
  "plugins": {
    "clawdexter": {
      "svmPrivateKey": "your_solana_key"
    }
  }
}

amount_exceeds_max

The endpoint costs more than your configured maxPaymentUSDC limit.

Increase it, for example:

{
  "maxPaymentUSDC": "1.00"
}

Insufficient balance

Fund the wallet with USDC on the correct network:

  • SPL USDC for Solana
  • ERC-20 USDC for EVM chains

Tools not appearing

Verify the plugin is installed and enabled:

openclaw plugins list

Dependencies

The published package currently declares:

PackagePurpose
@dexterai/x402x402 payment signing client SDK
@sinclair/typeboxruntime schema validation

Summary

@dexterai/clawdexter is the package for OpenClaw-native x402 API payments.

It is the right choice when you want an OpenClaw agent to:

  • discover paid APIs
  • pay with your configured wallet
  • stay within your spending rules
  • complete the paid call inside the agent runtime