OpenClaw从入门到应用——工具(Tools):浏览器问题定位
通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》问题“无法在端口 18800 上启动 Chrome CDP”OpenClaw 的浏览器控制服务器无法启动 Chrome/Brave/Edge/Chromium并出现以下错误{error:Error: Failed to start Chrome CDP on port 18800 for profile \openclaw\.}根本原因在 Ubuntu以及许多 Linux 发行版上默认的 Chromium 安装是snap 软件包。Snap 的 AppArmor 限制会干扰 OpenClaw 启动和监控浏览器进程的方式。apt install chromium命令实际上安装的是一个指向 snap 的存根包注意选择 chromium-browser 而非 chromium chromium-browser 已是最新版本 (2:1snap1-0ubuntu2)。这不是一个真正的浏览器——它只是一个包装器。解决方案 1安装 Google Chrome推荐安装官方的 Google Chrome.deb包它不会被 snap 沙箱化wgethttps://dl.google.com/linux/direct/google-chrome-stable_current_amd64.debsudodpkg-igoogle-chrome-stable_current_amd64.debsudoapt--fix-brokeninstall-y# 如果存在依赖错误然后更新你的 OpenClaw 配置文件 (~/.openclaw/openclaw.json){browser:{enabled:true,executablePath:/usr/bin/google-chrome-stable,headless:true,noSandbox:true}}解决方案 2使用 Snap Chromium 的“仅附加”模式如果你必须使用 snap 版本的 Chromium请将 OpenClaw 配置为附加到手动启动的浏览器更新配置{browser:{enabled:true,attachOnly:true,headless:true,noSandbox:true}}手动启动 Chromiumchromium-browser--headless--no-sandbox --disable-gpu\--remote-debugging-port18800\--user-data-dir$HOME/.openclaw/browser/openclaw/user-data\about:blank可选创建一个 systemd 用户服务以自动启动 Chrome# ~/.config/systemd/user/openclaw-browser.service [Unit] DescriptionOpenClaw 浏览器 (Chrome CDP) Afternetwork.target [Service] ExecStart/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port18800 --user-data-dir%h/.openclaw/browser/openclaw/user-data about:blank Restarton-failure RestartSec5 [Install] WantedBydefault.target使用命令启用systemctl --user enable --now openclaw-browser.service验证浏览器是否正常工作检查状态curl-shttp://127.0.0.1:18791/|jq{running, pid, chosenBrowser}测试浏览功能curl-s-XPOST http://127.0.0.1:18791/startcurl-shttp://127.0.0.1:18791/tabs配置参考选项描述默认值browser.enabled启用浏览器控制truebrowser.executablePath基于 Chromium 的浏览器二进制文件路径 (Chrome/Brave/Edge/Chromium)自动检测优先选择基于 Chromium 的默认浏览器browser.headless无 GUI 运行falsebrowser.noSandbox添加--no-sandbox标志某些 Linux 设置需要falsebrowser.attachOnly不启动浏览器仅附加到现有浏览器falsebrowser.cdpPortChrome 开发者工具协议端口18800问题“Chrome 扩展中继正在运行但没有标签页连接”你正在使用一个扩展中继配置文件。它期望 OpenClaw 浏览器扩展程序附加到一个活动的标签页上。修复选项使用托管浏览器openclaw browser start --browser-profile openclaw或设置browser.defaultProfile: openclaw。使用扩展中继安装扩展程序打开一个标签页然后点击 OpenClaw 扩展程序图标以进行附加。注意chrome-relay配置文件会尽可能使用你的系统默认 Chromium 浏览器。本地openclaw配置文件会自动分配cdpPort/cdpUrl这些设置仅用于远程 CDP。