Open-Source Observability · crabwise-ai

crabwalk

Crabwalk is a real-time web-based monitoring dashboard for OpenClaw AI agents, displaying live agent activity across messaging platforms (WhatsApp, Telegram, Discord, Slack) as an interactive node graph. It connects via WebSocket to an OpenClaw gateway and provides session filtering, action tracing, and workspace file exploration.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/crabwise-ai/crabwalk

873

GitHub stars

Forks

TypeScript

Primary language

MIT

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	crabwise-ai/crabwalk
Owner	crabwise-ai
Primary language	TypeScript
License	MIT — OSI-approved
Stars	873
Forks	95
Open issues	9
Latest release	v1.0.11 (2026-02-05)
Last updated	2026-02-19
Source	https://github.com/crabwise-ai/crabwalk

What crabwalk is

TypeScript-based monitoring frontend built on TanStack Start, ReactFlow, and tRPC that streams agent execution state, tool calls, and response chains from an OpenClaw gateway via WebSocket. Deployable as CLI tool, Docker container, or development server with automatic token detection from local OpenClaw config.

Quickstart

Get the crabwalk source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/crabwise-ai/crabwalk.git2cd crabwalk3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Real-time Agent Debugging

Inspect agent decision trees, tool invocations, and payloads as they execute across distributed messaging platforms without log parsing or post-hoc analysis.

Multi-platform Agent Operations

Centralized monitoring dashboard for teams running OpenClaw agents across WhatsApp, Telegram, Discord, and Slack simultaneously with per-platform filtering.

Agent Development & Testing

Fast feedback loop for developers iterating on agent logic—visualize execution chains, validate tool arguments, and detect anomalies in real-time during development.

Implementation considerations

Requires co-located or network-accessible OpenClaw gateway with WebSocket endpoint (default ws://127.0.0.1:18789); firewall/network rules must permit client→gateway connectivity.
Auto-detects gateway token from ~/.openclaw/openclaw.json; explicit token/URL override available via CLI flags or environment variables for non-standard setups.
Docker deployment recommended; verify host.docker.internal or --network host routing if OpenClaw gateway binds to loopback-only (127.0.0.1) for security.
Workspace file explorer requires mounted volume access to ~/.openclaw/workspace; document mount paths and permissions for team onboarding.
QR code display on startup requires qrencode binary; verify installer adds dependency or pre-install in container images.

When to avoid it — and what to weigh

Not Using OpenClaw — Crabwalk is exclusively a companion for OpenClaw agents. If you use other agent frameworks (LangChain, AutoGPT, etc.), this tool is not applicable.
Requires Historical Audit Trail — Crabwalk provides live streaming visualization only. For persistent, queryable audit logs or compliance-grade activity records, consider supplementary logging infrastructure.
Offline or Air-gapped Environments — Requires persistent WebSocket connection to OpenClaw gateway and internet access for CLI/Docker image updates. Not suitable for fully disconnected systems.
Very Early-stage Project Risk Tolerance — Project created 2026-01-25 with v1.0.11 release as of 2026-02-05. Early maturity; evaluate stability and long-term maintenance commitment before critical production use.

License & commercial use

MIT License. Permissive OSI-approved license allowing use, modification, and distribution in proprietary and open-source projects with attribution and no warranty.

MIT License permits commercial use without restriction. No commercial licensing model, dual licensing, or vendor restrictions documented. Verify compliance with any proprietary dependencies (TanStack, ReactFlow, etc.) in your use case, though these are standard web-dev libraries with permissive licenses.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Clear
Deployment complexity	Low
DEV.co fit	Good
Assessment confidence	Medium

Security considerations

Crabwalk accepts a gateway auth token (in env var or CLI flag) and transmits it to connect to OpenClaw gateway. Token stored in plain text in ~/.openclaw/openclaw.json; ensure host file system permissions restrict access. WebSocket connection security depends on OpenClaw gateway implementation (not documented here). No mention of input validation, CSRF protection, or authentication for Crabwalk UI itself—assume it is not hardened for untrusted networks. Requires review of OpenClaw gateway security posture.

Alternatives to consider

LangChain Debugging / LangSmith

Provides real-time tracing and debugging for LangChain agents; generic across agent frameworks but requires LangChain adoption and separate account.

Custom Log Aggregation + Grafana

OpenClaw Native UI (if available)

If OpenClaw includes built-in monitoring UI, it may obviate Crabwalk; verify feature parity before adopting separate tool.

Software development agency

Build on crabwalk with DEV.co software developers

Deploy Crabwalk in minutes via CLI or Docker. Get real-time visibility into agent behavior across all platforms. MIT licensed, free to use.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

opik-openclaw traceway skywalking-java

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source Observability AI Development DevOps Talk to DEV.co

crabwalk FAQ

Can Crabwalk monitor remote OpenClaw gateways?

Yes. Use -g / --gateway flag or CLAWDBOT_URL env var to point to remote ws:// address. Ensure network routing permits client→gateway connectivity and firewall allows WebSocket ingress.

What happens if the gateway connection drops?

Not documented. Assume UI degrades gracefully or shows disconnection state; verify reconnection behavior and retry logic before deploying to production.

Does Crabwalk store or persist activity logs?

No. Crabwalk is a live visualization tool only. For persistent audit trails, implement separate logging to file system, database, or log aggregation service.

Is Crabwalk suitable for multi-tenant or RBAC scenarios?

No. Single-user dashboard with no built-in authentication, authorization, or tenant isolation. Each Crabwalk instance shares token with OpenClaw gateway. For multi-tenant, implement reverse proxy with auth layer or deploy separate Crabwalk instances.

Software developers & web developers for hire

Adopting crabwalk is usually one piece of a larger software development effort. As a software development agency, DEV.co provides software development services and web development expertise — pairing senior software developers and web developers with your team to design, build, and operate open-source observability software in production.

Start Monitoring Your OpenClaw Agents

Deploy Crabwalk in minutes via CLI or Docker. Get real-time visibility into agent behavior across all platforms. MIT licensed, free to use.

Talk to DEV.co Schedule a Consultation