Chrome Relay — 技能工具
v1.0.0[自动翻译] Control the user's local Chrome browser via OpenClaw Browser Relay extension. Use when: (1) User asks to control/access their browser (2) User wants t...
详细分析 ▾
运行时依赖
版本
Initial release of chrome-relay. - Control your local Chrome browser via the OpenClaw Browser Relay extension. - Supports automation: clicking, typing, navigating, taking screenshots, and reading page content from specific tabs. - Interacts with your real, logged-in browser sessions—perfect for actions requiring authentication. - Requires manual setup of the Chrome extension and gateway token. - Prefer JavaScript-based selectors for reliability; aria-ref selectors may not work consistently. - Works only with Chrome and requires the extension to be attached per tab.
安装命令 点击复制
技能文档
Control the user's local Chrome browser through the OpenClaw Browser Relay extension. This provides access to the user's real logged-in browser sessions.
Setup (First Time)
If user doesn't have Browser Relay extension installed:
- Get extension path:
~/.openclaw/browser/chrome-extension
Or run: open ~/.openclaw/browser/chrome-extension (macOS)- Install in Chrome:
chrome://extensions
- Enable "Developer mode" (top right)
- Click "Load unpacked"
- Select the extension folder- Get Gateway token:
openclaw config get gateway.auth.token
- Configure extension:
- Connect:
Usage
Check Connected Tabs
openclaw browser tabs --profile chrome-relay
Or use the tool:
browser(action=tabs, profile=chrome-relay)
Read Page Content
browser(action=snapshot, profile=chrome-relay, targetId=)
Navigate
browser(action=navigate, profile=chrome-relay, targetId=, url="https://...")
Interact with Page
Note: aria-ref based selectors have reliability issues in chrome-relay mode. Prefer JavaScript evaluation for complex interactions:
// Click element
browser(action=act, kind=evaluate, profile=chrome-relay,
fn="document.querySelector('selector').click()")// Type in input
browser(action=act, kind=evaluate, profile=chrome-relay,
fn="document.querySelector('input').value = 'text'")
// Get element info
browser(action=act, kind=evaluate, profile=chrome-relay,
fn="document.querySelector('selector').innerText")
Limitations
- aria-ref selectors may timeout; use JavaScript evaluate instead
- Extension must be attached (icon shows ON) for each tab
- Only works with Chrome browser
- Connection port: 18792
Troubleshooting
Red ! badge on extension:
- Gateway not running → start with
openclaw gateway start - Token mismatch → verify token in extension settings
Can't find element:
- Page may have loaded new DOM → re-snapshot
- Use browser devtools console to find selectors first
免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制