OpenClaw

Learn how to set up Oxylabs OpenClaw skill with Oxylabs AI Studio.

We offer a skill for OpenClaw agents that provides web search and page extraction through Oxylabs AI Studio, including geo-targeted search, JavaScript rendering, and Markdown content extraction.

Requirements

• python 3 on PATH
• OpenClaw installed and running
• Oxylabs AI Studio API key

Installation

openclaw skills install @oxylabs/oxylabs-web-search

It gets installed into the active workspace's skills/ directory.

Add --global to install into ~/.openclaw/skills, making the skill visible to all local agents:

openclaw skills install @oxylabs/oxylabs-web-search --global

Verify the skill before enabling:

openclaw skills verify @oxylabs/oxylabs-web-search

The command exits non-zero when ClawHub marks verification as failed.

Configuration

The skill reads OXYLABS_AI_STUDIO_API_KEY. Provide it in one of three ways.

Option 1: OpenClaw config (recommended)

Add an entry to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "oxylabs-web-search": {
        "enabled": true,
        "apiKey": "YOUR_OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

Option 2: Environment variable

export OXYLABS_AI_STUDIO_API_KEY="YOUR_OXYLABS_AI_STUDIO_API_KEY"

Option 3: .env file

OXYLABS_AI_STUDIO_API_KEY=YOUR_OXYLABS_AI_STUDIO_API_KEY

apiKey also accepts a SecretRef object in place of a plaintext string.

Start a new OpenClaw session after installing and confirm the skill is loaded:

openclaw skills check

Usage

search – find pages for a query

python3 scripts/oxylabs.py search "best pancake recipe" -n 5

Response:

scrape – get one page as Markdown

python3 scripts/oxylabs.py scrape "https://sandbox.oxylabs.io/products/1"

Response:

Keep the skill updated with:

openclaw skills update --all

openclaw skills update tracks ClawHub installs only. Reinstall Git and local sources to refresh them.

Input parameters

• query (str): What to search for (required, positional)
• url (str): Target URL to scrape (required, positional)
• -n (int): Maximum number of results to return
• --content (flag): Include page content in results
• --geo (str): Search proxy location in ISO2 format
• --render-js (flag): Render JavaScript (default: off)

Usage examples

See the skill listing on ClawHub for the full SKILL.md and source.