OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Pesquisa do Brave

OpenClaw oferece suporte à API Brave Search como provedor de web_search.

Obter uma chave de API

  1. Crie uma conta da API Brave Search em https://brave.com/search/api/
  2. No painel, escolha o plano Search e gere uma chave de API.
  3. Armazene a chave na configuração ou defina BRAVE_API_KEY no ambiente do Gateway.

Exemplo de configuração

json5
{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // ou "llm-context"            baseUrl: "https://api.search.brave.com", // substituição opcional da URL base/do proxy          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

As configurações de pesquisa específicas do provedor Brave ficam em plugins.entries.brave.config.webSearch.*; esse é o caminho de configuração canônico. Um tools.web.search.apiKey compartilhado no nível superior e um tools.web.search.brave.* com escopo ainda são carregados por meio de uma mesclagem de compatibilidade, mas novas configurações devem usar o caminho com escopo do plugin mostrado acima.

webSearch.mode controla o transporte do Brave:

  • web (padrão): pesquisa normal na web do Brave, com títulos, URLs e trechos
  • llm-context: API Brave LLM Context, com blocos de texto pré-extraídos e fontes para fundamentação

webSearch.baseUrl pode direcionar as solicitações do Brave a um proxy ou gateway confiável e compatível com o Brave. O OpenClaw acrescenta /res/v1/web/search ou /res/v1/llm/context à URL base configurada e mantém a URL base na chave de cache. Endpoints públicos devem usar https://; http:// é aceito somente para hosts de proxy confiáveis em local loopback ou em rede privada.

Parâmetros da ferramenta

querystringrequired

Consulta de pesquisa.

countnumberdefault: 5

Número de resultados a retornar (1–10).

countrystring

Código de país ISO de 2 letras (por exemplo, US, DE).

languagestring

Código de idioma ISO 639-1 para os resultados da pesquisa (por exemplo, en, de, fr).

search_langstring

Código de idioma de pesquisa do Brave (por exemplo, en, en-gb, zh-hans).

ui_langstring

Código de idioma ISO para elementos da interface.

freshness'day' | 'week' | 'month' | 'year'

Filtro de tempo — day corresponde a 24 horas.

date_afterstring

Somente resultados publicados após esta data (YYYY-MM-DD).

date_beforestring

Somente resultados publicados antes desta data (YYYY-MM-DD).

Exemplos:

javascript
// Pesquisa específica por país e idiomaawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Resultados recentes (última semana)await web_search({  query: "AI news",  freshness: "week",}); // Pesquisa por intervalo de datasawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

Observações

  • O OpenClaw usa o plano Search do Brave. Se você tiver uma assinatura legada (por exemplo, o plano Free original com 2.000 consultas/mês), ela continuará válida, mas não incluirá recursos mais recentes, como LLM Context ou limites de taxa mais altos.
  • Cada plano do Brave inclui $5/mês em créditos gratuitos (renovados mensalmente). O plano Search custa $5 por 1.000 solicitações, portanto o crédito cobre 1.000 consultas/mês. Defina seu limite de uso no painel do Brave para evitar cobranças inesperadas. Consulte o portal da API do Brave para ver os planos atuais.
  • O plano Search inclui o endpoint LLM Context e direitos de inferência de IA. O armazenamento de resultados para treinar ou ajustar modelos requer um plano com direitos explícitos de armazenamento. Consulte os Termos de Serviço do Brave.
  • O modo llm-context retorna entradas de fontes fundamentadas em vez do formato normal de trechos da pesquisa na web.
  • O modo llm-context aceita freshness e intervalos limitados de date_after + date_before. Ele não aceita ui_lang; date_before sem date_after é rejeitado porque o Brave exige que intervalos de atualidade personalizados incluam as datas inicial e final.
  • ui_lang deve incluir uma subtag de região, como en-US.
  • Por padrão, os resultados permanecem em cache por 15 minutos (configurável por meio de cacheTtlMinutes).
  • Valores personalizados de webSearch.baseUrl são incluídos na identidade do cache do Brave, para que respostas específicas do proxy não entrem em conflito.
  • Ative a opção de diagnóstico brave.http para registrar URLs/parâmetros de consulta das solicitações do Brave, status/tempo das respostas e eventos de acerto/erro/gravação do cache de pesquisa durante a solução de problemas. A opção nunca registra a chave de API nem os corpos das respostas, mas as consultas de pesquisa podem conter dados sensíveis.

Conteúdo relacionado

Was this useful?
On this page

On this page