OpenClaw Chrome 浏览器中继连不上？完整排查指南（2026）

2026年2月24日

OpenClaw Chrome 浏览器中继连不上？完整排查指南

OpenClaw 的 Chrome 浏览器中继（Browser Relay）让你的 AI 代理实时查看和操作浏览器标签页。正常工作时，代理可以自动填表、提取数据、完成各种网页操作。连不上时，你只会看到 “no tab connected” 错误。

本文覆盖所有已知的 Chrome Relay 故障及修复方法。

工作原理（30 秒了解）

OpenClaw Chrome 扩展 在你的浏览器中运行
点击工具栏图标附加当前标签页（徽章亮起）
扩展通过 WebSocket 连接到 OpenClaw 网关
代理就能看到页面快照并执行操作

任何一个环节断裂，中继就会静默失败。

快速诊断

# 检查网关是否运行
openclaw gateway status

# 查看网关日志中的 WebSocket 错误
journalctl -u openclaw-gateway --since "10 min ago" | grep -i "relay\|websocket\|browser"

# 确认网关端口在监听
ss -tlnp | grep 3100

问题 1：扩展徽章点了不亮

症状： 点击 OpenClaw Browser Relay 工具栏图标，徽章没有激活，什么都没发生。

修复：检查扩展安装

打开 chrome://extensions/
找到 OpenClaw Browser Relay
确认已启用（开关为蓝色）
点击 详情 → 扩展程序选项，确认网关 URL 正确：
- 本地：ws://localhost:3100
- 远程 VPS：wss://your-domain.com:3100

修复：重新加载扩展

chrome://extensions/ → OpenClaw Browser Relay → 点击刷新 ↻ 图标

然后关闭并重新打开目标标签页。

修复：检查受限页面

Chrome 扩展无法附加到：

chrome:// 页面（设置、扩展等）
chrome-extension:// 页面
Chrome 网上应用店（chromewebstore.google.com）
PDF 查看器标签页（部分情况）

先导航到普通网页，再点击中继图标。

问题 2：徽章亮了但代理显示「无已连接标签页」

症状： 工具栏徽章已激活，但代理仍然无法看到标签页。

修复：检查网关 WebSocket 地址

最常见原因是 网关 URL 不匹配。扩展必须连接到网关实际监听的地址。

# 查看网关监听地址
openclaw gateway status

# 查看配置中的 WebSocket 端口
cat ~/.openclaw/config.yaml | grep -A5 "gateway"

确保扩展配置的 URL 与实际一致。如果网关在 VPS 上，需要 wss://（不是 ws://）和正确端口。

修复：防火墙阻止 WebSocket

如果从本地浏览器连接远程 VPS：

# 在 VPS 上检查端口是否开放
sudo ufw status | grep 3100

# 如果没有列出，允许该端口
sudo ufw allow 3100/tcp

# iptables 用户
sudo iptables -L -n | grep 3100

💡 VPS 推荐： 需要稳定的 VPS 运行 OpenClaw？Vultr 最低 $6/月，全球节点，SSD 高速存储。DigitalOcean 新用户送 $200 额度，也是不错的选择。

修复：SSL/TLS 证书问题（远程部署）

wss:// 连接需要有效的 TLS 证书。自签名证书会导致 WebSocket 静默失败。

# 检查证书是否有效
openssl s_client -connect your-domain.com:3100 -servername your-domain.com </dev/null 2>&1 | grep "Verify return code"

# 使用 Let's Encrypt 的话，过期了就续期
sudo certbot renew
sudo systemctl restart openclaw-gateway

修复：反向代理配置错误（Nginx/Caddy）

如果通过 Nginx 代理，必须设置 WebSocket 升级头：

location /relay {
    proxy_pass http://127.0.0.1:3100;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_read_timeout 86400;
}

Caddy 自动处理 WebSocket：

your-domain.com {
    reverse_proxy localhost:3100
}

问题 3：中继连上后又断开

症状： 中继工作几秒或几分钟后断开。

修复：增加代理超时

Nginx 默认 60 秒断开空闲 WebSocket 连接：

proxy_read_timeout 86400;  # 24 小时
proxy_send_timeout 86400;

重载 Nginx：

sudo nginx -t && sudo systemctl reload nginx

修复：检查网关资源占用

网关内存或 CPU 不足时，WebSocket 连接会被丢弃：

# 检查网关资源使用
systemctl status openclaw-gateway
free -h
top -p $(pgrep -f openclaw)

💡 性能提示： 稳定的中继连接建议 2GB+ 内存。腾讯云轻量应用服务器性价比高，非常适合跑 OpenClaw。Vultr 的高频计算方案也很好用。

修复：浏览器休眠标签页

Chrome 会积极挂起后台标签页。如果长时间切走附加的标签页，扩展可能断连。

临时方案： 保持附加标签页可见或固定（Pin）
更好的方案： 长时间自动化任务使用 openclaw 内置浏览器配置文件，而非 Chrome 中继

问题 4：代理操作在页面上不生效

症状： 中继已连接，快照正常，但点击/输入没有反应。

修复：检查 iframe 和 Shadow DOM

部分网站使用 iframe 或 Shadow DOM，中继默认无法交互。尝试：

使用 snapshot 时加 depth 参数查看嵌套 frame
在操作命令中指定 frame 参数
复杂 SPA 页面可用 act + evaluate 直接执行 JS

修复：页面有遮罩/弹窗

如果 Cookie 横幅、弹窗或遮罩层挡住了目标元素：

# 在对话中告诉代理：
1. 先截取快照
2. 关闭遮罩层
3. 再执行目标操作

修复：CSP 策略阻止

部分网站通过 CSP 阻止扩展交互。按 F12 → Console 查看是否有 CSP 报错。严格 CSP 无法绕过——请改用 OpenClaw 内置浏览器配置文件。

问题 5：「Profile Not Found」或「Browser Not Started」

症状： 代理提示浏览器配置文件不存在或未启动。

修复：理解两种浏览器配置文件

OpenClaw 有两种浏览器配置：

配置文件	说明	使用场景
`chrome`	通过中继扩展使用你的 Chrome	需要已登录的会话、Cookie 等
`openclaw`	OpenClaw 托管的独立 Chromium	自动化、抓取、不需要登录态的任务

chrome 配置需要安装扩展并附加标签页。

openclaw 配置：

# 重启网关，内置浏览器会自动启动
openclaw gateway restart

稳定中继配置清单

✅ 网关运行正常（openclaw gateway status） ✅ 扩展已安装、启用，URL 配置正确 ✅ 防火墙允许网关端口 ✅ 远程部署：有效 TLS 证书 + 正确的 WebSocket 代理配置 ✅ Nginx/Caddy 超时设为 86400+ ✅ 标签页是普通网页（非 chrome:// 等受限页面） ✅ 标签页已固定或可见（未被休眠）

还是不行？

实时查看网关日志：
```
journalctl -u openclaw-gateway -f
```
查看扩展控制台： 右键点击扩展图标 → “检查弹出窗口” → Console 标签

手动测试 WebSocket：

# 安装 wscat
npm i -g wscat
wscat -c ws://localhost:3100

🚀 全新部署？ 查看我们的 VPS 完整部署指南，经过实战检验。推荐 DigitalOcean（新用户 $200 额度）或 Vultr。

最后更新：2026 年 2 月 24 日。发现问题？欢迎提 PR 或在 Telegram 联系我们。

这篇文章有帮助吗？

💬 提交详细建议（GitHub Issue）