Risposta rapida
Come aggiungo un'API di ricerca web con il contenuto delle pagine a OpenClaw?
Salva il server MCP LLMWebSearch dalla nostra pagina MCP, registralo con openclaw mcp add llmwebsearch --command … --arg … --env LLMWEBSEARCH_API_KEY=…, poi verificalo con openclaw mcp doctor --probe. L'agente ottiene search_web, i cui risultati includono le prime 3 pagine in Markdown, accanto al web_search integrato di OpenClaw. Una ricerca costa 1 credito, a partire da 1,20 USD/1K ricerche a ottobre 2026. Senza KYC.
Ricerca OpenClaw, come documentato il 22 ottobre 2026
| Provider web_search integrati | 16, tra cui Brave Search, DeepSeek, DuckDuckGo, Exa, Firecrawl, Gemini, Parallel, Perplexity, SearXNG e Tavily |
|---|---|
| Scelta automatica | Il primo provider basato su API pronto, in un ordine fisso che inizia con Brave |
| Provider senza chiave | Mai scelti automaticamente; li selezioni tu stesso |
| I nostri tool (MCP) | search_web e read_urls, da un server Python locale |
| Il nostro costo | Un credito paga una ricerca: fino a 20 risultati classificati, con le pagine dei primi 3 lette e restituite come Markdown. Leggere da 4 a 10 pagine costa 2 crediti. Una chiamata che termina in errore non costa nulla |
| Il nostro lettore di pagine | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/), robots.txt rispettato |
Perché aggiungere la nostra ricerca quando OpenClaw ha web_search?
Per ottenere il testo della pagina insieme ai risultati in una sola chiamata. La pagina dei web tool di OpenClaw elenca 16 provider integrati per web_search, scelti in un ordine fisso di auto-rilevamento quando non ne è impostato nessuno. Il nostro tool non sostituisce quella scelta; aggiunge una seconda opzione che il modello può chiamare di proposito.
search_web restituisce fonti numerate con le prime pagine già lette in Markdown, così l'agente può rispondere e citare senza un fetch separato per ogni link. read_urls legge fino a 20 link che l'agente ha trovato altrove, attraverso lo stesso reader.
Come registro il server MCP?
Prima configura il server Python dalla pagina MCP: un file, più i pacchetti mcp e httpx in un ambiente virtuale. Poi salvalo in OpenClaw con openclaw mcp add. La documentazione del registry di OpenClaw descrive i flag stdio --command, --arg, --env e --cwd, e chiede di fermare il Gateway locale mentre i server salvati cambiano.
Esegui openclaw mcp doctor --probe subito dopo. Senza --probe il doctor controlla solo le impostazioni salvate; con esso, dimostra anche che il server si connette.
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 --probeL'agente vedrà search_web?
Nei profili usuali, sì. La documentazione del registry di OpenClaw dice che i tool MCP configurati compaiono nei profili di tool coding e messaging. Il profilo minimal li nasconde e tools.deny: ["bundle-mcp"] li disattiva, quindi controlla queste due impostazioni se il tool manca.
La docstring del tool dice al modello cosa restituisce. Aggiungi una riga alle istruzioni del tuo agente se vuoi che sia preferito, ad esempio "usa search_web quando devi citare una pagina".
LLMWebSearch può essere selezionato come provider web_search?
Oggi no. La documentazione di OpenClaw dice che l'impostazione del provider accetta i provider dichiarati dai manifest dei plugin inclusi e installati. Non pubblichiamo nessun plugin OpenClaw, quindi la nostra ricerca arriva come strumenti MCP con i loro nomi.
In pratica per l'agente cambia poco: chiama search_web come chiamerebbe web_search. Resta anche facile distinguere i due nei log di OpenClaw e nella tua cronologia di utilizzo.
Come tratta il nostro reader i siti nei risultati?
Come per ogni chiamata. Il nostro reader rispetta robots.txt: si presenta come LLMWebSearch, segue le regole che un sito scrive per lui o per tutti i robot, e lascia fuori il contenuto di qualsiasi pagina che non gli è permesso leggere. Un sito che imposta Content-Signal: ai-input=no nel suo robots.txt tiene le sue pagine fuori dal contenuto dei tuoi risultati. Quando un sito respinge il nostro reader, il risultato torna senza contenuto e con lo status del sito: non risolviamo mai CAPTCHA, non accediamo agli account e non aggiriamo un blocco o un paywall.
Una pagina dietro un login quindi torna senza contenuto. Per un sito in cui hai effettuato l'accesso, lo strumento browser di OpenClaw, eseguito con la tua sessione, è la scelta giusta.
Quanto costerà cercare tramite OpenClaw?
Un credito per ogni chiamata search_web che legge fino a 3 pagine, nulla per le chiamate che falliscono. Leggere pagine di cui hai già gli URL costa 1 credito per ogni gruppo iniziato di 3 pagine restituite con contenuto, fino a 20 URL per chiamata; gli URL rifiutati o falliti non vengono contati. Un assistente che cerca 25 volte al giorno nei suoi canali di chat usa circa 750 crediti al mese, quindi 5.000 ricerche (9,25 USD) dura più di sei mesi. I crediti di ricerca non hanno data di scadenza: quello che non usi questo mese è ancora lì l'anno prossimo.
Assegna a OpenClaw una chiave API dedicata, così il suo utilizzo si distingue dai tuoi altri progetti.
OpenClaw: domande frequenti
Devo disattivare il web_search di OpenClaw?
Non serve. Possono restare attivi entrambi. Disattiva quello integrato solo se vuoi che ogni ricerca passi da un unico provider, per una sola fattura e un solo log.
Funziona con un OpenClaw in sandbox?
Il server MCP è un processo locale che chiama https://llmwebsearch.com/api/v1 via HTTPS. La tua sandbox deve permettergli di avviarsi e raggiungere quell'indirizzo.
Posso gestire il server dalla Control UI?
OpenClaw conserva i server MCP salvati sotto mcp.servers nella sua configurazione. La sua documentazione rimanda alla Control UI per le impostazioni MCP live supportate, e nota che modificare i server salvati dalla riga di comando richiede che il Gateway locale sia fermo.
Fonti (2)
- Strumenti web — OpenClaw docs (read 2026-10-22)
- Gestire i server MCP salvati — OpenClaw docs (read 2026-10-22)