OpenClaw Chrome扩展使用教程 - 浏览器中继控制

简介

OpenClaw Chrome扩展（浏览器中继）允许AI代理控制您现有的Chrome标签页，而不是启动独立的OpenClaw管理的Chrome配置文件。通过简单的工具栏按钮即可实现附加/分离操作，让您能够灵活地在日常浏览器环境中使用OpenClaw的强大功能。

核心概念

整个系统由三个部分组成：

1. 浏览器控制服务（网关或节点）：代理/工具调用的API接口
2. 本地中继服务器：在控制服务器和扩展之间建立桥梁（默认http://127.0.0.1:18792）
3. Chrome MV3扩展：使用chrome.debugger附加到活动标签页，并将CDP消息传递到中继

安装步骤

1. 安装扩展到本地路径

openclaw browser extension install

2. 获取扩展目录路径

openclaw browser extension path

3. 在Chrome中加载扩展

1. 打开Chrome浏览器，访问 chrome://extensions
2. 启用"开发者模式"
3. 点击"加载已解压的扩展"，选择上一步打印的目录
4. 固定扩展程序到工具栏

使用方法

启动浏览器中继

OpenClaw已内置名为"chrome"的浏览器配置文件，默认目标为扩展中继：

CLI方式：

openclaw browser --browser-profile chrome tabs

代理工具方式：

browser with profile="chrome"

附加到标签页

1. 打开您希望OpenClaw控制的标签页
2. 点击Chrome工具栏上的OpenClaw扩展图标
3. 当徽章显示"ON"时，表示已成功附加

重要说明：

• 扩展不会自动控制"您正在查看的标签页"
• 只会控制您通过点击工具栏按钮明确附加的标签页
• 要切换控制目标，只需在另一个标签页中点击扩展图标

常见问题

徽章状态说明

• ON: 已附加，OpenClaw可以控制该标签页
• …: 正在连接到本地中继
• !: 中继无法访问（最常见错误）

解决"!"错误

如果看到"!"徽章，请检查：

1. 确保网关在本地运行（默认设置）
2. 如果网关在其他机器上运行，请在该机器上启动节点主机
3. 打开扩展选项页面，检查中继是否可达

高级配置

创建自定义配置文件

如果您需要不同的名称或不同的中继端口：

openclaw browser create-profile \
 --name my-chrome \
 --driver extension \
 --cdp-url http://127.0.0.1:18792 \
 --color "#00AA00"

远程网关设置

当网关运行在另一台机器时，需要在运行Chrome的机器上启动节点主机。网关会将浏览器操作代理到该节点，扩展和中继仍保留在浏览器所在机器上。

安全注意事项

⚠️ 重要安全提醒

此功能非常强大且存在风险，请将其视为赋予模型"在您浏览器上操作的能力"：

• 扩展使用Chrome的调试器API（chrome.debugger）
• 附加后，模型可以：点击/输入/导航、读取页面内容、访问标签页的登录会话
• 这不是像专用OpenClaw管理配置文件那样的隔离环境

建议：

1. 优先使用专用的Chrome配置文件（与个人浏览分离）
2. 保持网关和节点主机仅在tailnet内访问
3. 避免在LAN或公共Internet上暴露中继端口
4. 谨慎授权，只在必要时使用

总结

OpenClaw Chrome扩展为您提供了一种灵活的方式来控制现有浏览器标签页，无需切换独立的配置文件。通过简单的点击操作即可实现AI代理与浏览器的无缝集成，大大提升了自动化操作的便利性。

但请务必注意安全事项，建议在生产环境中使用专用配置文件，并严格控制访问权限，确保您的账户和数据安全。

---

相关链接：

• 浏览器工具概述
• 安全审计
• Tailscale设置