@openclaw-agent-trace/sdk

Lightweight SDK for AI agent observability. Track every tool call, LLM request, API hit, and error your agents make.

Works with OpenClaw, LangChain, CrewAI, AutoGen, or any custom agent framework.

Install

npm install @openclaw-agent-trace/sdk

Quick Start

import { AgentMonitor } from '@openclaw-agent-trace/sdk';

const monitor = new AgentMonitor({
  projectKey: 'ap_proj_xxx',
  serverUrl: 'https://your-server.up.railway.app',
  framework: 'openclaw',
});

// Track a tool call
await monitor.trackToolCall('web_search', { query: 'AI news' }, async () => {
  return mySearchFunction();
});

// Track an LLM call
monitor.trackLlmCall({
  provider: 'anthropic',
  model: 'claude-sonnet-4-5',
  promptTokens: 1500,
  completionTokens: 800,
  durationMs: 2400,
});

// Flush before shutdown
await monitor.shutdown();

OpenClaw Adapter

import { AgentMonitor } from '@openclaw-agent-trace/sdk';
import { OpenClawAdapter } from '@openclaw-agent-trace/sdk/adapters/openclaw';

const monitor = new AgentMonitor({ framework: 'openclaw' });
const adapter = new OpenClawAdapter(monitor);

// Automatically tracks tool calls with category detection
await adapter.trackToolCall(
  { toolName: 'web_search', parameters: { query: 'AI news' } },
  () => toolFn()
);

Local Mode (No Server)

const monitor = new AgentMonitor({
  transport: 'local',
  localDir: '.agent-monitor',
});

Events stored as NDJSON files on your machine. Zero data leaves your system.

Features

• Auto-batching — Events are buffered and sent in batches
• Retry with backoff — Failed requests retry automatically
• Gzip compression — Minimizes bandwidth usage
• Smart redaction — API keys stripped before transmission
• Cost calculation — Automatic per-event cost tracking
• Zero-config interception — Wrap tool registries with createInterceptor()

Privacy

API keys and secrets are never transmitted. The SDK runs a client-side redaction engine that strips sensitive data from 20+ providers before any data leaves your machine.

Links

• GitHub: https://github.com/YasirAmeen/agent_open_claw_trace
• Server: @openclaw-agent-trace/server
• Core: @openclaw-agent-trace/core

License

MIT