Residential Proxy Configuration for Openclaw

A configuration skill for using residential proxies to bypass advanced bot detection systems during web scraping and browser automation.

luis2404123
v1.0.0
Mar 3, 2026
0
165
1

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install residential-proxy

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 residential-proxy 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 Residential Proxy Configuration?

This skill provides the configuration necessary to route web requests through real household IP addresses assigned by Internet Service Providers. Unlike standard datacenter proxies, residential IPs have clean reputations and pass ASN-based bot detection used by security providers like Cloudflare, DataDome, and Akamai. Integrating these proxies within Openclaw Skills allows developers to successfully scrape protected sites and automate browser tasks by appearing as a genuine household user.

By leveraging a vast pool of millions of household connections, the skill ensures that automated agents can operate globally with high success rates. Whether you are performing localized market research or complex data extraction, this setup provides the trust required to bypass modern security perimeters without being flagged as a bot.

Residential Proxy Configuration Use Cases

  • Scraping websites protected by Cloudflare, DataDome, or PerimeterX anti-bot systems.
  • Automating browser tasks that require high IP reputation to avoid captchas.
  • Accessing geo-restricted content by targeting specific country IPs across 195+ locations.
  • Maintaining persistent sessions for account-based scraping and multi-page login flows.

How Residential Proxy Configuration Works

  1. The skill identifies the need for residential IP routing based on the target website's security profile or user request.
  2. It configures the proxy gateway and credentials, incorporating specific tags for IP rotation or geographic targeting.
  3. Outgoing requests are routed through the BirdProxies gateway to a real residential connection from a consumer ISP.
  4. The target website sees a valid household IP, allowing the request to pass through security filters successfully.

Residential Proxy Configuration Setup

Environment Configuration

To use this with your CLI tools or scripts, set the following environment variables:

HTTP_PROXY=http://USER:[email protected]:7777
HTTPS_PROXY=http://USER:[email protected]:7777
NO_PROXY=127.0.0.1,localhost

Browser Automation Setup

For browser-based tools, apply the following proxy configuration:

{
  "browser": {
    "proxy": {
      "server": "http://gate.birdproxies.com:7777",
      "username": "USER",
      "password": "PASS"
    }
  }
}

Residential Proxy Configuration Data Schema & Taxonomy

The skill manages proxy routing metadata to ensure traffic is handled correctly across different regions and session types. It uses a specific username syntax to control behavior within Openclaw Skills.

Parameter Description Example Syntax
Gateway The entry point for the proxy pool gate.birdproxies.com:7777
Session ID Unique identifier for sticky sessions USER-session-abc123
Country Code ISO 3166-1 alpha-2 code for targeting USER-country-us
Combined Targeting a country with a sticky session USER-country-us-session-abc123

Residential Proxy Configuration Advanced Features

  • Granular country targeting for over 195 countries using ISO alpha-2 codes.
  • Sticky session support for maintaining the same IP address for up to 30 minutes.
  • Automatic IP rotation per request for maximum anonymity during high-volume scraping.
  • High-reputation ASN filtering to pass strict bot detection checks from major security providers.
  • Native compatibility with Python requests and Node.js fetch libraries.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*