> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/pt-br/ai-studio-integrations/openclaw.md).

# OpenClaw

Oferecemos uma skill para [OpenClaw](https://docs.openclaw.ai/) agentes que fornecem busca na web e extração de páginas por meio do [Oxylabs AI Studio](https://aistudio.oxylabs.io/), 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](https://github.com/openclaw/openclaw) instalado e em execução
* Oxylabs AI Studio [chave de API](https://aistudio.oxylabs.io/api-key)

## Instalação

```shellscript
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:

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

Verifique a skill antes de ativá-la:

```shellscript
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`:

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

#### Opção 2: variável de ambiente

```shellscript
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:

```shellscript
openclaw skills check
```

## Uso

### `search` – encontre páginas para uma consulta

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

**Resposta:**

<img src="/files/f471ba62dedc03c0877715937373fea17fc93e76" alt="" height="332" width="624">

### `scrape` – obtenha uma página como Markdown

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

**Resposta:**

<img src="/files/45896e6db2c03d33210f2ee1a7d61159d660cbf0" alt="" height="348" width="624">

Mantenha a skill atualizada com:

```shellscript
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](https://clawhub.ai/oxylabs/skills/oxylabs-web-search) para o conteúdo completo do `SKILL.md` e a fonte.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/integrations/pt-br/ai-studio-integrations/openclaw.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.