🦀 Crabwalk

由 @luccasveg 开发的 OpenClaw (Clawdbot) 代理实时伴侣监控工具。

在实时节点图中查看您的 AI 代理如何在 WhatsApp、Telegram、Discord 和 Slack 上协同工作。即时了解思维状态、工具调用和响应链。

功能

• 实时活动图：使用 ReactFlow 可视化代理会话和动作链
• 多平台支持：同时监控跨所有消息平台的代理
• 实时流式传输：通过 WebSocket 连接到 OpenClaw 网关
• 动作追踪：展开节点以检查工具参数和负载
• 会话筛选：按平台筛选，按接收者搜索

安装

通过 OpenClaw 代理

将此链接粘贴到您的 OpenClaw 代理，并让其安装或更新 Crabwalk：

https://raw.githubusercontent.com/luccast/crabwalk/master/public/skill.md

CLI 安装

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 使用

命令

crabwalk                    # 启动服务器（默认：0.0.0.0:3000）
crabwalk start --daemon     # 在后台运行
crabwalk stop               # 停止后台服务器
crabwalk status             # 检查是否正在运行
crabwalk update             # 更新到最新版本

选项

-p, --port <port>      服务器端口（默认：3000）
-H, --host <host>      绑定地址（默认：0.0.0.0）
-g, --gateway <url>    网关 WebSocket URL（默认：ws://127.0.0.1:18789）
-t, --token <token>    网关认证令牌
-d, --daemon           在后台运行
-v, --version          显示版本

示例

crabwalk -p 8080                           # 自定义端口
crabwalk -t mytoken123                     # 显式指定令牌
crabwalk -g ws://192.168.1.50:18789        # 远程网关
crabwalk start -d -p 8080                  # 在 8080 端口以守护进程模式运行

自动检测

CLI 会自动从 ~/.openclaw/openclaw.json 中检测您的网关令牌——如果您在本地运行 OpenClaw，则无需任何配置。

QR 代码

启动时，Crabwalk 会显示一个二维码，您可以用手机扫描以打开监控界面。需要安装 qrencode（安装程序会自动添加）。

Docker（推荐）

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

注意：当在 Docker 中运行 Crabwalk 时，OpenClaw 网关通常运行在 主机 上。 使用 CLAWDBOT_URL=ws://host.docker.internal:18789 以便容器能够连接。 如果您使用 bind: loopback 和 tailscale serve 来实现仅限尾网的安全访问，则需要以主机网络模式运行 Crabwalk 容器——将 -p:3000:3000 替换为 --network host。 这样可以在保持仅回环绑定的安全优势的同时，使容器能够访问 127.0.0.1:18789。

工作区访问

工作区资源管理器需要访问您的本地文件。默认情况下，它会在 ~/.openclaw/workspace 查找文件。在 Docker 中，请将主机的工作区挂载到容器中的相同路径：

# 默认工作区路径（推荐）
docker run -d \
  -p 3000:3000 \
  -e CLAWDBOT_API_TOKEN=your-token \
  -v ~/.openclaw/workspace:/root/.openclaw/workspace \
  ghcr.io/luccast/crabwalk:latest

# 主机上的自定义工作区路径
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

或者使用 docker-compose：

curl -O https://raw.githubusercontent.com/luccast/crabwalk/master/docker-compose.yml
CLAWDBOT_API_TOKEN=your-token docker-compose up -d

如果要使用自定义工作区路径与 docker-compose，设置 WORKSPACE_HOST_PATH 环境变量：

WORKSPACE_HOST_PATH=/path/to/your/workspace CLAWDBOT_API_TOKEN=your-token docker-compose up -d

如果网关仅 bind: loopback，则需要编辑 docker-compose.yml 以添加 network_mode: host。

从源码编译

git clone https://github.com/luccast/crabwalk.git
cd crabwalk
npm install
CLAWDBOT_API_TOKEN=your-token npm run dev

打开 http://localhost:3000/monitor

配置

需要在同一台机器上运行 OpenClaw 网关。

网关令牌

CLI 会自动从 ~/.openclaw/openclaw.json（位于 gateway.auth.token）中检测您的令牌。本地部署无需手动配置。

如需手动查找令牌：

jq '.gateway.auth.token' ~/.openclaw/openclaw.json

或者显式设置：

crabwalk -t your-token
# 或者
export CLAWDBOT_API_TOKEN=your-token

技术栈

TanStack Start、ReactFlow、Framer Motion、tRPC、TanStack DB

Crabwalk 快速上手指南

Crabwalk 是专为 OpenClaw (Clawdbot) AI 代理设计的实时监控伴侣工具。它通过节点图谱可视化展示代理在 WhatsApp、Telegram、Discord 和 Slack 等平台上的思考状态、工具调用及响应链路。

环境准备

• 操作系统：Linux, macOS, Windows (WSL 推荐)
• 前置依赖：
  • 已安装并运行 OpenClaw Gateway（默认端口 18789）。
  • Docker（推荐安装方式）或 Node.js (v18+) / npm。
  • 若使用 CLI 二维码功能，需安装 qrencode（Docker 镜像已内置）。
• 网络要求：Crabwalk 需能访问 OpenClaw Gateway 的 WebSocket 地址。若 Gateway 仅绑定本地回环 (127.0.0.1)，Docker 运行时需配置宿主机网络或使用 host.docker.internal。

安装步骤

方式一：Docker 安装（推荐）

此方式最简便，自动处理依赖及二维码生成工具。

# 替换 your-token 为你的 OpenClaw Gateway 认证令牌
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 \
  --name crabwalk \
  ghcr.io/luccast/crabwalk:latest

注意：

• CLAWDBOT_URL：若 OpenClaw 运行在宿主机，请使用 ws://host.docker.internal:18789 (Mac/Windows) 或 ws://172.17.0.1:18789 (Linux)。
• 特殊网络配置：若 OpenClaw 配置为 bind: loopback 且通过 Tailscale 等服务暴露，需在 docker 命令中添加 --network host 并移除 -p 3000:3000，以便容器直接访问宿主机的 127.0.0.1。

方式二：CLI 命令行安装

适用于希望将 crabwalk 作为本地二进制文件运行的用户。

# 获取最新版本号并下载安装
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

方式三：通过 OpenClaw Agent 安装

如果你的 OpenClaw 代理已激活，可直接发送以下链接给代理，让其自动安装或更新 Crabwalk：

https://raw.githubusercontent.com/luccast/crabwalk/master/public/skill.md

基本使用

1. 启动服务

Docker 用户： 安装完成后服务已在后台运行。访问 http://localhost:3000 即可打开监控面板。

CLI 用户： 直接运行以下命令启动服务器（默认监听 0.0.0.0:3000）：

crabwalk

若需后台运行：

crabwalk start --daemon

2. 配置连接（通常自动完成）

• 自动检测：若在本地运行 OpenClaw，Crabwalk 会自动从 ~/.openclaw/openclaw.json 读取 Gateway Token，无需额外配置。
• 手动指定：若连接远程 Gateway 或自动检测失败，可使用 -t 和 -g 参数：

# 指定 Token 和远程 Gateway 地址
crabwalk -t mytoken123 -g ws://192.168.1.50:18789

3. 查看监控与手机扫码

• Web 界面：浏览器打开 http://localhost:3000/monitor。
  • 实时图谱：查看 Agent 会话的动作链。
  • 节点详情：点击节点展开查看工具参数 (Args) 和负载 (Payloads)。
  • 筛选：按平台或接收者搜索会话。
• 手机端访问： 启动时终端会显示一个二维码。使用手机扫描该二维码，即可在移动设备上实时查看监控画面（需确保手机与服务器网络互通）。

4. 常用管理命令

crabwalk status     # 检查服务运行状态
crabwalk stop       # 停止后台服务
crabwalk update     # 更新至最新版本