A specialized macOS tool to reliably attach the OpenClaw Browser Relay extension to Chrome for seamless browser automation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install chrome-extension-relay-helper-mac
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install chrome-extension-relay-helper-mac using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenClaw Chrome Relay Helper - Mac?
The OpenClaw Chrome Relay Helper - Mac is a robust utility designed to bridge the gap between AI agents and real Chrome sessions on macOS. By leveraging the Peekaboo CLI to interact with Chrome's accessibility tree, this skill ensures that the OpenClaw Browser Relay is correctly attached to a live tab without relying on fragile pixel coordinates or unreliable vision models. It serves as a foundational component for developers using Openclaw Skills to perform navigation, scraping, and UI interaction within a standard Chrome profile, providing a stable bridge for the browser toolset.
OpenClaw Chrome Relay Helper - Mac Use Cases
- Preparing a real Chrome session for automated web scraping and data extraction.
- Initializing a browser environment for AI-driven end-to-end testing.
- Attaching the relay extension to bypass 'Restore Pages' dialogs and ensure a clean automation state.
- Integrating browser relay capabilities into larger Openclaw Skills workflows for complex web tasks.
How OpenClaw Chrome Relay Helper - Mac Works
- Performs a fast-path check to see if the extension is already attached to save execution time.
- Force-closes existing Chrome instances to ensure a clean, predictable state.
- Patches Chrome preferences to suppress intrusive 'Restore Pages' dialogs on relaunch.
- Launches Chrome to a lightweight URL (info.cern.ch) to minimize load times and avoid anti-bot triggers.
- Maximizes the window via Peekaboo to ensure toolbar icons are visible in the accessibility tree.
- Scans the macOS accessibility tree to find the extension icon by its specific description.
- Programmatically clicks the icon to attach the relay.
- Verifies the 'attached' state before returning success to the agent.
OpenClaw Chrome Relay Helper - Mac Setup
First, install the Peekaboo CLI via Homebrew:
brew install steipete/tap/peekaboo
You must grant Accessibility permissions to your node binary in System Settings -> Privacy & Security -> Accessibility. Find your node path with which node.
Then, add the browser profile to your ~/.openclaw/openclaw.json:
"browser": {
"profiles": {
"chrome": {
"cdpUrl": "http://127.0.0.1:18792",
"driver": "extension",
"color": "#FF5A36"
}
}
}
Finally, ensure the OpenClaw Browser Relay extension is loaded as an unpacked extension and pinned to your Chrome toolbar.
OpenClaw Chrome Relay Helper - Mac Data Schema & Taxonomy
The skill interacts with the local file system and Chrome configuration to manage state:
| Component | Purpose |
|---|---|
| Chrome Preferences | Modifies ~/Library/Application Support/Google/Chrome/Default/Preferences to suppress dialogs. |
| Debug Media | Saves a screenshot to ~/.openclaw/media/relay-attach-fail.png if the attachment process fails. |
| Status Indicators | Returns ALREADY_ATTACHED, ATTACHED, or FAILED for integration logic. |
OpenClaw Chrome Relay Helper - Mac Advanced Features
- Intelligent retry logic (8 attempts every 2 seconds) to handle slow system or browser startups.
- Accessibility-based element detection that functions correctly at any screen resolution.
- Automated preference patching to eliminate the need for manual UI dialog dismissal.
- Designed as a plug-and-play helper for any other Openclaw Skills that require live browser interaction.
SKILL.md
Loading
Related Openclaw Skills
aelf Skills Hub
A meta-skill hub for discovering, installing, and routing all AI agent capabilities within the aelf blockchain ecosystem.
News Digest
An intelligent, multi-slot news aggregation system that delivers personalized, AI-summarized briefings based on your specific interests and schedule.
Polymarket AutoTrader
An automated trading bot for Polymarket that uses technical analysis to trade crypto price prediction markets.
MQTT Agent Messenger
A lightweight MQTT-based messaging layer for AI agents to broadcast their identities and real-time status updates across a network.
Edge-TTS Skill
A high-quality neural text-to-speech engine leveraging Microsoft Edge's service to provide realistic voice synthesis without an API key.
OpenFishy Feed Publisher
A powerful automation tool for generating high-quality AI visual media and publishing it directly to the OpenFishy feed platform.
Featured*
