How to Integrate OpenClaw with Oxylabs AI Studio

Project requirements

Make sure you have the following before starting:

• OpenClaw installed and running (installation guide)

• An Oxylabs AI Studio API key – get one here

• Python (download here) – this guide uses Python 3

1. Install the skill

Install directly from ClawHub, OpenClaw's public skill registry:

openclaw skills install @oxylabs/oxylabs-web-search

This installs into your active workspace's skills/ directory. If you run several agents on the same machine and want all of them to have web access, install it globally instead:

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

That places the skill in ~/.openclaw/skills, where every local agent can see it unless an agent allowlist narrows the set.

Before you enable a third-party skill, it's good practice to check its trust envelope:

openclaw skills verify @oxylabs/oxylabs-web-search

The command exits non-zero if ClawHub has flagged the skill. The Oxylabs skill currently passes ClawHub's security audit, and you can review the scan details – VirusTotal, ClawScan, and static analysis – on its registry page before installing.

2. Set up your API key

The skill reads a single credential: OXYLABS_AI_STUDIO_API_KEY. There are three ways to supply it.

Option A – OpenClaw config (recommended)

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

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

This is the recommended path because OpenClaw injects the key into the process environment only for the duration of an agent turn, then restores the original environment. The secret never lands in a prompt or a shell history file.

If you'd rather not put a plaintext key in your config, apiKey also accepts a SecretRef object pointing at a vault or environment source.

Option B – Environment variable

export OXYLABS_AI_STUDIO_API_KEY="YOUR_OXYLABS_AI_STUDIO_API_KEY"

Option C – .env file

OXYLABS_AI_STUDIO_API_KEY=YOUR_OXYLABS_AI_STUDIO_API_KEY

Start a new OpenClaw session after installing. OpenClaw snapshots its eligible skill list when a session starts and reuses it for every turn in that session. Your freshly installed skill won't appear until you open a new one.

Confirm the agent can see it:

openclaw skills check

3. Using the Oxylabs skill in OpenClaw

The skill is one Python script with two subcommands. Everything else is flags.

3.1 search – find pages for a query

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

Sample output:

4. Building a research workflow

Let’s run a prompt:

Every weekday at 8am, search for news about our three top coffeeshops in LA, scrape the top items in their menu from the last 24 hours, and message me a digest. Skip days with nothing new.

That's a monitoring pipeline in three lines of prompt, and it shows the agent setting up its automatic schedule: