SkillHub

chrome-attach

v1.0.0

使用 Chrome Session Attach 功能控制用户的浏览器标签页。包括安装 Chrome 扩展、配置连接、Attach/Detach 标签页、截图、导航、填表等操作。

Sourced from ClawHub, Authored by meowlegemy-sudo

Installation

Please help me install the skill `chrome-attach` from SkillHub official store. npx skills add meowlegemy-sudo/chrome-attach

Chrome Session Attach

让 Agent 控制用户已有的 Chrome 标签页，无需在 OpenClaw 管理的浏览器中登录。

前置条件

  1. Gateway 必须运行在本地（127.0.0.1）
  2. Chrome 扩展已加载

安装步骤

1. 获取扩展路径并复制到桌面

openclaw browser extension path
# 输出: ~/.openclaw/browser/chrome-extension

复制到桌面以便访问：

cp -r ~/.openclaw/browser/chrome-extension ~/Desktop/OpenClaw-Extension

2. 在 Chrome 中加载扩展

  1. 打开 Chrome → chrome://extensions
  2. 启用 "Developer mode"（右上角）
  3. 点击 "Load unpacked"
  4. 选择 ~/Desktop/OpenClaw-Extension

3. 配置扩展

点击工具栏的 OpenClaw 扩展图标，配置：

  • Port: Gateway 端口（默认 18789，可在 openclaw gateway status 查看）
  • Token: Gateway token

获取 Token：

cat ~/.openclaw/openclaw.json | jq -r '.gateway.auth.token'

4. Attach 标签页

  1. 在想要控制的标签页点击扩展图标
  2. 点击 "Attach to this tab"
  3. 图标显示 ON = 已连接

可用命令

命令 说明
openclaw browser snapshot 获取页面快照
openclaw browser navigate <url> 导航到 URL
openclaw browser click <ref> 点击元素
openclaw browser type <ref> "text" 输入文字
openclaw browser screenshot 截图
openclaw browser tabs 列出标签页
openclaw browser close <target> 关闭标签页

Detach

点击扩展图标 → 再次点击 "Attach to this tab" 即可断开连接。

故障排除

  • 扩展图标显示红色 ! → Gateway 未运行或端口错误
  • openclaw gateway status 查看 Gateway 状态
  • 确保 Gateway 绑定在 127.0.0.1（非远程模式）