OpenClawDocs
Nesta página

Nesta página

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?