介绍
# Claude Chrome — Browser Automation via Claude Code
使用 Claude Code 的 Chrome 集成来浏览网页、与页面交互并自动化浏览器任务。这是 OpenClaw 内置浏览器工具（Chrome Relay、OpenClaw profile）的替代方案。
## 先决条件
1. **Claude Code** 已安装在节点上（例如 `/opt/homebrew/bin/claude`） 2. **Claude Code Chrome 扩展程序** 已在 Chrome 中安装并启用 3. **Chrome** 正在节点上运行
## 工作原理
Claude Code 可以通过其内置浏览器扩展（MCP 服务器）连接到 Chrome。启用后，Claude Code 将获得浏览器工具——它可以导航页面、点击元素、填写表单、读取内容等。
## 步骤 1：检查 Chrome 扩展程序是否处于活动状态
查找本机主机进程以确认 Chrome 扩展程序正在运行：
```bash nodes.run node=<your-node-id> command='["bash", "-lc", "pgrep -f \"claude --chrome-native-host\""]' ```
如果此命令返回 PID，则 Chrome 扩展程序桥接处于活动状态并准备就绪。
## 步骤 2：运行带有 Chrome 的 Claude Code
使用您的节点通过 `nodes.run` 执行浏览器任务：
```bash 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 分钟） - 复杂工作流（多个页面 + 总结）：`commandTimeoutMs=180000`（3 分钟）
## 性能基准测试
| 任务类型 | 示例 | 持续时间 | 建议超时 | |-----------|---------|----------|---------------------| | **简单** | 读取 Google 上的按钮文本 | 13s | 30s (30000ms) | | **中等** | 维基百科搜索 + 导航 + 总结 | 76s | 2min (120000ms) | | **复杂** | 多页面导航 + 外部链接 | ~90s+ | 3min (180000ms) |
**网关超时说明：** OpenClaw 的网关有一个硬编码的 10 秒连接超时。命令会立即报错，但会继续在后台运行。完成后，结果将通过系统消息返回。
## 限制
- **域名权限：** Claude Code 的 Chrome 扩展程序可能需要用户批准新域名（无法自动化） - **网关超时：** 初始连接在 10 秒后超时，但命令继续运行 - **需要桌面环境：** 仅在具有桌面环境、Chrome 和活动扩展程序的节点上工作
## 提示
- 始终使用 `--dangerously-skip-permissions` 进行自动化运行 - 始终使用 `-p` / `--print` 获取非交互式输出 - 始终使用 `bash -lc` 作为登录 shell（加载 PATH） - 超时时间设置得充裕一些——即使网关超时后，命令也会在后台完成 - Claude Code 可以在单个会话中结合编码和浏览 - 在尝试浏览器任务之前检查本机主机进程 - 对于简单的数据抓取，请考虑改用 `web_fetch`（速度更快，不需要域名权限）