openclaw浏览器自动化可通过四种方式启用:一、启用内置managed浏览器;二、复用现有chrome登录态(cdp直连);三、部署extension relay中继插件;四、启用远程cdp连接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望OpenClaw接管浏览器执行自动化操作,但当前处于未启用状态或无法响应网页指令,则可能是由于浏览器控制模块未激活、配置缺失或调试端口未就绪。以下是开启OpenClaw浏览器自动化的具体操作步骤:
一、启用内置Managed浏览器(独立隔离实例)
该方式由OpenClaw通过Playwright直接启动专属Chrome/Chromium实例,完全独立于用户日常浏览器,具备完整DOM控制权与无头支持,适用于需长期运行、多账号并行或表单深度交互的场景。
1、安装Playwright核心依赖:执行playwright install chromium(Linux/macOS)或playwright install-deps chromium(Ubuntu需额外系统库)。
2、编辑全局配置文件:~/.openclaw/openclaw.json,在browser节点下写入:
{"mode": "managed", "headless": false, "defaultProfile": "openclaw"}
3、设置浏览器可执行路径:运行openclaw config set browser.executablePath "/usr/bin/google-chrome"(路径需与which google-chrome输出一致)。
4、强制解除沙箱限制(尤其root运行时):执行openclaw config set browser.noSandbox true。
5、重启网关服务:运行openclaw gateway restart,随后检查状态是否显示running:true。
二、复用现有Chrome登录态(CDP直连模式)
此方法通过Chrome DevTools Protocol连接用户正在使用的Chrome进程,直接继承全部Cookie、LocalStorage及已登录会话,避免重复认证,适合快递查询、账单下载等需身份延续的操作。
1、关闭所有Chrome窗口,终端中执行启动命令:google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-remote。
2、验证端口可用性:运行lsof -i :9222或访问http://localhost:9222/json确认返回标签页列表。
3、在配置文件中添加现有会话配置:
"my-logged-in-chrome": {"driver": "existing-session", "attachOnly": true, "cdpUrl": "http://localhost:9222"}
4、启用该配置为默认:执行openclaw config set browser.defaultProfile "my-logged-in-chrome"。
5、重启网关后,下达自然语言指令如:“用当前Chrome打开12306,查询今日北京到上海的高铁余票”。
为 OpenClaw 创建可直接分流的 GitHub issue 草稿,用于报告代理缓慢、损坏、无响应、工具匮乏、性能下降或“不够智能”等问题。使用 ...
三、部署Extension Relay中继插件(安全接管当前标签页)
该方式不修改主浏览器配置,仅通过Chrome MV3扩展监听本地中继服务(默认127.0.0.1:18792),以插件权限注入控制能力,兼顾企业合规性与个人隐私保护。
1、访问https://chrome.google.com/webstore/detail/openclaw-relay/安装官方扩展(ID可在ClawHub查得)。
2、将扩展固定至Chrome工具栏,并点击图标进入设置页。
3、填入Web控制台生成的token(位于http://localhost:8000/settings或CLI输出中)。
4、打开需控制的任意标签页,在扩展面板中找到对应条目,点击开关切换为ON状态。
5、触发指令时明确指定上下文,例如:“在当前已ON的知乎标签页中,滚动到底部并点击‘展开更多回答’”。
四、启用远程CDP连接(跨设备浏览器控制)
适用于服务器部署、云端浏览器集群或高隔离需求环境,OpenClaw可通过WebSocket协议连接远端Chromium实例,实现资源集中调度与物理隔离。
1、在目标远程主机启动Chrome并暴露CDP端口:chromium --remote-debugging-port=9222 --host-rules="MAP * 0.0.0.0" --disable-web-security。
2、确保防火墙放行9222端口,并测试连通性:curl http://:9222/json应返回有效JSON。
3、在openclaw.json中新增远程节点配置:
"remote-chrome": {"driver": "cdp", "cdpUrl": "ws://:9222"}
4、设为默认配置:openclaw config set browser.defaultProfile "remote-chrome"。
5、执行指令时AI将自动通过WebSocket通道下发操作,例如:“在远程浏览器中访问京东,搜索‘机械键盘’,按销量排序并截图前三页”。









