Claw0x LogoClaw0x
Docs/SDK

SDK & Integration

Integrate Claw0x Skills into your project or AI Agent.

OpenClaw CLI
Recommended
Install a Skill into your OpenClaw Agent with a single command

Install

npm install -g @claw0x/cli

# Or use npx without installing
npx @claw0x/cli add twitter_scraper

Usage

# Add a Skill to your Agent (auto-updates SOUL.md)
$ npx @claw0x/cli add web-scraper-pro

✓ Skill "web-scraper-pro" added
✓ SOUL.md updated
✓ Ready to use

# List installed Skills
$ npx @claw0x/cli list

# Remove a Skill
$ npx @claw0x/cli remove web-scraper-pro
Python
Available
For Python scripts and backend services

Install

pip install claw0x

Basic Usage

from claw0x import Client

client = Client(api_key="atom_YOUR_API_KEY")

# Call a Skill
result = client.call("sentiment-analyzer", input={
    "text": "AI agents are transforming software development."
})

print(result.data)       # Data returned by the Skill
print(result.metadata)   # Latency, cost, and other metadata

Async

import asyncio
from claw0x import AsyncClient

async def main():
    client = AsyncClient(api_key="atom_YOUR_API_KEY")
    result = await client.call("translation-api", input={
        "text": "hello world",
        "target_lang": "zh"
    })
    print(result.data)

asyncio.run(main())
TypeScript / JavaScript
Available
For Node.js and browser environments

Install

npm install @claw0x/sdk

Usage

import { Claw0x } from '@claw0x/sdk'

const client = new Claw0x({ apiKey: 'atom_YOUR_API_KEY' })

const result = await client.call('email-validator', {
  email: 'hello@example.com'
})

console.log(result.data)     // { valid: true, disposable: false, ... }
console.log(result.metadata) // { response_time_ms: 120, price_paid: 0.01 }
LangChain
Available
Use as a LangChain Tool in your Agent

Install

pip install langchain-claw0x

Usage

from langchain_community.tools import Claw0xTool

# Create a Tool instance
scraper = Claw0xTool(
    api_key="atom_YOUR_API_KEY",
    skill="twitter_scraper"
)

# Use in an Agent
from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(model="gpt-4")
agent = initialize_agent(
    tools=[scraper],
    llm=llm,
    agent=AgentType.OPENAI_FUNCTIONS
)

agent.run("Scrape the latest tweets from @OpenAI")
REST API (cURL)
Universal
Call the HTTP API directly from any language
curl -X POST https://api.claw0x.com/v1/call \
  -H "Authorization: Bearer atom_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skill_id": "pdf-parser",
    "input": {
      "url": "https://example.com/report.pdf"
    }
  }'

See the API Reference for the full list of endpoints and parameters.

Error Handling
All SDKs follow a unified error format
from claw0x import Client, Claw0xError, InsufficientBalanceError

client = Client(api_key="atom_YOUR_API_KEY")

try:
    result = client.call("web-scraper-pro", input={"url": "..."})
except InsufficientBalanceError:
    print("Insufficient balance, please top up")
except Claw0xError as e:
    print(f"Call failed: {e.status_code} - {e.message}")
401

Invalid or missing API Key

402

Insufficient balance

429

Daily call limit exceeded

502

Skill server error (no charge)

More Resources

API Reference — Full endpoint documentation

Quick Start — Get up and running in 5 minutes

List a Skill — Publish your API to the marketplace and earn revenue