crabwise-ai/crabwalk

crabwise-ai profile

Latest recorded source activity: February 3, 2026 at 20:09

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 1

GitHub stars: 874
GitHub forks: 95

Repository README

Repository README source: README.md

Read the source README

Expand full README

# 🦀 Crabwalk Real-time companion monitor for [OpenClaw (Clawdbot)](https://github.com/openclaw/openclaw) 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 openclaw gateway - **Action tracing** - Expand nodes to inspect tool args and payloads - **Session filtering** - Filter by platform, search by recipient ## Installation ### Via OpenClaw Agent Paste this link to your OpenClaw agent and ask it to install/update Crabwalk: ``` https://raw.githubusercontent.com/luccast/crabwalk/master/public/skill.md ``` ### CLI Install ```bash VERSION=$(curl -s https://api.github.com/repos/luccast/crabwalk/releases/latest | grep '"tag_name"' | cut -d'"' -f4) mkdir -p ~/.crabwalk ~/.local/bin curl -sL "https://github.com/luccast/crabwalk/releases/download/${VERSION}/crabwalk-${VERSION}.tar.gz" | tar -xz -C ~/.crabwalk cp ~/.crabwalk/bin/crabwalk ~/.local/bin/ chmod +x ~/.local/bin/crabwalk ``` ## CLI Usage ### Commands ```bash crabwalk # Start server (default: 0.0.0.0:3000) crabwalk start --daemon # Run in background crabwalk stop # Stop background server crabwalk status # Check if running crabwalk update # Update to latest version ``` ### Options ``` -p, --port <port> Server port (default: 3000) -H, --host <host> Bind address (default: 0.0.0.0) -g, --gateway <url> Gateway WebSocket URL (default: ws://127.0.0.1:18789) -t, --token <token> Gateway auth token -d, --daemon Run in background -v, --version Show version ``` ### Examples ```bash crabwalk -p 8080 # Custom port crabwalk -t mytoken123 # Explicit token crabwalk -g ws://192.168.1.50:18789 # Remote gateway crabwalk start -d -p 8080 # Daemon on port 8080 ``` ### Auto-detection The CLI automatically detects your gateway token from `~/.openclaw/openclaw.json` - no config needed if you're running OpenClaw locally. ### QR Code On startup, Crabwalk displays a QR code you can scan to open the monitor on your phone. Requires `qrencode` installed (the installer adds it automatically). ### Docker (recommended) ```bash docker run -d \ -p 3000:3000 \ -e CLAWDBOT_API_TOKEN=your-token \ -e CLAWDBOT_URL=ws://host.docker.internal:18789 \ -v ~/.openclaw/workspace:/root/.openclaw/workspace \ ghcr.io/luccast/crabwalk:latest ``` > Note: When running Crabwalk in Docker, the OpenClaw gateway typically runs on the _host_. > Use `CLAWDBOT_URL=ws://host.docker.internal:18789` so the container can connect. > If you're running OpenClaw with `bind: loopback` and `tailscale serve` for secure tailnet-only access, you'll need to run the crabwalk container with host networking - replace `p:3000:3000` with `--network host` > This allows the container to reach 127.0.0.1:18789 while maintaining the security benefits of loopback-only binding. #### Workspace Access The workspace explorer needs access to your local files. By default, it looks for files at `~/.openclaw/workspace`. In Docker, mount your host workspace to the same path in the container: ```bash # Default workspace path (recommended) docker run -d \ -p 3000:3000 \ -e CLAWDBOT_API_TOKEN=your-token \ -v ~/.openclaw/workspace:/root/.openclaw/workspace \ ghcr.io/luccast/crabwalk:latest # Custom workspace path on host docker run -d \ -p 3000:3000 \ -e CLAWDBOT_API_TOKEN=your-token \ -v /path/to/your/workspace:/root/.openclaw/workspace \ ghcr.io/luccast/crabwalk:latest ``` Or with docker-compose: ```bash curl -O https://raw.githubusercontent.com/luccast/crabwalk/master/docker-compose.yml CLAWDBOT_API_TOKEN=your-token docker-compose up -d ``` To use a custom workspace path with docker-compose, set the `WORKSPACE_HOST_PATH` environment variable: ```bash WORKSPACE_HOST_PATH=/path/to/your/workspace CLAWDBOT_API_TOKEN=your-token docker-compose up -d ``` > If gateway is `bind: loopback` only, you will need to edit the `docker-compose.yml` to add `network_mode: host` ### From source ```bash git clone https://github.com/luccast/crabwalk.git cd crabwalk npm install CLAWDBOT_API_TOKEN=your-token npm run dev ``` Open `http://localhost:3000/monitor` ## Configuration Requires OpenClaw gateway running on the same machine. ### Gateway Token The CLI auto-detects your token from `~/.openclaw/openclaw.json` (at `gateway.auth.token`). No manual config needed for local setups. To find your token manually: ```bash jq '.gateway.auth.token' ~/.openclaw/openclaw.json ``` Or set it explicitly: ```bash crabwalk -t your-token # or export CLAWDBOT_API_TOKEN=your-token ``` ## Stack TanStack Start, ReactFlow, Framer Motion, tRPC, TanStack DB

Loading the repository README…

Skills in this repository

Network & Computer Systems Administrators

1 occupation categories · 100% classified

skill

occupation

description

updated

crabwalk

Network & Computer Systems Administrators

Real-time companion monitor for OpenClaw agents

2026-02-03

Showing 1 of 1 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/crabwise-ai/crabwalk.