A specialized environment preparation utility to install headless Chrome and its dependencies on Linux systems without requiring root or sudo privileges.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install browser-setup
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 browser-setup 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 Browser Setup (No-Root Linux)?
This skill enables developers to deploy Openclaw Skills in restricted environments such as cloud containers, sandboxed hosts, or VPS instances where administrative access is unavailable. It automates the complex process of downloading Chrome, extracting over 40 essential shared libraries, and configuring font rendering to ensure stable browser automation.
By bridging the gap between standard Chrome installations and headless server requirements, it provides a reliable foundation for all web-based agent tasks. It specifically addresses the needs of Openclaw Skills when running in environments where standard browser installations are impossible or fail due to missing system-level dependencies.
Browser Setup (No-Root Linux) Use Cases
- Running Openclaw Skills on a fresh VPS or cloud container without sudo access.
- Resolving No supported browser found errors when initializing the browser tool.
- Fixing Page crashed or missing library errors during automated web navigation.
- Setting up a consistent headless browser environment across different sandboxed hosts.
How Browser Setup (No-Root Linux) Works
- The installation script downloads the Google Chrome stable package and extracts it to a local directory using dpkg-deb.
- It identifies missing shared library packages needed by Chrome on Linux and downloads them via apt-get download.
- All .so library files and Liberation fonts are extracted to local directories without requiring system-level installation.
- A custom wrapper script is created to automatically set environment variables like LD_LIBRARY_PATH and FONTCONFIG_FILE.
- Openclaw Skills are configured to use the wrapper script and attach to the running Chrome instance via the Chrome DevTools Protocol (CDP).
Browser Setup (No-Root Linux) Setup
First, execute the installation script to fetch Chrome and its dependencies:
bash scripts/install-browser.sh
Next, configure the settings for Openclaw Skills to recognize the local installation:
openclaw config set browser.executablePath "$HOME/local-libs/chrome-wrapper.sh"
openclaw config set browser.headless true
openclaw config set browser.noSandbox true
openclaw config set browser.attachOnly true
Ensure that you manually start the browser with the remote debugging port enabled before running agent workflows.
Browser Setup (No-Root Linux) Data Schema & Taxonomy
The skill organizes its dependencies and configuration in the user's home directory to avoid permission issues:
| Path | Description |
|---|---|
~/chrome-install/ |
Contains the extracted Chrome binary and assets |
~/local-libs/lib/ |
Shared libraries (.so files) required for Chrome execution |
~/local-libs/chrome-wrapper.sh |
The entry point script that configures the environment and starts Chrome |
~/.fonts/ |
Liberation fonts to prevent renderer crashes in headless mode |
~/data/browser/openclaw/ |
Persistent user data directory for the browser profile |
Browser Setup (No-Root Linux) Advanced Features
- Automated dependency resolution using ldd to identify missing system libraries dynamically.
- Custom fontconfig generation to handle text rendering in headless modes without system fonts.
- Optimized memory management using the --disable-dev-shm-usage flag to prevent crashes in small container environments.
- Direct CDP attachment mode (attachOnly: true) to prevent port conflicts when Openclaw Skills interface with Playwright.
- Support for custom CDP ports to allow multiple isolated browser instances on the same host.
SKILL.md
Loading
Related Openclaw Skills
BTCETH DualWin Engine
An expert decision-support system for BTC and ETH dual-currency financial products leveraging real-time volatility surfaces and technical indicators.
Writing Assistant
A sophisticated three-layer AI writing agent designed for professional content generation, rewriting, and strategic ideation.
Web Quality Audit
A comprehensive web audit tool for performance, accessibility, SEO, and security validation powered by PinchTab browser automation.
TDD & De-Sloppify Agent Skill
A sophisticated TDD workflow for AI agents featuring a unique de-sloppify pattern to ensure clean, behavior-driven code.
Code Snippet Manager
A specialized developer tool for capturing, tagging, and instantly retrieving reusable code fragments to accelerate the development lifecycle.
Currency Converter ZH
A real-time currency exchange and conversion tool optimized for Chinese language users and financial workflows.
Featured*
