OpenClaw Chrome Relay Helper - Mac
Attach the OpenClaw Browser Relay Chrome extension to a live tab so the browser tool (profile="chrome") works. Use this skill before any browser automation that requires Chrome extension relay access on macOS. Handles kill/launch/maximize/attach and verifies state via Peekaboo accessibility — no hardcoded coordinates, works at any screen size.
Why use this skill?
Automate attaching the OpenClaw Browser Relay extension to Chrome on macOS. A reliable, accessibility-based helper for seamless browser automation and web scraping tasks.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/i-am-rad/chrome-extension-relay-helper-macWhat This Skill Does
The OpenClaw Chrome Relay Helper for Mac automates the critical bridge between your local Chrome browser and the OpenClaw agent. On macOS, Chrome does not expose a remote debugging port for agents by default without user interaction. This skill automates the process of identifying, launching, and attaching the 'OpenClaw Browser Relay' extension to an active Chrome session. It utilizes Peekaboo to interface with the macOS accessibility tree, allowing it to programmatically find the extension icon in the toolbar, verify its state, and trigger the attachment process without needing brittle pixel-based coordinates. It ensures your browser is maximized, the relay is activated, and your Chrome instance is ready for complex web-based automation tasks.
Installation
First, install the Peekaboo CLI via Homebrew: brew install steipete/tap/peekaboo. Ensure your node binary is granted Accessibility permissions in System Settings under Privacy & Security. Next, add the required Chrome profile to your ~/.openclaw/openclaw.json configuration file, specifying the cdpUrl and driver settings. Finally, load the OpenClaw Browser Relay extension manually in Chrome via chrome://extensions in developer mode, ensuring you pin the icon to your toolbar for the script to detect it.
Use Cases
This skill is essential for any task involving real-time web interaction. Use it when you need to perform high-fidelity web scraping, authenticated session management, or automated testing that requires a persistent browser state. It is the perfect precursor to complex research tasks, automated form filling, or cross-platform web data extraction where a clean, relay-enabled session is required.
Example Prompts
- "OpenClaw, please run the relay helper script and then navigate to the company dashboard to extract the latest analytics report."
- "I need to automate a series of form submissions; run the Chrome relay helper and let me know once it is attached so we can begin."
- "Prepare my browser session for web navigation by attaching the OpenClaw relay, then summarize the content on the current tab."
Tips & Limitations
Note that this skill is strictly for macOS environments. Always ensure the extension is pinned to the toolbar; if it is hidden in the extensions menu, Peekaboo will not be able to interact with it. The process is designed to be resilient, retrying the attachment up to 8 times every 2 seconds, accounting for slow startup times. If the process fails, always inspect the debug screenshot provided in ~/.openclaw/media/ to diagnose potential UI obstructions.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-i-am-rad-chrome-extension-relay-helper-mac": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, code-execution