@openclaw-agent-trace/cli

Interactive CLI for Agent Monitor — open-source observability for AI agents.

Quick Start

npx @openclaw-agent-trace/cli init

The init command walks you through:

1. Paste your API key (must start with ap_proj_)
2. Choose your framework — OpenClaw, LangChain, CrewAI, AutoGen, or Custom
3. Name your project
4. Validates the key against the server
5. Saves config to .agent-monitor/config.json

Commands

| Command | Description | | ----------- | -------------------------------------------- | | init | Interactive project setup | | status | Show agent status and key metrics | | logs | View recent event logs (--tail to stream) | | dashboard | Launch the local web dashboard |

Options

--server-url    Server URL (default: production)
--project-key   Project API key (shorthand: -k)
--local         Use local-only transport
--dir           Data directory (default: .agent-monitor)
--verbose       Verbose error output

Example

# Initialize with custom server
npx @openclaw-agent-trace/cli init --server-url http://localhost:3000

# Check status
npx @openclaw-agent-trace/cli status -k ap_proj_abc123

# Tail logs
npx @openclaw-agent-trace/cli logs --tail

After Init

Add the SDK to your agent code:

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

const monitor = new AgentMonitor({
  projectKey: "ap_proj_...",
  framework: "openclaw",
});

Events will automatically flow to your dashboard.

License

MIT