Resposta rápida
Como adiciono uma API de leitura de páginas web ao OpenClaw?
Salve o servidor MCP WebReaderAPI, depois registre-o com openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=… e verifique com openclaw mcp doctor --probe. O agente ganha uma ferramenta read_url ao lado do web_fetch nativo, capaz de renderizar JavaScript e ler PDFs. As páginas custam 1 crédito, a partir de US$ 0,07/1K páginas em outubro de 2026. Sem KYC; pague com cripto.
web_fetch e read_url do OpenClaw lado a lado
| web_fetch (nativo) | Roda localmente, extrai o conteúdo principal com Readability, retorna Markdown ou texto |
|---|---|
| limites do web_fetch | Sem execução de JavaScript; maxChars padrão e limite de 20.000 caracteres (docs do OpenClaw) |
| read_url (nossa ferramenta MCP) | Renderização de JavaScript quando necessário, PDFs de até 100 páginas, até 500.000 caracteres |
| custo do read_url | 1 crédito = 1 página lida sem navegador; 2 créditos quando a página precisa de um navegador para renderizar JavaScript. Uma requisição que falha, ou que o robots.txt de um site recusa, não é cobrada |
| Nosso rastreador (crawler) | WebReaderAPI/1.0 (+https://webreaderapi.com/bot/), robots.txt respeitado |
| Perfis de ferramentas | As ferramentas MCP aparecem nos perfis coding e messaging, não em minimal |
Por que adicionar um leitor se o OpenClaw tem web_fetch?
Porque eles cobrem páginas diferentes. A documentação do OpenClaw diz que web_fetch sempre roda localmente, usa Readability para extrair o conteúdo principal e não executa JavaScript; ela indica a ferramenta Web Browser para sites com muito JavaScript ou protegidos por login. A configuração maxChars tem padrão de 20.000 caracteres e é limitada a isso.
Mantenha web_fetch para páginas rápidas e leves. Adicione read_url para páginas que montam o conteúdo com JavaScript, para PDFs e para documentos longos em que você quer mais de 20.000 caracteres. A documentação do OpenClaw também observa que o plugin oficial do Firecrawl é hoje o único provedor incluído para o qual web_fetch pode recorrer.
Como registro o servidor MCP no OpenClaw?
Primeiro configure o servidor Python a partir da página MCP: um arquivo mais os pacotes mcp e httpx. 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 armazena as definições salvas em mcp.servers na configuração.
Execute openclaw mcp doctor --probe depois. Sem --probe, o doctor só verifica a configuração salva; com ele, também confirma que os servidores habilitados se conectam.
openclaw mcp add webreaderapi \
--command /home/you/webreader/.venv/bin/python \
--arg /home/you/webreader/webreader_mcp.py \
--env WEBREADER_API_KEY=your-key
openclaw mcp doctor webreaderapi --probeO agente vai ver read_url?
Nos perfis usuais, sim. A documentação do registro do OpenClaw diz que o OpenClaw embutido expõe as ferramentas MCP configuradas nos perfis 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 não aparecer.
A descrição da ferramenta diz ao modelo quando preferi-la: páginas que precisam de JavaScript, PDFs e leituras longas. O modelo ainda pode usar web_fetch para todo o resto.
Como o read_url trata os sites que lê?
Da mesma forma que toda chamada à nossa API. Respeitamos o robots.txt: nosso crawler se identifica como WebReaderAPI, segue as regras escritas para ele ou para todos os robôs e não lê uma página que o site proíbe. Páginas recusadas não são cobradas. Se um site declara Content-Signal: ai-input=no no seu robots.txt, não lemos as páginas dele para você. Se um site recusa nossa requisição, devolvemos a resposta dele: nunca resolvemos CAPTCHAs, nunca entramos em contas e nunca tentamos contornar um bloqueio ou um paywall.
Páginas atrás de login ficam, portanto, fora do escopo do read_url. Para um site em que você está conectado, a própria ferramenta de navegador do OpenClaw, rodando com sua sessão, é a ferramenta certa.
Quanto vai custar ler páginas pelo OpenClaw?
Um crédito por página que volta com conteúdo, dois quando é preciso um navegador, nada para recusas e erros. Um assistente que lê 30 páginas por dia nos seus canais de chat usa cerca de 900 créditos por mês: 10.000 páginas (US$ 3,75) dura quase um ano. Os créditos pré-pagos nunca expiram: as páginas não usadas ficam na sua conta até você usá-las.
Dê ao OpenClaw uma chave de API própria, para que o uso dele apareça separado dos seus outros projetos.
OpenClaw: perguntas frequentes
O WebReaderAPI é um provedor nativo do OpenClaw?
Não. Ele se conecta como servidor MCP, que o OpenClaw suporta sem nenhum código de plugin. O servidor MCP é o arquivo Python curto da nossa página MCP.
Devo desativar o web_fetch?
Não precisa. As duas ferramentas podem ficar ativas; as descrições dizem ao modelo qual delas serve. Desative web_fetch só se quiser que toda leitura passe por um único lugar para registro.
Posso gerenciar o servidor pela interface web do OpenClaw?
A documentação do OpenClaw descreve as configurações de MCP na Control UI, que editam as mesmas definições salvas da linha de comando. Use a que preferir.
Funciona em uma instalação do OpenClaw em sandbox?
O servidor MCP é um processo local que precisa de acesso à internet para chegar a https://webreaderapi.com/api/v1/read. Verifique se o seu sandbox permite que o processo inicie e faça essa chamada HTTPS.
Fontes (4)
- Ferramentas web — OpenClaw docs (read 2026-10-22)
- Web Fetch — OpenClaw docs (read 2026-10-22)
- Gerenciar servidores MCP salvos — OpenClaw docs (read 2026-10-22)
- MCP na Control UI — OpenClaw docs (read 2026-10-22)