OpenClaw

Aprende a configurar la habilidad OpenClaw de Oxylabs con Oxylabs AI Studio.

Ofrecemos una skill para OpenClaw agentes que proporciona búsqueda web y extracción de páginas a través de Oxylabs AI Studio, incluyendo búsqueda geolocalizada, renderizado de JavaScript y extracción de contenido en Markdown.

Requisitos

• python 3 en PATH
• OpenClaw instalado y ejecutándose
• Oxylabs AI Studio clave API

Instalación

openclaw skills install @oxylabs/oxylabs-web-search

Se instala en el directorio skills/ del espacio de trabajo activo.

Añade --global para instalar en ~/.openclaw/skills, haciendo visible la skill para todos los agentes locales:

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

Verifica la skill antes de habilitarla:

openclaw skills verify @oxylabs/oxylabs-web-search

El comando termina con un código distinto de cero cuando ClawHub marca la verificación como fallida.

Configuración

La skill lee OXYLABS_AI_STUDIO_API_KEY. Proporciónalo de una de tres formas.

Opción 1: configuración de OpenClaw (recomendada)

Añade una entrada a ~/.openclaw/openclaw.json:

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

Opción 2: variable de entorno

export OXYLABS_AI_STUDIO_API_KEY="YOUR_OXYLABS_AI_STUDIO_API_KEY"

Opción 3: .env archivo

OXYLABS_AI_STUDIO_API_KEY=YOUR_OXYLABS_AI_STUDIO_API_KEY

apiKey también acepta un objeto SecretRef en lugar de una cadena de texto sin formato.

Inicia una nueva sesión de OpenClaw después de instalar y confirma que la skill se ha cargado:

openclaw skills check

Uso

search – encuentra páginas para una consulta

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

Respuesta:

scrape – obtiene una página como Markdown

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

Respuesta:

Mantén la skill actualizada con:

openclaw skills update --all

openclaw skills update solo rastrea las instalaciones de ClawHub. Reinstala Git y las fuentes locales para actualizarlas.

Parámetros de entrada

• query (cadena): Qué buscar (obligatorio, posicional)
• url (cadena): URL de destino para extraer (obligatorio, posicional)
• -n (entero): Número máximo de resultados a devolver
• --content (bandera): Incluir el contenido de la página en los resultados
• --geo (cadena): Ubicación del proxy de búsqueda en formato ISO2
• --render-js (bandera): Renderizar JavaScript (predeterminado: desactivado)

Ejemplos de uso

Consulta la lista de la skill en ClawHub para el SKILL.md completo y el código fuente.