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 搜尋。
  • QR‑code 快捷方式 – 啟動時會印出 QR code，掃描後即可在手機上開啟監控介面。

取得方式

  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 只綁定在 loopback，可能需要使用 host networking。
  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（或掃描 QR code）→ 即時看到代理人的對話。

技術棧 – 使用 TanStack Start（全端 React）、ReactFlow 繪製圖形、Framer Motion 做 UI 動畫、tRPC 提供型別安全的 API 呼叫，以及 TanStack DB 處理本地資料。

適用對象 – 開發者或運維人員，負責執行 OpenClaw 機器人，需要快速的視覺化除錯/可觀測工具，以即時了解代理人在多個聊天平台上的行為。