11.13 Chrome扩展

Chrome扩展允许代理控制现有的Chrome标签页,通过工具栏按钮、本地中继服务和MV3扩展实现。

概述

OpenClaw Chrome扩展使代理能够与浏览器中已打开的标签页进行交互和控制。这允许更高级的浏览器自动化场景。

工作原理

• 工具栏按钮: 在Chrome工具栏提供快速访问
• 本地中继: 在 127.0.0.1:18792 运行
• MV3扩展: 使用 chrome.debugger API
• 标签页控制: 直接操作现有的浏览器标签页

安装步骤

1. 从OpenClaw获取Chrome扩展

   openclaw extensions install

2. 在Chrome中加载扩展
   • 打开 chrome://extensions
   • 启用"开发者模式"
   • 点击"加载已解压的扩展程序"
   • 选择扩展目录
3. 启动本地中继服务

   openclaw relay start

配置

{
  "tools": {
    "browser": {
      "extension": {
        "enabled": true,
        "relayPort": 18792
      }
    }
  }
}

使用场景

• 控制现有标签页: 操作已打开的网页
• 多标签协调: 在多个标签页之间协调操作
• 实时监控: 监控和响应页面事件
• 数据提取: 从活动标签页提取数据
• 表单自动化: 自动填写和提交表单

扩展功能

• 页面导航和刷新
• DOM元素操作
• JavaScript执行
• 截图捕获
• 网络请求拦截
• Cookie管理

安全注意事项

故障排除

扩展无法连接

• 确认中继服务正在运行
• 检查端口 18792 是否被占用
• 验证扩展是否已启用

标签页控制失败

• 确保目标标签页已加载完成
• 检查Chrome调试器权限
• 查看扩展控制台的错误信息

文档资源

更多详细信息,请访问:

• 完整文档
• Chrome扩展指南