crabwise-ai/crabwalk

🦀 Crabwalk 🦀 Real-time companion monitor for OpenClaw agents.

🦀 Crabwalk – Real‑time monitor for OpenClaw agents

What it is – A lightweight web UI that visualises the activity of OpenClaw (Clawdbot) AI agents as they converse on WhatsApp, Telegram, Discord or Slack. It shows a live node‑graph of each session, the tools the agent calls, and the payloads that flow through the system.

Key capabilities

  • Live activity graph – ReactFlow renders agent sessions and their action chains in real time.
  • Multi‑platform view – Watch agents on all supported messaging platforms from a single dashboard.
  • WebSocket streaming – Connects to the OpenClaw gateway (default ws://127.0.0.1:18789) to receive events as they happen.
  • Action tracing – Click a node to expand and inspect the tool arguments and response payloads.
  • Session filtering – Filter by platform or search by recipient ID.
  • QR‑code shortcut – On start a QR code is printed; scanning it opens the monitor on a phone.

How to get it

  1. Via OpenClaw – paste the provided skill URL into an OpenClaw agent to let the agent install or update Crabwalk automatically.
  2. CLI installer – download the latest release tarball, extract it to ~/.crabwalk, and copy the binary to ~/.local/bin.
  3. Docker – pull the image ghcr.io/luccast/crabwalk:latest and run it with the recommended flags (expose port 3000, pass the gateway token, mount the OpenClaw workspace). Host networking may be required if the gateway is bound to loopback only.
  4. From source – git clone, npm install, then npm run dev (requires Node.js).

Running the server

crabwalk                 # start on 0.0.0.0:3000
crabwalk -p 8080        # custom port
crabwalk -t mytoken     # explicit gateway token (auto‑detected from ~/.openclaw/openclaw.json otherwise)
crabwalk start --daemon # run as background service

Typical workflow: start the server, open http://localhost:3000/monitor (or scan the QR code), and watch agents’ conversations appear instantly.

Technical stack – Built with TanStack Start (full‑stack React), ReactFlow for graph rendering, Framer Motion for UI animation, tRPC for type‑safe API calls, and TanStack DB for local data handling.

Who it’s for – Developers or operators who run OpenClaw bots and need a quick visual debugging/observability tool to see what the agents are doing across multiple chat platforms in real time.