OpenClaw

Aprenda a configurar a habilidade OpenClaw da Oxylabs com o AI Studio da Oxylabs.

Oferecemos uma skill para OpenClaw agentes que fornecem busca na web e extração de páginas por meio do Oxylabs AI Studio, incluindo busca com segmentação geográfica, renderização de JavaScript e extração de conteúdo em Markdown.

Requisitos

• python 3 em PATH
• OpenClaw instalado e em execução
• Oxylabs AI Studio chave de API

Instalação

openclaw skills install @oxylabs/oxylabs-web-search

Ele é instalado no skills/ diretório.

Adicione --global para instalar em ~/.openclaw/skills, tornando a skill visível para todos os agentes locais:

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

Verifique a skill antes de ativá-la:

openclaw skills verify @oxylabs/oxylabs-web-search

O comando termina com código diferente de zero quando o ClawHub marca a verificação como falha.

Configuração

A skill lê OXYLABS_AI_STUDIO_API_KEY. Forneça-o de uma destas três maneiras.

Opção 1: configuração do OpenClaw (recomendado)

Adicione uma entrada em ~/.openclaw/openclaw.json:

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

Opção 2: variável de ambiente

export OXYLABS_AI_STUDIO_API_KEY="YOUR_OXYLABS_AI_STUDIO_API_KEY"

Opção 3: .env arquivo

OXYLABS_AI_STUDIO_API_KEY=YOUR_OXYLABS_AI_STUDIO_API_KEY

apiKey também aceita um objeto SecretRef no lugar de uma string em texto simples.

Inicie uma nova sessão do OpenClaw após a instalação e confirme que a skill foi carregada:

openclaw skills check

Uso

search – encontre páginas para uma consulta

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

Resposta:

scrape – obtenha uma página como Markdown

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

Resposta:

Mantenha a skill atualizada com:

openclaw skills update --all

openclaw skills update rastreia apenas instalações do ClawHub. Reinstale Git e as fontes locais para atualizá-las.

Parâmetros de entrada

• query (string): O que pesquisar (obrigatório, posicional)
• url (string): URL de destino para fazer scrape (obrigatório, posicional)
• -n (inteiro): Número máximo de resultados a retornar
• --content (sinalizador): Incluir conteúdo da página nos resultados
• --geo (string): Localização do proxy de busca no formato ISO2
• --render-js (sinalizador): Renderizar JavaScript (padrão: desativado)

Exemplos de uso

Veja a listagem da skill no ClawHub para o conteúdo completo do SKILL.md e a fonte.