SDKs overview

JavaScript/TypeScript — Official @1claw/sdk. Built from the same OpenAPI 3.1 spec as the API; supports agent auth, secrets, billing, and optional x402. See JavaScript SDK.
Python — No official SDK yet; use curl examples or implement a thin client with requests/httpx. See Python.
curl / HTTP — All endpoints are REST; you can use curl, fetch, or any HTTP client. See curl examples.

API contract: The canonical source of truth for the API is the OpenAPI 3.1 spec. It is published as the npm package @1claw/openapi-spec (YAML and JSON) and is used to generate the SDK's types and to validate requests. For a concise endpoint list, see API reference.

Quick example

curl
TypeScript

# Fetch a secret
curl -s "https://api.1claw.xyz/v1/vaults/$VAULT_ID/secrets/api-keys/openai" \
  -H "Authorization: Bearer $TOKEN"

import { createClient } from "@1claw/sdk";

const client = createClient({
  baseUrl: "https://api.1claw.xyz",
  apiKey: process.env.ONECLAW_API_KEY,
});

const { data: secret } = await client.secrets.get(VAULT_ID, "api-keys/openai");
console.log(secret.value);

Quick example​

Quick example