crabwalk/README.md

🦀 Crabwalk

Real-time companion monitor for Clawdbot agents.

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.

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

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

# 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