news 2026/5/8 16:58:09

OpenClaw从入门到应用——工具(Tools):浏览器问题定位

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
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 配置为附加到手动启动的浏览器:

  1. 更新配置:
{"browser":{"enabled":true,"attachOnly":true,"headless":true,"noSandbox":true}}
  1. 手动启动 Chromium:
chromium-browser--headless--no-sandbox --disable-gpu\--remote-debugging-port=18800\--user-data-dir=$HOME/.openclaw/browser/openclaw/user-data\about:blank&
  1. (可选)创建一个 systemd 用户服务以自动启动 Chrome:
# ~/.config/systemd/user/openclaw-browser.service [Unit] Description=OpenClaw 浏览器 (Chrome CDP) After=network.target [Service] ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.openclaw/browser/openclaw/user-data about:blank Restart=on-failure RestartSec=5 [Install] WantedBy=default.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启用浏览器控制true
browser.executablePath基于 Chromium 的浏览器二进制文件路径 (Chrome/Brave/Edge/Chromium)自动检测(优先选择基于 Chromium 的默认浏览器)
browser.headless无 GUI 运行false
browser.noSandbox添加--no-sandbox标志(某些 Linux 设置需要)false
browser.attachOnly不启动浏览器,仅附加到现有浏览器false
browser.cdpPortChrome 开发者工具协议端口18800

问题:“Chrome 扩展中继正在运行,但没有标签页连接”

你正在使用一个扩展中继配置文件。它期望 OpenClaw 浏览器扩展程序附加到一个活动的标签页上。

修复选项:

  1. 使用托管浏览器:openclaw browser start --browser-profile openclaw
    (或设置browser.defaultProfile: "openclaw")。
  2. 使用扩展中继:安装扩展程序,打开一个标签页,然后点击 OpenClaw 扩展程序图标以进行附加。

注意:

  • chrome-relay配置文件会尽可能使用你的系统默认 Chromium 浏览器
  • 本地openclaw配置文件会自动分配cdpPort/cdpUrl;这些设置仅用于远程 CDP。
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/8 16:56:49

【读书笔记】《欧阳修传》

《欧阳修传》世俗的圣贤每天一本书,人生不迷路,读书的第781天,愿我们都不在人生的岔路口走丢 欢迎点关注,一起读书成长 📚一、为何了解欧阳修? 苏东坡的才华过于耀眼,不是常人可以企及的。而欧阳…

作者头像 李华
网站建设 2026/5/8 16:56:41

物联感知+智能预警!建筑垃圾运输安全可控

城市建筑垃圾专项监管系统深度融合物联网技术,打造智能运输监管新模式。系统为渣土车配备物联感知设备,实时监控驾驶员驾驶行为和运输轨迹,自动识别超速、疲劳驾驶、偏离路线等违规行为。运输企业和车辆纳入信用管理体系,系统记录…

作者头像 李华
网站建设 2026/5/8 16:55:35

WVP-PRO + ZLMediaKit 视频流媒体平台实战部署(附腾讯云避坑指南)

最近帮客户部署了一套基于 WVP-PRO 的 GB28181 视频流媒体平台,过程中踩了不少坑,特别是腾讯云服务器端口封禁的问题,折腾了好几天才解决。记录一下完整过程,供有需要的同学参考。一、环境说明项目版本/配置服务器腾讯云 4核8G Ub…

作者头像 李华
网站建设 2026/5/8 16:55:31

航空电子硬件设计:DO-254标准下的RTL代码验证与自动化实践

1. 项目概述:为什么航空电子设计需要一个“铁律”?作为一名在数字设计领域摸爬滚打了十几年的工程师,我参与过消费电子、工业控制,也深度涉足过汽车电子。但当我第一次接触航空电子硬件设计时,才真正体会到什么叫“如履…

作者头像 李华
网站建设 2026/5/8 16:55:31

SoC动态功耗分析新范式:Veloce DRW API实现实时流式处理

1. 项目概述:为什么传统动态功耗估算方法在大型SoC面前“失灵”了?如果你是一位芯片设计工程师,或者正在从事SoC(片上系统)的验证工作,那么“动态功耗估算”这个词对你来说一定不陌生。它就像给芯片做“体检…

作者头像 李华
网站建设 2026/5/8 16:55:24

座舱式个人飞行器 - 工程设计图纸

座舱式个人飞行器 - 工程设计图纸 图纸目录 图号 名称 比例 图1 总体外形三视图 1:20 图2 俯视图(16电机布局) 1:10 图3 侧视图(座舱截面) 1:10 图4 正视图(前后方向) 1:20 图5 座舱结构图 1:10 图6 安全系统布置图 1:10 图7 动力系统接线图 1:20 图8 双GPS安装图 1:5 图…

作者头像 李华