Claude Chrome —— 通过Claude Code实现浏览器自动化

利用Claude Code的Chrome集成功能浏览网页、与页面交互并自动化浏览器任务。这是OpenClaw内置浏览器工具（Chrome Relay、OpenClaw配置文件）的替代方案。

先决条件

1. Claude Code已安装在节点上（例如/opt/homebrew/bin/claude）
2. Claude Code Chrome扩展程序已在Chrome中安装并启用
3. Chrome浏览器在节点上运行

工作原理

Claude Code可通过其内置浏览器扩展（MCP服务器）连接到Chrome。启用后，Claude Code将获得浏览器工具——能够导航页面、点击元素、填写表单、读取内容等。

步骤1：检查Chrome扩展是否处于活动状态

查找原生主机进程以确认Chrome扩展正在运行：

nodes.run node=<your-node-id> command='["bash", "-lc", "pgrep -f \"claude --chrome-native-host\""]'

若返回PID，则表示Chrome扩展桥接器已激活并准备就绪。

步骤2：运行带Chrome连接的Claude Code

使用节点运行配合您的节点执行浏览器任务：

nodes.run node=<your-node-id> commandTimeoutMs=120000 command='["bash", "-lc", "claude --dangerously-skip-permissions --chrome -p \"Go to example.com and read the headline\""]'

标志参数：

• --dangerously-skip-permissions— 自动批准所有操作（自动化必需）
• --chrome— 启用Chrome浏览器集成
• -p/--print— 非交互式打印模式（自动化使用必需）
• bash -lc— 登录shell以确保加载PATH环境变量

超时设置：请参考下方基准测试指南。推荐默认值：

• 简单任务（单页面读取）：commandTimeoutMs=30000（30秒）
• 中等复杂度任务（多步骤导航）：commandTimeoutMs=120000（2分钟）
• 复杂工作流（多页面操作+摘要生成）：命令超时时间=180000毫秒（3分钟）

性能基准

网关超时说明：OpenClaw网关采用硬编码的10秒连接超时设置。命令会立即报错但仍在后台运行。任务完成后结果将通过系统消息送达。

限制

• 域名权限：Claude Code的Chrome扩展可能需要用户对新域名进行授权（无法自动化）
• 网关超时：初始连接在10秒后超时，但命令会继续运行
• 需要桌面环境：仅适用于具备桌面环境、Chrome浏览器且扩展处于活动状态的节点

使用技巧

• 自动化运行时务必使用--dangerously-skip-permissions参数
• 非交互式输出务必使用-p或--print参数
• 为加载PATH环境变量务必使用bash -lc启动登录shell
• 超时设置要严格——即使网关超时后命令仍会在后台完成执行
• Claude Code可在单次会话中同时进行编码和浏览操作
• 执行浏览器任务前请先检查原生主机进程
• 对于简单的数据抓取任务，建议web_fetch替代方案（速度更快，无需域名权限）