Kali Linux 下 OpenClaw 安装与常见问题排查
本文记录了在 Kali Linux 环境下部署 OpenClaw AI 网关的过程。初始遇到 Dashboard 连接失败（4008 错误），经排查发现网关正常但浏览器端认证异常。后续涉及系统升级、依赖修复、浏览器更新及输入法配置等步骤。
第一部分：OpenClaw 基础安装与启动
1.1 安装 OpenClaw
官方提供了多种安装方式（npm、二进制包等）。验证版本：
openclaw --version
1.2 启动网关
网关是 OpenClaw 的核心服务，必须一直运行。打开终端执行：
openclaw gateway run
你会看到类似下面的日志，说明网关启动成功：
[gateway] listening on ws://127.0.0.1:18789, ws://[::1]:18789 (PID xxxx)
注意： 这个终端不要关，保持前台运行，方便看日志。
1.3 生成 Dashboard 访问链接
另开一个终端，执行：
openclaw dashboard --no-open
它会输出一个类似 http://127.0.0.1:18789/#token=一串字符 的 URL。直接复制这个 URL 到浏览器打开，如果一切正常，你会看到 OpenClaw 的 Web 界面。
第二部分：遇到问题——Dashboard 连接失败（4008 错误）
2.1 现象
浏览器打开 Dashboard 后一直显示'disconnected (4008): connect failed'，但 openclaw tui 能用。
2.2 第一步：确认网关是否活着
用 websocat 这个工具直接连接 WebSocket 端口（先安装）：
# 安装 websocat（如果没装）
sudo apt install websocat
# 或者从 GitHub 下载
wget https://github.com/vi/websocat/releases/latest/download/websocat.x86_64-unknown-linux-musl -O websocat
chmod +x websocat
sudo mv websocat /usr/local/bin/
# 测试连接
websocat ws://127.0.0.1:18789
如果看到类似 {"type":"event","event":"connect.challenge","payload":{...}} 的消息，说明网关正常，问题出在浏览器端。
2.3 第二步：浏览器 F12 大法
打开浏览器开发者工具（F12）：
- Console：有没有红色错误？我看到的是
An invalid or illegal string was specified。 - Network → 找到 WebSocket 连接 → ：浏览器有没有发送 消息？我的情况是，导致网关超时断开。
