← Back to Skills Marketplace
Chrome Session Attach
by
meowlegemy-sudo
· GitHub ↗
· v1.0.0
· MIT-0
329
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install chrome-attach
Description
使用 Chrome Session Attach 功能控制用户的浏览器标签页。包括安装 Chrome 扩展、配置连接、Attach/Detach 标签页、截图、导航、填表等操作。
README (SKILL.md)
Chrome Session Attach
让 Agent 控制用户已有的 Chrome 标签页,无需在 OpenClaw 管理的浏览器中登录。
前置条件
- Gateway 必须运行在本地(127.0.0.1)
- Chrome 扩展已加载
安装步骤
1. 获取扩展路径并复制到桌面
openclaw browser extension path
# 输出: ~/.openclaw/browser/chrome-extension
复制到桌面以便访问:
cp -r ~/.openclaw/browser/chrome-extension ~/Desktop/OpenClaw-Extension
2. 在 Chrome 中加载扩展
- 打开 Chrome →
chrome://extensions - 启用 "Developer mode"(右上角)
- 点击 "Load unpacked"
- 选择
~/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 标签页
- 在想要控制的标签页点击扩展图标
- 点击 "Attach to this tab"
- 图标显示 ON = 已连接
可用命令
| 命令 | 说明 |
|---|---|
openclaw browser snapshot |
获取页面快照 |
openclaw browser navigate \x3Curl> |
导航到 URL |
openclaw browser click \x3Cref> |
点击元素 |
openclaw browser type \x3Cref> "text" |
输入文字 |
openclaw browser screenshot |
截图 |
openclaw browser tabs |
列出标签页 |
openclaw browser close \x3Ctarget> |
关闭标签页 |
Detach
点击扩展图标 → 再次点击 "Attach to this tab" 即可断开连接。
故障排除
- 扩展图标显示红色 ! → Gateway 未运行或端口错误
openclaw gateway status查看 Gateway 状态- 确保 Gateway 绑定在 127.0.0.1(非远程模式)
Usage Guidance
This skill will instruct you (or the agent) to read files under ~/.openclaw and to copy/load a local Chrome extension that uses a Gateway token from ~/.openclaw/openclaw.json. The registry metadata did not declare those config paths or credentials — that's the primary inconsistency. Before installing or using: (1) Verify the origin and contents of the Chrome extension being loaded; only load unpacked extensions you trust. (2) Confirm the Gateway is intended to run on 127.0.0.1 and that exposing its token to a browser extension is acceptable for your threat model. (3) Inspect ~/.openclaw/openclaw.json yourself rather than running untrusted commands that cat it; avoid pasting the token into third-party sites. (4) Consider not copying sensitive files to a public Desktop folder; use a secure location with strict permissions. (5) Ask the publisher to update the skill metadata to explicitly declare required config paths/credentials (e.g., required config path: ~/.openclaw/openclaw.json) so you can make an informed decision. The mismatch between instructions and declared requirements is why this is flagged as suspicious.
Capability Analysis
Type: OpenClaw Skill
Name: chrome-attach
Version: 1.0.0
The skill bundle provides instructions for a 'chrome-attach' feature that allows the OpenClaw agent to interact with a user's existing Chrome browser tabs. The process requires manual user intervention, including loading a local extension and configuring it with a gateway token retrieved via standard CLI commands. The instructions in SKILL.md are transparent, and the listed commands (e.g., snapshot, navigate, click) are standard browser automation functions without evidence of malicious intent or automated exfiltration.
Capability Assessment
Purpose & Capability
The skill's stated purpose (attach to and control Chrome tabs) matches the runtime instructions (install local extension, connect to a local Gateway, run openclaw browser commands). However, the skill metadata lists no required config paths, env vars, or credentials even though the instructions explicitly read files under ~/.openclaw (extension path and openclaw.json token). The omission is inconsistent and unexplained.
Instruction Scope
SKILL.md instructs the user/agent to read local files (cp ~/.openclaw/browser/chrome-extension, cat ~/.openclaw/openclaw.json | jq -r '.gateway.auth.token') and to expose a Gateway token to the extension. These actions go beyond mere UI guidance and require access to sensitive local configuration. While these steps are coherent with the skill's function, they constitute sensitive file access that should have been declared and justified in metadata.
Install Mechanism
This is an instruction-only skill with no install spec and no code files. That minimizes supply-chain risk because nothing is downloaded or written by the skill itself beyond the manual copy step the user performs.
Credentials
The instructions require the Gateway token stored in ~/.openclaw/openclaw.json and access to the OpenClaw extension directory. Yet requires.env, primary credential, and required config paths are empty in the registry metadata. Requesting or reading the gateway token is a sensitive operation and should be explicitly declared; its absence is disproportionate and reduces transparency.
Persistence & Privilege
The skill is not always-enabled and does not request persistent privileges. Autonomous invocation is allowed (platform default) but is not combined with any other elevated or undeclared access in the metadata.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chrome-attach - After installation, invoke the skill by name or use
/chrome-attach - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of chrome-attach.
- Enables control of existing Chrome tabs via Session Attach, without logging in through OpenClaw-managed browser.
- Supports installation and configuration of Chrome extension for user browser.
- Provides commands for navigation, interaction (click, type), snapshots, screenshots, tab listing and management.
- Users can easily attach/detach tabs for session control.
- Includes troubleshooting tips for connection issues.
Metadata
Frequently Asked Questions
What is Chrome Session Attach?
使用 Chrome Session Attach 功能控制用户的浏览器标签页。包括安装 Chrome 扩展、配置连接、Attach/Detach 标签页、截图、导航、填表等操作。 It is an AI Agent Skill for Claude Code / OpenClaw, with 329 downloads so far.
How do I install Chrome Session Attach?
Run "/install chrome-attach" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Chrome Session Attach free?
Yes, Chrome Session Attach is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Chrome Session Attach support?
Chrome Session Attach is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Chrome Session Attach?
It is built and maintained by meowlegemy-sudo (@meowlegemy-sudo); the current version is v1.0.0.
More Skills