# 🦀 Crabwalk

Real-time companion monitor for [Clawdbot](https://github.com/clawdbot/clawdbot) agents by [@luccasveg](https://x.com/luccasveg).

Watch your AI agents work across WhatsApp, Telegram, Discord, and Slack in a live node graph. See thinking states, tool calls, and response chains as they happen.

![Crabwalk Home](public/home.png)

![Crabwalk Monitor](public/monitor.png)

## Features

- **Live activity graph** - ReactFlow visualization of agent sessions and action chains
- **Multi-platform** - Monitor agents across all messaging platforms simultaneously
- **Real-time streaming** - WebSocket connection to clawdbot gateway
- **Action tracing** - Expand nodes to inspect tool args and payloads
- **Session filtering** - Filter by platform, search by recipient

## Getting Started

```bash
npm install
npm run dev
```

Open `http://localhost:3000/monitor` (or `http://<server-ip>:3000/monitor` for remote access)

Requires clawdbot gateway running on the same machine.

## Config

Token is in `~/.clawdbot/clawdbot.json`

```bash
# Option 1: command line
CLAWDBOT_API_TOKEN=your-token npm run dev

# Option 2: env file
echo "CLAWDBOT_API_TOKEN=your-token" > .env.local
npm run dev
```

## Stack

TanStack Start, ReactFlow, Framer Motion, tRPC, TanStack DB
