Playwright Browser Setup for Openclaw

A streamlined utility for configuring headless Playwright Chromium automation within Clawdbot environments.

maverick-software
v1.0.0
Feb 15, 2026
1
3.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install playwright-headless-browser

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install playwright-headless-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 Playwright Browser Setup?

The Playwright Browser Setup skill is designed to bridge the gap between AI agents and web environments by providing a robust configuration for Chromium. It focuses specifically on solving the common friction points found in WSL and Linux setups, such as missing system libraries and complex binary pathing. By integrating this into your Openclaw Skills library, you ensure that your coding agent has a reliable, headless window into the web for research, testing, and data extraction.

This setup automates the installation of Playwright-managed Chromium and its associated system dependencies like NSS and ALSA. It ultimately patches the Clawdbot configuration to enable stable, headless execution, making it a foundational tool for any developer looking to expand their agent's capabilities into browser-based tasks.

Playwright Browser Setup Use Cases

  • Enabling AI agents to perform headless web scraping and site analysis within WSL environments.
  • Setting up automated UI testing workflows where Clawdbot requires a reliable browser engine.
  • Provisioning Linux-based CI/CD runners with the necessary dependencies for browser automation.
  • Standardizing browser configuration across multiple Openclaw Skills to ensure consistent agent behavior.

How Playwright Browser Setup Works

  1. Executes a script or manual command to download the specific Chromium revision managed by Playwright.
  2. Identifies and installs required Linux system libraries (libnss3, libasound2) via the package manager to prevent execution errors.
  3. Programmatically locates the Chromium binary path within the local user cache directory.
  4. Updates the Clawdbot gateway configuration with the correct executable path and necessary flags like noSandbox and headless.
  5. Performs a verification check by running a headless DOM dump to confirm the browser is fully operational.

Playwright Browser Setup Setup

To quickly install and configure the browser, run the automated setup script included with the Openclaw Skills package:

./scripts/setup.sh

For manual installation, follow these steps:

  1. Install Chromium via Playwright:
npx playwright install chromium
  1. Install system dependencies for Linux:
sudo apt-get install -y libnss3 libasound2t64
  1. Apply the configuration patch to Clawdbot:
clawdbot config patch '{"browser": {"executablePath": "/your/path/to/chrome", "headless": true, "noSandbox": true}}'

Playwright Browser Setup Data Schema & Taxonomy

This skill modifies the core Clawdbot configuration to include browser-specific metadata. The organization is as follows:

Property Type Description
executablePath String The absolute path to the Playwright-managed Chromium binary.
headless Boolean Determines if the browser runs without a GUI (set to true by default).
noSandbox Boolean Required for WSL/Container environments to bypass namespace restrictions.
system_deps List Includes libnss3 and libasound2 for Linux compatibility.

Playwright Browser Setup Advanced Features

  • Automated binary path discovery to handle dynamic versioning in Playwright updates.
  • Seamless WSLg support for switching to headed mode when visual debugging is required.
  • Optimized no-sandbox configuration for high-security containerized environments within Openclaw Skills.
  • One-click configuration patching to minimize manual JSON editing in the Clawdbot gateway.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*