SDKs overview

Official clients for calling the 1Claw REST API from your own code. Pick the language that matches your service; all three handle agent JWT exchange and refresh the same way.

JavaScript/TypeScript — @1claw/sdk for Node.js, Next.js, and browser apps. Types generated from the OpenAPI spec. See JavaScript SDK.
Python — oneclaw on PyPI for scripts, backends, and custom agents. See Python SDK. For LangChain or CrewAI, use langchain-1claw or 1claw-crewai-tools instead.
Go — 1claw-go-sdk for services and infrastructure written in Go. See Go SDK.
elizaOS — @1claw/plugin-elizaos adds vault and signing actions to elizaOS characters. See GitHub.
curl / HTTP — Every endpoint is REST. See curl examples.

If you're connecting Cursor or Claude Desktop to a vault, start with MCP integration instead of an SDK.

API contract: The canonical source of truth is the OpenAPI 3.1 spec, published as @1claw/openapi-spec.

Quick example

curl
TypeScript
Python

# 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);

from oneclaw import create_client

client = create_client(api_key="1ck_...")
secret = client.secrets.get(VAULT_ID, "api-keys/openai")
print(secret.data["value"])

Quick example​

Quick example