Scrapling

FOLLOWER SETUP GUIDE

Scrapling + OpenClaw Installation

This handout shows the simplest working setup for macOS and Windows. Use the section for your operating system. If you already have OpenClaw installed, you can skip straight to the Scrapling steps.

Prepared by Sriram Varadharajan

@thesriramvaradharajan

Verified against official docs on March 23, 2026

Before you start

You only need a few things in place before the install will work.

OpenClaw needs Node 22 or newer.

Scrapling needs Python 3.10 or newer. scrapling install is required after installing the Scrapling extras. The Scrapling skill should be installed from your OpenClaw workspace. The default workspace is

~/.openclaw/workspace.

What this guide installs The steps below set up the full working path rather than only the base library.

OpenClaw CLI and first-time onboarding

A dedicated Python virtual environment for Scrapling

scrapling[all] so you get shell features, extraction commands, and fetchers Scrapling browser dependencies

ClawHub and the Scrapling skill

MACOS

Mac install Use these steps on a Mac. They assume you are working in Terminal. If the installer already launched the OpenClaw setup wizard, finish that flow and skip directly to the Python step below.

1

Install OpenClaw

Run the official installer in Terminal.

RUN IN TERMINAL

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

2

Complete the OpenClaw setup

If the setup flow did not open automatically, run onboarding yourself and install the local gateway service.

RUN IN TERMINAL

openclaw onboard --install-daemon
openclaw dashboard

3

Check Python

Scrapling needs Python 3.10 or newer. Check your version first. If it is older, install a newer version with Homebrew.

RUN IN TERMINAL

python3 –version

brew install python

4

Create a clean Scrapling environment

This keeps the Scrapling install isolated so updates stay clean.

RUN IN TERMINAL

python3 -m venv ~/.openclaw/venvs/scrapling

source ~/.openclaw/venvs/scrapling/bin/activate

5

Install Scrapling and its browser dependencies

The base install is not enough for the full feature set. Use the full extras and then run the browser dependency installer.

RUN IN TERMINAL

pip install -U pip
pip install "scrapling[all]"

scrapling install 6

Install ClawHub and add the Scrapling skill

Run these from your OpenClaw workspace. The default workspace is ~/.openclaw/workspace.

RUN IN TERMINAL

npm i -g clawhub
cd ~/.openclaw/workspace

clawhub search "scrapling" clawhub install <skill-slug> 7 Run one quick test Start a fresh OpenClaw session so the new skill loads, then test Scrapling itself with a public page.

RUN IN TERMINAL

scrapling shell -c "get('https://quotes.toscrape.com'); print(len(page.css('.quote')))"

openclaw dashboard

If a Scrapling skill asks for a Python interpreter path, use

~/.openclaw/venvs/scrapling/bin/python.

WINDOWS

Windows install

OpenClaw supports native Windows, but WSL2 is the recommended path for the most stable setup. The steps

below use WSL2 with Ubuntu. Native Windows install exists with iwr -useb https://openclaw.ai/install.ps1 | iex, but WSL2 is still the safer route for the full toolchain. 1

Install WSL2 and Ubuntu

Open PowerShell as Administrator and install WSL. Reboot if Windows asks.

RUN IN POWERSHELL (ADMIN)

wsl –install

# Optional explicit distro:

wsl –install -d Ubuntu-24.04 2

Enable systemd inside WSL

OpenClaw uses systemd for gateway installation inside WSL. Run the first block in Ubuntu, then run the

shutdown command in PowerShell.

RUN IN UBUNTU

sudo tee /etc/wsl.conf >/dev/null <<'EOF'

[boot] systemd=true EOF

THEN RUN IN POWERSHELL

wsl –shutdown

3

Reopen Ubuntu and install the base packages

These packages give you Python, virtual environments, curl, and git before you install OpenClaw.

RUN IN UBUNTU

sudo apt update sudo apt install -y python3 python3-pip python3-venv curl git systemctl –user status 4

Install OpenClaw inside Ubuntu

Run the official installer from your Ubuntu terminal, not from native PowerShell.

RUN IN UBUNTU

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

5

Complete the OpenClaw setup

If the installer did not start onboarding automatically, run it yourself and install the gateway service.

RUN IN UBUNTU

openclaw onboard --install-daemon
openclaw dashboard

6

Create a clean Scrapling environment

Keep the Scrapling install isolated inside WSL so it is easy to update later.

RUN IN UBUNTU

python3 -m venv ~/.openclaw/venvs/scrapling

source ~/.openclaw/venvs/scrapling/bin/activate

7

Install Scrapling and its browser dependencies

Use the full extras, then install the browser dependencies so dynamic and protected sites can work.

RUN IN UBUNTU

pip install -U pip
pip install "scrapling[all]"

scrapling install 8

Install ClawHub and add the Scrapling skill

Install ClawHub, move into the OpenClaw workspace, then add the Scrapling skill by its slug.

RUN IN UBUNTU

npm i -g clawhub
cd ~/.openclaw/workspace

clawhub search "scrapling" clawhub install <skill-slug> 9 Run one quick test Start a fresh OpenClaw session, then confirm that Scrapling can fetch a simple public page.

RUN IN UBUNTU

scrapling shell -c "get('https://quotes.toscrape.com'); print(len(page.css('.quote')))"

openclaw dashboard

If something fails

openclaw is not found

Close the terminal and open a new one. If the command still is not available, rerun the installer.

Python is too old

Install Python 3.10 or newer first, then recreate the virtual environment before installing Scrapling again. scrapling install failed Run it again with scrapling install –force. That reinstalls the browsers and their dependencies.

The skill does not show up in OpenClaw

Make sure you installed it from ~/.openclaw/workspace, then start a fresh OpenClaw session so it reloads the workspace skills.

Prepared by Sriram Varadharajan · @thesriramvaradharajan

Use Scrapling only on websites you are allowed to access and in ways that follow the site’s terms and local law.

OpenClaw install
OpenClaw Windows / WSL2
OpenClaw default workspace

Scrapling GitHub

Scrapling documentation