openclaw需通过chrome devtools protocol控制浏览器，须启用远程调试端口、安装chrome relay扩展、配置browser control skill参数、验证指令通路并处理沙箱权限冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望让AI像真人一样操作Chrome浏览器，完成点击、输入、翻页、登录等交互任务，但发现指令无法被正确执行或浏览器无响应，则可能是由于OpenClaw与Chrome之间的通信链路未建立。以下是解决此问题的步骤：
一、配置Chrome远程调试端口
OpenClaw通过Chrome DevTools Protocol（CDP）控制浏览器，必须启用远程调试功能才能建立底层连接。该端口是所有后续自动化操作的数据通道。
1、完全退出当前运行的所有Chrome进程，包括后台残留进程。
2、在终端中执行以下命令启动Chrome并指定调试端口：
macOS：open -a "Google Chrome" --args --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-test
3、Windows用户请使用PowerShell运行：start chrome.exe --remote-debugging-port=9222 --user-data-dir="C: empchrome-test"
4、验证端口是否就绪：在浏览器地址栏访问 http://localhost:9222/json，若返回JSON列表则表示调试服务已激活。
二、安装并启用Chrome Relay扩展
Chrome Relay是OpenClaw官方提供的中继桥接组件，负责将自然语言指令翻译为CDP指令，并转发至Chrome调试端口。缺少该扩展会导致指令解析失败或操作无响应。
1、确保已安装OpenClaw v2026.3.31或更高版本：openclaw --version
2、执行插件安装命令：openclaw plugins install @openclaw/chrome-relay
3、启动Relay服务：openclaw relay --port 18792 --cdp-url http://localhost:9222
4、检查服务状态：访问 http://localhost:18792/health，返回ok即表示中继已就绪。
三、配置Browser Control Skill参数
Browser Control Skill是OpenClaw中处理网页操作的核心技能模块，其配置直接影响Chrome操控的稳定性与兼容性。错误的路径或模式设置会导致浏览器无法启动或操作中断。
1、编辑配置文件 ~/.openclaw/openclaw.json（Windows为 %USERPROFILE%.openclawopenclaw.json）。
2、在skills段中添加或修正browser-control配置：
"browser-control": { "chromePath": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "headless": false, "timeout": 30000 }
3、macOS用户需确认chromePath指向实际安装路径；Windows用户应设为类似 "C:\Program Files\Google\Chrome\Application\chrome.exe"。
4、重启OpenClaw网关服务以加载新配置：openclaw gateway --port 18789
四、验证自然语言指令通路
即使各组件均已安装，若模型未正确绑定或指令解析链断裂，自然语言仍无法触发真实浏览器行为。该步骤用于端到端验证从语义理解到动作执行的完整通路。
1、确保已配置至少一个可用语言模型（如Phi-3-mini、GLM-4.7-Flash或Qwen3-4B），并通过 openclaw models test
2、在Web控制台或CLI中发送标准测试指令：openclaw "用Chrome打开 https://example.com"
3、观察Chrome窗口是否弹出并跳转至目标页面；若无反应，检查Gateway日志中是否出现 "browser-control: launching chrome" 字样。
4、如页面打开但后续操作失败，尝试显式指定动作：openclaw "在地址栏输入 https://baidu.com 并按回车"
五、处理常见权限与沙箱冲突
Chrome在macOS和Linux系统上默认启用沙箱机制，而OpenClaw以非标准方式启动浏览器时可能因权限不足导致CDP连接被拒绝。绕过沙箱并非推荐做法，但临时调试时可启用兼容模式。
1、修改Chrome启动命令，追加禁用沙箱参数：--no-sandbox --disable-setuid-sandbox
2、macOS用户还需额外添加：--disable-gpu --disable-dev-shm-usage
3、重新启动Chrome调试实例，命令示例：
open -a "Google Chrome" --args --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-test --no-sandbox --disable-setuid-sandbox
4、再次运行openclaw指令，确认浏览器窗口可被正常操控且无“Failed to connect to CDP”类报错。
