Browser Local Chrome

Configure and manage local Chrome in debug mode for browser automation with OpenClaw, enabling SSRF whitelist and browser status checks.

浏览器自动化配置技能

配置 OpenClaw 使用本地 Chrome 调试模式进行浏览器自动化。

功能

• ✅ 一键启动 Chrome 调试模式
• ✅ 自动配置 OpenClaw 浏览器设置
• ✅ 启用 SSRF 白名单（允许访问任意网站）
• ✅ 检查浏览器状态

使用方法

一键配置（推荐）

node scripts/setup.js

这会自动完成所有步骤：启动 Chrome → 配置 OpenClaw → 验证状态

分步配置

1. 启动浏览器

node scripts/start-chrome.js

2. 配置 OpenClaw

node scripts/configure-browser.js

3. 重启 Gateway

openclaw gateway restart

4. 检查状态

node scripts/check-status.js

5. 关闭浏览器（使用完成后）

node scripts/stop-chrome.js

配置说明

CDP 端口

默认：9222

用户数据目录

默认：C:\chrome-debug-profile

SSRF 策略

• dangerouslyAllowPrivateNetwork: true - 允许访问任意网站
• 如需更严格的安全策略，可改用 hostnameAllowlist

故障排查

Chrome 无法启动

• 检查 Chrome 是否已安装：C:\Program Files\Google\Chrome\Application\chrome.exe
• 检查端口 9222 是否被占用

浏览器工具不可用

• 确认 Gateway 已重启
• 检查 CDP 连接：curl http://127.0.0.1:9222/json/version

SSRF 错误

• 确认 openclaw.json 中已配置 ssrfPolicy
• 重启 Gateway 使配置生效

适用场景

• 访问需要 JavaScript 渲染的网站
• 自动化网页操作（点击、填写表单等）
• 截图和页面分析
• 绕过 curl 无法处理的动态内容

注意事项

• Chrome 调试模式需要保持运行
• 使用完成后请关闭浏览器：node scripts/stop-chrome.js
• 重启后需要重新启动 Chrome
• 建议将启动脚本添加到开机自启