crabwise-ai/crabwalk

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

🦀 Crabwalk – OpenClaw 代理人的实时监控

它是什么 – 一个轻量级的 Web UI，可视化 OpenClaw（Clawdbot）AI 代理人在 WhatsApp、Telegram、Discord 或 Slack 上的对话活动。它显示每个会话的实时节点图、代理调用的工具以及系统中流动的 payload。

关键能力

  • 实时活动图 – ReactFlow 实时渲染代理会话及其动作链。
  • 多平台视图 – 在单一仪表盘上观看所有支持的消息平台上的代理。
  • WebSocket 流式 – 连接到 OpenClaw gateway（默认 ws://127.0.0.1:18789）实时接收事件。
  • 动作追踪 – 点击节点展开并检查工具参数和响应 payload。
  • 会话过滤 – 按平台过滤或按收件人 ID 搜索。
  • 二维码快捷方式 – 启动时会打印二维码，扫描后在手机上打开监控界面。

获取方式

  1. 通过 OpenClaw – 将提供的 skill URL 粘贴到 OpenClaw 代理，使其自动安装或更新 Crabwalk。
  2. CLI 安装器 – 下载最新的 release tarball，解压到 ~/.crabwalk，并将二进制文件复制到 ~/.local/bin。
  3. Docker – 拉取镜像 ghcr.io/luccast/crabwalk:latest，使用推荐的标志运行（暴露 3000 端口、传入 gateway token、挂载 OpenClaw 工作区）。如果 gateway 只绑定到回环接口，可能需要使用 host 网络。
  4. 从源码 – git clone、npm install，然后 npm run dev（需要 Node.js）。

运行服务器

crabwalk                 # 在 0.0.0.0:3000 启动
crabwalk -p 8080        # 自定义端口
crabwalk -t mytoken     # 明确指定 gateway token（否则自动从 ~/.openclaw/openclaw.json 检测）
crabwalk start --daemon # 作为后台服务运行

典型工作流：启动服务器 → 打开 http://localhost:3000/monitor（或扫描二维码）→ 实时观看代理对话出现。

技术栈 – 基于 TanStack Start（全栈 React），使用 ReactFlow 绘制图形，Framer Motion 实现 UI 动画，tRPC 提供类型安全的 API 调用，TanStack DB 处理本地数据。

适用人群 – 开发者或运维人员，运行 OpenClaw 机器人并需要快速的可视化调试/可观测工具，以实时查看代理人在多个聊天平台上的行为。