A stateless CLI client that allows AI agents to control real, authenticated remote browsers through simple execution commands.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install claw-relay-browser
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 claw-relay-browser 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 Claw Relay CLI Client?
Claw Relay is a specialized interface designed for AI agents that interact with the web through direct command execution. Unlike traditional browser automation that relies on headless environments, this skill allows Openclaw Skills to leverage a user's real browser session. This means the agent can access sites where the user is already logged in, bypassing complex authentication hurdles by using existing cookies and active sessions.
The tool is built to be lightweight and stateless. Instead of maintaining a heavy, persistent connection, the agent makes individual calls to a Node.js script to perform specific tasks. This architecture makes it highly compatible with Openclaw Skills that prioritize reliability and simplicity in remote browser orchestration.
Claw Relay CLI Client Use Cases
- Interacting with authenticated dashboards and internal tools where session persistence is required.
- Navigating complex web workflows that trigger bot detection on standard headless browsers.
- Extracting page structures using accessibility tree snapshots for precise element targeting.
- Automating form submissions and button clicks on real-world websites.
- Capturing visual evidence of web states via remote screenshots.
How Claw Relay CLI Client Works
- The AI agent triggers a command using the exec tool to run the relay-client.cjs script.
- The client script establishes a brief WebSocket connection to the Claw Relay server using provided credentials.
- A single action, such as navigating to a URL or clicking a specific element reference, is transmitted to the remote browser.
- The remote browser executes the action and returns a JSON response containing the result or page state.
- The script outputs the data to the agent and closes the connection immediately, maintaining a stateless workflow within Openclaw Skills.
Claw Relay CLI Client Setup
To integrate this with your Openclaw Skills, first ensure you have Node.js and the necessary dependencies installed in the script directory.
npm install ws
Configure your environment variables to authenticate with the relay server:
export CLAW_RELAY_URL="wss://relay.clawrelay.dev/"
export CLAW_RELAY_TOKEN="your-token"
export CLAW_RELAY_AGENT="your-agent-id"
You can then execute actions directly:
node relay-client.cjs navigate https://github.com
Claw Relay CLI Client Data Schema & Taxonomy
The skill returns structured JSON data for every action performed. Below is the typical schema for snapshots and interactions:
| Attribute | Description |
|---|---|
ok |
A boolean indicating the success of the CLI command. |
snapshot |
A textual representation of the page's accessibility tree with element references (e.g., e1, e2). |
path |
The file path where a screenshot was saved, if applicable. |
error |
Detailed error messaging if a scope violation or connection issue occurs. |
result |
The return value from JavaScript evaluation actions. |
Claw Relay CLI Client Advanced Features
- Real Browser Context: Operate within genuine user sessions with full cookie support, unlike standard automated drivers.
- Scoped Permissions: Security-first design allowing specific access levels like read, navigate, interact, or execute.
- Element Referencing: Simplifies agent logic by using stable element references from snapshots rather than volatile CSS selectors.
- Audit Logging: Every action taken via Openclaw Skills is logged for security and debugging purposes.
- Domain Filtering: Built-in safety features including allowlists and hardcoded blocklists for sensitive categories like finance.
SKILL.md
Loading
Related Openclaw Skills
Tech Solution Research
A professional technical research skill that orchestrates multi-source evidence for framework selection and technology comparison.
Pixel Asset Pipeline
An AI-driven sprite generation and processing workflow designed to turn text prompts into engine-ready pixel art assets for Godot within the Openclaw Skills ecosystem.
Prospect Researcher
An advanced AI research agent that builds structured B2B prospect profiles, identifies key decision-makers, and generates personalized engagement recommendations.
Pitch Amplifier
A specialized tool that transforms vague reporting clues into structured, data-driven news pitches using knowledge graph context.
Short-Video-AI Pipeline
An automated production pipeline that transforms a single topic or idea into a fully edited 60-90 second vertical video delivered via Telegram.
Vaporwave Art Generator
An AI-powered creative tool for generating retro-aesthetic, synthwave, and vaporwave images using simple text prompts.
Featured*
