OpenClaw Chrome扩展使用教程 - 浏览器中继控制
简介
OpenClaw Chrome扩展（浏览器中继）允许AI代理控制您现有的Chrome标签页，而不是启动独立的OpenClaw管理的Chrome配置文件。通过简单的工具栏按钮即可实现附加/分离操作，让您能够灵活地在日常浏览器环境中使用OpenClaw的强大功能。
核心概念
整个系统由三个部分组成：
- 浏览器控制服务（网关或节点）：代理/工具调用的API接口
- 本地中继服务器：在控制服务器和扩展之间建立桥梁（默认http://127.0.0.1:18792）
- Chrome MV3扩展：使用chrome.debugger附加到活动标签页，并将CDP消息传递到中继
安装步骤
1. 安装扩展到本地路径
bash
openclaw browser extension install2. 获取扩展目录路径
bash
openclaw browser extension path3. 在Chrome中加载扩展
- 打开Chrome浏览器，访问
chrome://extensions - 启用"开发者模式"
- 点击"加载已解压的扩展"，选择上一步打印的目录
- 固定扩展程序到工具栏
使用方法
启动浏览器中继
OpenClaw已内置名为"chrome"的浏览器配置文件，默认目标为扩展中继：
CLI方式：
bash
openclaw browser --browser-profile chrome tabs代理工具方式：
javascript
browser with profile="chrome"附加到标签页
- 打开您希望OpenClaw控制的标签页
- 点击Chrome工具栏上的OpenClaw扩展图标
- 当徽章显示"ON"时，表示已成功附加
重要说明：
- 扩展不会自动控制"您正在查看的标签页"
- 只会控制您通过点击工具栏按钮明确附加的标签页
- 要切换控制目标，只需在另一个标签页中点击扩展图标
常见问题
徽章状态说明
- ON: 已附加，OpenClaw可以控制该标签页
- ...: 正在连接到本地中继
- !: 中继无法访问（最常见错误）
解决"!"错误
如果看到"!"徽章，请检查：
- 确保网关在本地运行（默认设置）
- 如果网关在其他机器上运行，请在该机器上启动节点主机
- 打开扩展选项页面，检查中继是否可达
高级配置
创建自定义配置文件
如果您需要不同的名称或不同的中继端口：
bash
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管理配置文件那样的隔离环境
建议：
- 优先使用专用的Chrome配置文件（与个人浏览分离）
- 保持网关和节点主机仅在tailnet内访问
- 避免在LAN或公共Internet上暴露中继端口
- 谨慎授权，只在必要时使用
总结
OpenClaw Chrome扩展为您提供了一种灵活的方式来控制现有浏览器标签页，无需切换独立的配置文件。通过简单的点击操作即可实现AI代理与浏览器的无缝集成，大大提升了自动化操作的便利性。
但请务必注意安全事项，建议在生产环境中使用专用配置文件，并严格控制访问权限，确保您的账户和数据安全。
相关链接：