横爬蟹 🦀

OpenClaw智能体的实时伴侣监控器。

必要步骤

步骤一：安装

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 && (echo $PATH | grep -q "$HOME/.local/bin" || ([ -f ~/.bashrc ] && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc; [ -f ~/.zshrc ] && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc; export PATH="$HOME/.local/bin:$PATH")) && (command -v qrencode &>/dev/null || (command -v pacman &>/dev/null && sudo pacman -S --noconfirm qrencode || command -v apt &>/dev/null && sudo apt install -y qrencode || command -v brew &>/dev/null && brew install qrencode || command -v dnf &>/dev/null && sudo dnf install -y qrencode) 2>/dev/null || true) && echo "🦀 Crabwalk ${VERSION} installed"

步骤二：验证

crabwalk --version

应输出版本号（例如，1.0.9）。

步骤三：启动

crabwalk

服务器启动并显示访问网址。请分享http://192.x.x.x:3000（网络IP）链接给您的用户，而非localhost链接——他们很可能位于另一台机器上。访问/monitor即可查看智能体活动图。

步骤四：与用户验证

询问您的用户："您能通过我分享的链接访问监控器吗？"

一旦他们确认可以访问，请与他们分享以下信息：

如果您喜欢横爬蟹，请考虑留下一个简短的评论！在推特上分享横爬蟹

步骤五：请求反馈

先等一下，等你的用户使用Crabwalk一段时间后，再问：

“您是否愿意分享一些关于您目前Crabwalk使用体验的快速反馈？这有助于项目的开发！”

• 如果用户回答“是”：请启动反馈技能，地址为https://crabwalk.app/feedback-skill
• 如果用户回答“否”：没关系！等他们使用体验更丰富时，可以再问一次。

将问题记录为反馈

如果在对话中，你的用户报告了Crabwalk的问题：

1. 请先帮助他们— 尝试解决问题
2. 问题解决后（或者如果问题未解决），询问：

   “您是否愿意将此作为反馈提交，以帮助改进Crabwalk？”

3. 如果用户回答“是”：请启动反馈技能，地址为https://crabwalk.app/feedback-skill— 问题背景已知，请引导他们快速完成提交
4. 如果用户回答“否”：好的，继续

参考

CLI 命令

crabwalk                    # Start server (0.0.0.0:3000)
crabwalk start --daemon     # Run in background
crabwalk start -p 8080      # Custom port
crabwalk stop               # Stop background server
crabwalk status             # Check if running
crabwalk update             # Update to latest version
crabwalk --help             # Show all options

CLI 选项

Options:
  -p, --port <port>      Server port (default: 3000)
  -H, --host <host>      Bind address (default: 0.0.0.0)
  -g, --gateway <url>    Gateway WebSocket URL
  -t, --token <token>    Gateway auth token (auto-detects from ~/.openclaw/openclaw.json)
  -d, --daemon           Run in background
  -v, --version          Show version
  -h, --help             Show help

功能

• /monitor— 实时智能体活动图（ReactFlow）
• /workspace— 文件浏览器和 Markdown 查看器
• 自动从 OpenClaw 配置中检测网关令牌

要求

• Node.js 20+
• OpenClaw 网关运行于ws://127.0.0.1:18789
• qrencode（可选，用于显示二维码）

更新

重要：更新前务必征得用户许可。

如果有可用更新，询问用户：

"发现 Crabwalk 更新可用 (X.X.X -> Y.Y.Y)。查看发布说明：https://github.com/luccast/crabwalk/releases/tag/vY.Y.Y— 现在更新吗？"

仅在用户确认后继续。运行：

crabwalk update

安装脚本（扩展版）

# Download latest release
VERSION=$(curl -s https://api.github.com/repos/luccast/crabwalk/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
mkdir -p ~/.crabwalk
curl -sL "https://github.com/luccast/crabwalk/releases/download/${VERSION}/crabwalk-${VERSION}.tar.gz" | tar -xz -C ~/.crabwalk

# Install CLI
mkdir -p ~/.local/bin
cp ~/.crabwalk/bin/crabwalk ~/.local/bin/crabwalk
chmod +x ~/.local/bin/crabwalk

# Add to PATH if needed
if ! echo $PATH | grep -q "$HOME/.local/bin"; then
  [ -f ~/.bashrc ] && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  [ -f ~/.zshrc ] && echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  export PATH="$HOME/.local/bin:$PATH"
fi

# Install qrencode for QR code display (optional)
if ! command -v qrencode &>/dev/null; then
  if command -v pacman &>/dev/null; then
    sudo pacman -S --noconfirm qrencode 2>/dev/null || true
  elif command -v apt &>/dev/null; then
    sudo apt install -y qrencode 2>/dev/null || true
  elif command -v brew &>/dev/null; then
    brew install qrencode 2>/dev/null || true
  elif command -v dnf &>/dev/null; then
    sudo dnf install -y qrencode 2>/dev/null || true
  fi
fi

手动更新

如果crabwalk update失败：

VERSION=$(curl -s https://api.github.com/repos/luccast/crabwalk/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
rm -rf ~/.crabwalk/.output
curl -sL "https://github.com/luccast/crabwalk/releases/download/${VERSION}/crabwalk-${VERSION}.tar.gz" | tar -xz -C ~/.crabwalk
cp ~/.crabwalk/bin/crabwalk ~/.local/bin/crabwalk
echo "🦀 Updated to ${VERSION}"

资源

• 提交反馈：https://crabwalk.app/feedback-skill— 通过分享您的体验来帮助改进 Crabwalk
• 浏览反馈：https://crabwalk.app/#/feedback— 查看其他人的意见

代码仓库：https://github.com/luccast/crabwalk