跳转到主要内容

浏览器故障排除(Linux)

问题:“Failed to start Chrome CDP on port 18800”

OpenClaw 的浏览器控制服务器无法启动 Chrome/Brave/Edge/Chromium,出现以下错误:

根本原因

在 Ubuntu(和许多 Linux 发行版)上,默认的 Chromium 安装是 snap 包。Snap 的 AppArmor 限制会干扰 OpenClaw 启动和监控浏览器进程的方式。 apt install chromium 命令安装的是一个重定向到 snap 的存根包:
这不是真正的浏览器——它只是一个包装器。

解决方案 1:安装 Google Chrome(推荐)

安装官方 Google Chrome .deb 包,它不受 snap 沙箱限制:
然后更新你的 OpenClaw 配置(~/.openclaw/openclaw.json):

解决方案 2:使用 Snap Chromium 的仅附加模式

如果你必须使用 snap Chromium,配置 OpenClaw 附加到手动启动的浏览器:
  1. 更新配置:
  1. 手动启动 Chromium:
  1. 可选创建 systemd 用户服务以自动启动 Chrome:
启用:systemctl --user enable --now openclaw-browser.service

验证浏览器是否工作

检查状态:
测试浏览:

配置参考

问题:“Chrome extension relay is running, but no tab is connected”

你正在使用 chrome 配置文件(扩展中继)。它期望 OpenClaw 浏览器扩展附加到一个活动标签页。 修复选项:
  1. 使用托管浏览器: openclaw browser start --browser-profile openclaw (或设置 browser.defaultProfile: "openclaw")。
  2. 使用扩展中继: 安装扩展,打开一个标签页,然后点击 OpenClaw 扩展图标来附加它。
注意事项:
  • chrome 配置文件在可能时使用你的系统默认 Chromium 浏览器
  • 本地 openclaw 配置文件自动分配 cdpPort/cdpUrl;仅为远程 CDP 设置这些。