Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Fix: corrected API URL path (/api/ID -> /ID) to match gateway routes in call-api.sh, apiosk-client.js, apiosk_client.py
What This Skill Does
Apiosk enables agents to call production APIs using USDC micropayments on Base blockchain instead of API keys or accounts. The x402 protocol handles payment automatically per request, deducting from a locally stored wallet. Nine built-in APIs cover weather, prices, news, geocoding, code execution, and file conversion.
Eliminates API key provisioning and monthly subscriptions by charging per request via on-chain micropayments, so agents can access multiple APIs without managing credentials.
When to use it
- Fetching live weather data in agent code without an API key
- Tracking crypto and stock prices per request from automated scripts
- Looking up coordinates from addresses in location-aware agents
- Pulling topic-based news articles for a daily digest workflow
- Generating PDFs or screenshots in an automated processing pipeline
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Get the current weather in Amsterdam
- 1Load wallet address from ~/.apiosk/wallet.json
- 2Call callApiosk('weather', { city: 'Amsterdam' }) in agent code
- 3Gateway responds with 402 Payment Required and wallet signs payment proof
- 4Gateway verifies USDC payment on Base mainnet and forwards request to weather API
- 5Return weather data including temperature, condition, and forecast
Weather report for Amsterdam with temperature and forecast; $0.001 USDC deducted from wallet
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.