Risposta rapida
Come aggiungo un'API per leggere pagine web a OpenClaw?
Salva il server MCP WebReaderAPI, poi registralo con openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=… e verificalo con openclaw mcp doctor --probe. L'agente ottiene un tool read_url accanto al web_fetch integrato, capace di renderizzare JavaScript e leggere PDF. Le pagine costano 1 credito, a partire da 0,07 USD/1K pagine a ottobre 2026. Senza KYC; paghi in criptovalute.
web_fetch e read_url di OpenClaw a confronto
| web_fetch (integrato) | Gira in locale, estrae il contenuto principale con Readability, restituisce Markdown o testo |
|---|---|
| limiti di web_fetch | Nessuna esecuzione JavaScript; maxChars predefinito e limite di 20.000 caratteri (docs di OpenClaw) |
| read_url (il nostro tool MCP) | Rendering JavaScript quando serve, PDF fino a 100 pagine, fino a 500.000 caratteri |
| costo di read_url | 1 credito = 1 pagina letta senza browser; 2 crediti quando la pagina richiede un browser per eseguire JavaScript. Una richiesta che fallisce, o che il robots.txt di un sito rifiuta, non viene addebitata |
| Il nostro crawler | WebReaderAPI/1.0 (+https://webreaderapi.com/bot/), robots.txt rispettato |
| Profili degli strumenti | Gli strumenti MCP compaiono nei profili coding e messaging, non in minimal |
Perché aggiungere un reader quando OpenClaw ha web_fetch?
Perché coprono pagine diverse. La documentazione di OpenClaw dice che web_fetch gira sempre in locale, usa Readability per estrarre il contenuto principale e non esegue JavaScript; per i siti con molto JavaScript o protetti da login rimanda al suo strumento Web Browser. La sua impostazione maxChars è di 20.000 caratteri per impostazione predefinita ed è limitata a quel valore.
Tieni web_fetch per le pagine veloci e leggere. Aggiungi read_url per le pagine che costruiscono il contenuto con JavaScript, per i PDF e per i documenti lunghi in cui vuoi più di 20.000 caratteri. La documentazione di OpenClaw segnala anche che il plugin ufficiale Firecrawl è oggi l'unico provider incluso su cui web_fetch può ricadere.
Come registro il server MCP in OpenClaw?
Prima prepara il server Python dalla pagina MCP: un file più i pacchetti mcp e httpx. Poi salvalo in OpenClaw con openclaw mcp add. La documentazione del registry di OpenClaw descrive i flag stdio --command, --arg, --env e --cwd, e salva le definizioni sotto mcp.servers nella sua configurazione.
Dopo esegui openclaw mcp doctor --probe. Senza --probe il doctor controlla solo la configurazione salvata; con esso verifica anche che i server abilitati si connettano.
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 --probeL'agente vedrà read_url?
Nei profili abituali, sì. La documentazione del registry di OpenClaw dice che OpenClaw incorporato espone gli strumenti MCP configurati nei profili coding e messaging. Il profilo minimal li nasconde e tools.deny: ["bundle-mcp"] li disattiva, quindi controlla queste due impostazioni se lo strumento non compare.
La descrizione dello strumento indica al modello quando preferirlo: pagine che richiedono JavaScript, PDF e letture lunghe. Il modello può comunque usare web_fetch per tutto il resto.
Come tratta read_url i siti che legge?
Allo stesso modo di ogni chiamata alla nostra API. Rispettiamo robots.txt: il nostro crawler si identifica come WebReaderAPI, segue le regole scritte per lui o per tutti i robot e non legge una pagina che un sito vieta. Le pagine rifiutate non vengono addebitate. Se un sito dichiara Content-Signal: ai-input=no nel suo robots.txt, non leggiamo le sue pagine per te. Se un sito rifiuta la nostra richiesta, restituiamo la sua risposta: non risolviamo mai CAPTCHA, non accediamo agli account e non tentiamo di aggirare un blocco o un paywall.
Le pagine dietro un login sono quindi fuori portata per read_url. Per un sito in cui hai effettuato l'accesso, lo strumento browser di OpenClaw, eseguito con la tua sessione, è quello giusto.
Quanto costa leggere pagine tramite OpenClaw?
Un credito per ogni pagina che restituisce contenuto, due quando serve un browser, nulla per rifiuti ed errori. Un assistente che legge 30 pagine al giorno sui suoi canali di chat usa circa 900 crediti al mese: 10.000 pagine (3,75 USD) dura quasi un anno. I crediti prepagati non scadono mai: le pagine non utilizzate restano sul tuo account finché non le usi.
Dai a OpenClaw una chiave API dedicata, così il suo utilizzo risulta separato dagli altri tuoi progetti.
OpenClaw: domande frequenti
WebReaderAPI è un provider integrato di OpenClaw?
No. Si connette come server MCP, che OpenClaw supporta senza alcun codice di plugin. Il server MCP è il breve file Python della nostra pagina MCP.
Dovrei disattivare web_fetch?
Non serve. Entrambi gli strumenti possono restare attivi; le descrizioni indicano al modello quale si adatta. Disattiva web_fetch solo se vuoi che ogni lettura passi da un unico punto per il logging.
Posso gestire il server dall'interfaccia web di OpenClaw?
La documentazione di OpenClaw descrive le impostazioni MCP nella sua Control UI, che modificano le stesse definizioni salvate della riga di comando. Usa quella che preferisci.
Funziona in un'installazione OpenClaw in sandbox?
Il server MCP è un processo locale che ha bisogno di accesso a internet per raggiungere https://webreaderapi.com/api/v1/read. Verifica che la tua sandbox permetta al processo di avviarsi e di effettuare quella chiamata HTTPS.
Fonti (4)
- Strumenti web — OpenClaw docs (read 2026-10-22)
- Web Fetch — OpenClaw docs (read 2026-10-22)
- Gestisci i server MCP salvati — OpenClaw docs (read 2026-10-22)
- MCP nella Control UI — OpenClaw docs (read 2026-10-22)