Resposta rápida
Como adiciono uma API de busca na web com conteúdo de página ao OpenClaw?
Salve o servidor MCP LLMWebSearch da nossa página de MCP, registre-o com openclaw mcp add llmwebsearch --command … --arg … --env LLMWEBSEARCH_API_KEY=… e depois verifique com openclaw mcp doctor --probe. O agente ganha o search_web, cujos resultados incluem as 3 principais páginas em Markdown, ao lado do web_search integrado do OpenClaw. Uma pesquisa custa 1 crédito, a partir de US$ 1,20/1K pesquisas em outubro de 2026. Sem KYC.
Busca no OpenClaw, conforme documentado em 22 de outubro de 2026
| Provedores web_search integrados | 16, incluindo Brave Search, DeepSeek, DuckDuckGo, Exa, Firecrawl, Gemini, Parallel, Perplexity, SearXNG e Tavily |
|---|---|
| Escolha automática | O primeiro provedor com API pronto, em uma ordem fixa que começa com o Brave |
| Provedores sem chave | Nunca escolhidos automaticamente; você mesmo os seleciona |
| Nossas ferramentas (MCP) | search_web e read_urls, a partir de um servidor Python local |
| Nosso custo | Um crédito paga uma pesquisa: até 20 resultados classificados, com as páginas dos 3 primeiros lidas e devolvidas em Markdown. Ler de 4 a 10 páginas custa 2 créditos. Uma chamada que termina em erro não custa nada |
| Nosso leitor de páginas | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/), robots.txt respeitado |
Por que adicionar nossa pesquisa se o OpenClaw tem web_search?
Para obter o texto da página junto com os resultados em uma só chamada. A página de ferramentas web do OpenClaw lista 16 provedores integrados para web_search, escolhidos em uma ordem fixa de detecção automática quando nenhum está definido. Nossa ferramenta não substitui essa escolha; ela adiciona uma segunda opção que o modelo pode chamar de propósito.
search_web retorna fontes numeradas com as primeiras páginas já lidas em Markdown, para que o agente possa responder e citar sem uma busca separada para cada link. read_urls lê até 20 links que o agente encontrou em outro lugar, pelo mesmo leitor.
Como registro o servidor MCP?
Primeiro configure o servidor Python da página de MCP: um arquivo, mais os pacotes mcp e httpx em um ambiente virtual. Depois salve-o no OpenClaw com openclaw mcp add. A documentação do registro do OpenClaw descreve as flags stdio --command, --arg, --env e --cwd, e pede que o Gateway local seja parado enquanto os servidores salvos mudam.
Execute openclaw mcp doctor --probe em seguida. Sem --probe o doctor só verifica as configurações salvas; com ele, também comprova que o servidor se conecta.
openclaw mcp add llmwebsearch \
--command /home/you/llmwebsearch/.venv/bin/python \
--arg /home/you/llmwebsearch/llmwebsearch_mcp.py \
--env LLMWEBSEARCH_API_KEY=your-key
openclaw mcp doctor llmwebsearch --probeO agente vai ver o search_web?
Nos perfis habituais, sim. A documentação do registro do OpenClaw diz que as ferramentas MCP configuradas aparecem nos perfis de ferramentas coding e messaging. O perfil minimal as oculta, e tools.deny: ["bundle-mcp"] as desativa, então verifique essas duas configurações se a ferramenta estiver faltando.
A docstring da ferramenta informa ao modelo o que ela retorna. Adicione uma linha às instruções do seu agente se quiser que ela seja preferida, por exemplo "use search_web quando precisar citar uma página".
O LLMWebSearch pode ser selecionado como provedor de web_search?
Hoje não. A documentação do OpenClaw diz que a configuração de provedor aceita os provedores declarados pelos manifests de plugins incluídos e instalados. Não publicamos nenhum plugin do OpenClaw, então nossa pesquisa chega como ferramentas MCP com nomes próprios.
Na prática, isso muda pouco para o agente: ele chama search_web da mesma forma que chamaria web_search. Também mantém os dois fáceis de distinguir nos logs do OpenClaw e no seu histórico de uso.
Como o nosso leitor trata os sites nos resultados?
Como faz em toda chamada. Nosso leitor respeita o robots.txt: ele se identifica como LLMWebSearch, segue as regras que um site escreve para ele ou para todos os robôs e deixa de fora o conteúdo de qualquer página que não tem permissão para ler. Um site que define Content-Signal: ai-input=no no seu robots.txt mantém as suas páginas fora do conteúdo dos seus resultados. Quando um site recusa o nosso leitor, o resultado volta sem conteúdo e com o status do site: nunca resolvemos CAPTCHAs, não entramos em contas nem contornamos um bloqueio ou um paywall.
Uma página atrás de login, portanto, volta sem conteúdo. Para um site em que você está conectado, a ferramenta de navegador do próprio OpenClaw, rodando com a sua sessão, é a escolha certa.
Quanto vai custar pesquisar pelo OpenClaw?
Um crédito por chamada search_web que lê até 3 páginas, nada para chamadas que falham. Ler páginas cujas URLs você já tem custa 1 crédito por cada grupo iniciado de 3 páginas devolvidas com conteúdo, até 20 URLs por chamada; URLs recusadas ou com falha não são contadas. Um assistente que pesquisa 25 vezes por dia em seus canais de chat usa cerca de 750 créditos por mês, então 5.000 pesquisas (US$ 9,25) dura mais de seis meses. Os créditos de pesquisa não têm data de expiração: o que você não usar este mês continua lá no ano que vem.
Dê ao OpenClaw uma chave de API própria, para que o uso dele apareça separado dos seus outros projetos.
OpenClaw: perguntas frequentes
Devo desativar o web_search do próprio OpenClaw?
Não precisa. Os dois podem ficar ativos. Desative o integrado apenas se quiser que toda pesquisa passe por um único provedor, com uma só fatura e um só log.
Funciona com um OpenClaw em sandbox?
O servidor MCP é um processo local que chama https://llmwebsearch.com/api/v1 via HTTPS. Seu sandbox precisa permitir que ele inicie e alcance esse endereço.
Posso gerenciar o servidor pela Control UI?
O OpenClaw guarda os servidores MCP salvos em mcp.servers na configuração dele. A documentação aponta para a Control UI para as configurações MCP ao vivo suportadas e observa que alterar servidores salvos pela linha de comando exige que o Gateway local esteja parado.
Fontes (2)
- Ferramentas web — OpenClaw docs (read 2026-10-22)
- Gerenciar servidores MCP salvos — OpenClaw docs (read 2026-10-22)