x402-direct for Openclaw

A specialized directory for discovering and searching crypto-native, x402-enabled API services designed for autonomous agents.

jovannyespinal
v1.0.0
Feb 12, 2026
0
1.5k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install x402-direct

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install x402-direct using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is x402-direct?

The x402-direct skill provides AI agents with a robust interface to the x402.direct service directory. This platform indexes a wide array of APIs that utilize the HTTP 402 payment protocol, allowing agents to find and pay for services using cryptocurrency. It is a critical infrastructure component for developers building Openclaw Skills that require autonomous service discovery and machine-to-machine transactions.

By integrating this skill, agents can navigate a growing ecosystem of AI, data, and developer tools. The directory doesn't just list services; it evaluates them using the ScoutScore system, which provides automated trust signals. This ensures that agents can distinguish between high-quality, production-ready APIs and experimental testnet deployments, facilitating safer and more reliable agentic workflows.

x402-direct Use Cases

  • Finding specialized AI or image generation models that accept crypto-native payments.
  • Browsing high-trust financial data or weather APIs on specific blockchain networks like Base or Solana.
  • Automating the discovery of paid search and data analytics tools within an agent's task lifecycle.
  • Validating service metadata and payment requirements before initiating a transaction.

How x402-direct Works

  1. The agent triggers the skill to find a specific capability, such as 'weather' or 'storage'.
  2. For broad discovery, the agent calls the free Browse endpoint to filter services by category, network, or trust score.
  3. For specific needs, the agent uses the semantic Search endpoint, which requires a small x402 payment ($0.001) for access.
  4. The directory returns structured service data, including the ScoutScore trust rating and the exact payment metadata (payTo address, asset, and price).
  5. The agent evaluates the results and proceeds to interact with the chosen service using the retrieved x402 payment details.

x402-direct Setup

To use x402-direct within your Openclaw Skills, ensure your agent has access to an x402-compatible wallet (e.g., Coinbase Agentic Wallet). No complex local installation is required, as the skill interacts with the public API at https://x402.direct.

If you are using the x402 client library in your agent's environment:

npm install x402

Configure the agent to handle the X-402-Payment header and the automated payment proof flow for search-related queries.

x402-direct Data Schema & Taxonomy

The skill organizes service data using a structured metadata taxonomy to help agents make informed decisions:

Attribute Description
id Unique directory ID for the service
resourceUrl The target API endpoint for the service
scoutScore A trust rating from 0 to 100 based on automated signals
category Functional area (e.g., ai, developer, finance, storage)
network The blockchain network used for payments (e.g., base-mainnet)
priceUsd The approximate cost per request in USD units

x402-direct Advanced Features

  • ScoutScore Trust System: Automatically filters services based on HTTPS security, domain reputation, and documentation quality.
  • Multi-Network Discovery: Search for services across Base, Polygon, and Solana ecosystems within a single query.
  • Automatic Payment Handling: Integration with x402 middleware allows agents to handle '402 Payment Required' responses and re-send requests with payment proofs.
  • Semantic Ranking: Search results are ranked by a blend of text relevance and provider trust to find the best-fit service for any natural language query.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*