Automates x402 payment negotiation for AI agents by proxying upstream requests through Obul.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obul-proxy
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install obul-proxy 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 Obul Proxy?
The Obul Proxy is a specialized utility designed for developers using Openclaw Skills to simplify interactions with APIs that require x402 payment headers. It abstracts the complexity of micropayment negotiation, allowing agents to access premium services without manual intervention.
By routing requests through the Obul gateway, developers can utilize a single API key to manage access across a variety of distributed, paid resources. This skill is essential for building autonomous systems that need to consume paid data or compute resources on the fly without building custom payment logic for every vendor.
Obul Proxy Use Cases
- Calling x402-enabled endpoints for AI tools and services without manual payment handling.
- Accessing premium APIs that require per-request micropayments.
- Centralizing payment management for a fleet of autonomous agents.
- Simplifying the development of applications that interact with the pay-per-use web.
- Using Openclaw Skills to bridge legacy HTTP clients with the modern x402 payment protocol.
How Obul Proxy Works
- The user identifies an upstream x402-enabled API endpoint they wish to access.
- A request is structured using the Obul Proxy URL pattern, which embeds the scheme and host of the target service.
- The request includes the required Obul API key in the headers for authentication within the Openclaw Skills framework.
- Obul receives the request and automatically detects if the upstream service requires an x402 payment.
- Obul negotiates and fulfills the payment requirement using the user's account balance behind the scenes.
- The final response from the upstream service is returned to the user or agent transparently, as if it were a standard API call.
Obul Proxy Setup
To integrate this skill into your environment, you must provide your API credentials.
# Export your Obul API Key to your environment
export OBUL_API_KEY='your_api_key_here'
Ensure your Openclaw Skills configuration includes the OBUL_API_KEY environment variable to authenticate requests to the proxy gateway at https://proxy.obul.ai.
Obul Proxy Data Schema & Taxonomy
The skill follows a specific URL structure for proxying and handles standard HTTP status codes.
| Component | Description |
|---|---|
| Base URL | https://proxy.obul.ai/proxy/{scheme}/{host} |
| Auth Header | x-obul-api-key |
| Healthz | Returns {"status":"ok"} |
The proxy maps errors from upstream providers into standard HTTP error codes, such as 402 for payment issues and 429 for rate limiting, allowing Openclaw Skills to react programmatically to service state.
Obul Proxy Advanced Features
- Automatic discovery of x402 payment requirements for any proxied request.
- Support for various upstream protocols via dynamic scheme and host injection.
- Integrated health monitoring via the /healthz endpoint for high-availability workflows.
- Unified authentication header for accessing multiple external vendors through a single balance.
- Robust error handling specifically tuned for payment-related failures in autonomous agent workflows.
SKILL.md
Loading
Related Openclaw Skills
Grok Search
Perform high-speed web and X (Twitter) searches with structured JSON output and verified citations using the xAI Grok API.
Presearch Search
A privacy-focused, decentralized search skill that provides uncensored web results for AI agents via a distributed node network.
Presearch Decentralized Search
A production-ready decentralized search API for AI agents that provides privacy-first, uncensored web results via a distributed node network.
OpenClaw Team Collaboration Server
A secure, multi-user web interface for OpenClaw featuring zero-knowledge encryption and local network accessibility.
Stratos Storage
A specialized skill for seamless file interaction with the Stratos Decentralized Storage (SDS) network.
Model Benchmarks
A data-driven intelligence hub for tracking AI model capabilities and costs to ensure optimal compute routing.
Featured*
