Uno sguardo onesto per il vostro agent OpenClaw
Un agent capace di lanciare curl sa già scaricare un URL. Quello che non sa è se lo scaricamento sia servito a qualcosa. Questo skill aggiunge sei operazioni sull’API EnConvert, e ogni lettura di pagina torna con un punteggio render_quality: un muro anti-bot o un guscio vuoto arriva segnalato invece di essere riassunto come se fosse la pagina.
Perché curl da solo non basta
Gli agent OpenClaw se la cavano bene con i comandi di shell. Il web si lascia leggere male in questo modo. Quattro cose si rompono nella pratica, e lo skill le copre tutte.
Una pagina che si renderizza in JavaScript
Perceive URL avvia un browser vero e restituisce la pagina stabilizzata in markdown, non il guscio vuoto che vede curl.
Un file Word, PowerPoint o EPUB
Convert File to Markdown legge formati per cui un agent non ha un parser e restituisce testo su cui può ragionare.
Sapere se la lettura è riuscita
Ogni lettura porta render_quality da 0.0 a 1.0. Una pagina di sfida ottiene un punteggio basso, così l’agent può riprovare o fermarsi invece di allucinare da un banner sui cookie.
Leggere un intero sito, non una pagina
Discover URLs elenca un sito da sitemap o crawl, così l’agent sceglie invece di indovinare gli URL.
Sei operazioni, un file di istruzioni
Uno skill ClawHub è un singolo file markdown che l’agent legge ed esegue. Nessun runtime da installare, nessun SDK da fissare, nessuno schema di tool da registrare. Ogni operazione è una chiamata curl documentata verso la stessa API REST usata da ogni altro client EnConvert.
Perceive URL
Renderizza una pagina in markdown, HTML, screenshot, PDF, link, immagini o dati strutturati. Gli artefatti tornano come URL firmati di breve durata, i dati strutturati tornano inline.
POST /v2/perceiveWeb Search
Cerca su web, notizie, immagini, accademico, brevetti o mappe e restituisce risultati ordinati con titolo, URL e frammento per il passo successivo.
POST /v2/lookupDiscover URLs
Elenca un sito da sitemap, crawl o entrambi, con pattern di inclusione ed esclusione, prima di spendere una sola lettura di pagina.
POST /v2/discoverExtract Structured
Passate uno schema JSON o una mappa piatta di campi e ricevete dati tipizzati per URL, da un elenco esplicito o da un sito che l’API esplora per voi.
POST /v2/distillConvert File to Markdown
Trasforma un documento, un foglio di calcolo, una presentazione, un PDF o un EPUB in markdown pulito, pronto da riassumere o indicizzare.
POST /v1/convert/anything-to-markdownConvert File to PDF
Converte un documento, un’immagine, HTML o testo in PDF quando l’agent deve restituire un file vero a una persona.
POST /v1/convert/anything-to-pdf
Un comando e un segreto
Lo skill non contiene alcuna chiave e non chiama nulla al di fuori dell’API EnConvert. La chiave privata la fornite voi e l’agent la legge dall’ambiente.
Installare da ClawHub
Eseguite il comando di installazione nel workspace dell’agent. Lo skill è pubblico, MIT-0, pubblicato sotto il publisher @enconvert.
Creare una chiave privata
Generate una chiave nella dashboard EnConvert. Le chiavi private iniziano con sk_. Quelle pubbliche pk_ servono ai widget del browser e qui vengono rifiutate.
Esporla come ENCONVERT_API_KEY
Mettete la chiave nell’ambiente in cui gira l’agent. Lo skill la valida con una chiamata whoami prima di fare lavoro vero, così una chiave sbagliata fallisce subito e non a metà di un compito.
Chiedere qualcosa all’agent
Nessun cablaggio, nessun file di configurazione. Chiedetegli di leggere una pagina, approfondire un tema o convertire un file, e sceglierà l’operazione dalle istruzioni.
Se mancano ENCONVERT_API_KEY o curl, OpenClaw scarta lo skill al caricamento e l’agent si comporta come se non fosse mai stato installato. Non c’è alcun messaggio di errore da leggere, quindi controllate prima entrambi se l’agent sembra non conoscere lo skill.
Cosa ci fanno davvero gli agent
Quattro compiti che non richiedono prompt engineering. L’agent legge lo skill e concatena le operazioni da solo.
"Leggi questa pagina e riassumila"
- Perceive URL
Perceive restituisce markdown stabilizzato con punteggio di qualità, così il riassunto riguarda la pagina e non una finestra di consenso.
"Approfondisci il tema e cita le fonti"
- Web Search
- Perceive URL
La ricerca trova i candidati, poi perceive legge i più promettenti. L’agent cita URL che ha letto davvero.
"Prendi i prezzi da ogni pagina dei concorrenti"
- Discover URLs
- Extract Structured
Discover elenca il sito, poi extract restituisce campi tipizzati per URL contro un solo schema.
"Trasforma questo contratto in appunti"
- Convert File to Markdown
Convert legge il file Word o PDF per cui l’agent non ha un parser e restituisce markdown.
Domande frequenti
Date al vostro agent uno sguardo onesto
Installate lo skill, impostate una variabile d’ambiente, e la prossima pagina che farete leggere al vostro agent tornerà con un punteggio.