Chrome Session Attach

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

让 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（非远程模式）