Un regard honnête pour votre agent OpenClaw
Un agent capable d’appeler curl sait déjà récupérer une URL. Ce qu’il ne sait pas, c’est si la récupération a vraiment abouti. Ce skill ajoute six opérations sur l’API EnConvert, et chaque lecture de page revient avec un score render_quality : un mur anti-robots ou une coquille vide arrive signalée au lieu d’être résumée comme si c’était la page.
Pourquoi curl ne suffit pas
Les agents OpenClaw sont à l’aise avec les commandes shell. Le web se laisse mal lire ainsi. Quatre choses cassent en pratique, et le skill couvre chacune.
Une page rendue en JavaScript
Perceive URL lance un vrai navigateur et renvoie la page stabilisée en markdown, pas la coquille vide que voit curl.
Un fichier Word, PowerPoint ou EPUB
Convert File to Markdown lit des formats pour lesquels un agent n’a pas de parseur et renvoie un texte exploitable.
Savoir si la lecture a réussi
Chaque lecture porte render_quality de 0.0 à 1.0. Une page de défi obtient un score bas, donc l’agent peut réessayer ou s’arrêter au lieu d’halluciner à partir d’un bandeau de cookies.
Lire un site entier, pas une page
Discover URLs recense un site par sitemap ou exploration, donc l’agent choisit au lieu de deviner des URL.
Six opérations, un fichier d’instructions
Un skill ClawHub est un seul fichier markdown que l’agent lit et exécute. Aucun runtime à installer, aucun SDK à figer, aucun schéma d’outil à enregistrer. Chaque opération est un appel curl documenté vers la même API REST que tous les autres clients EnConvert.
Perceive URL
Rend une page en markdown, HTML, capture, PDF, liens, images ou données structurées. Les artefacts reviennent en URL signées de courte durée, les données structurées reviennent en ligne.
POST /v2/perceiveWeb Search
Cherche sur le web, l’actualité, les images, l’académique, les brevets ou les cartes et renvoie des résultats classés avec titre, URL et extrait pour l’étape suivante.
POST /v2/lookupDiscover URLs
Recense un site par sitemap, exploration ou les deux, avec motifs d’inclusion et d’exclusion, avant de dépenser la moindre lecture de page.
POST /v2/discoverExtract Structured
Fournissez un schéma JSON ou une liste de champs et recevez des données typées par URL, depuis une liste explicite ou depuis un site que l’API explore pour vous.
POST /v2/distillConvert File to Markdown
Transforme un document, un tableur, une présentation, un PDF ou un EPUB en markdown propre, prêt à résumer ou à indexer.
POST /v1/convert/anything-to-markdownConvert File to PDF
Convertit un document, une image, du HTML ou du texte en PDF quand l’agent doit rendre un vrai fichier à une personne.
POST /v1/convert/anything-to-pdf
Une commande et un secret
Le skill n’embarque aucune clé et n’appelle rien d’autre que l’API EnConvert. Vous fournissez votre propre clé privée, que l’agent lit dans l’environnement.
Installer depuis ClawHub
Lancez la commande d’installation dans l’espace de travail de l’agent. Le skill est public, MIT-0, publié sous le publisher @enconvert.
Créer une clé privée
Générez une clé dans le tableau de bord EnConvert. Les clés privées commencent par sk_. Les clés publiques pk_ servent aux widgets navigateur et sont refusées ici.
L’exposer via ENCONVERT_API_KEY
Placez la clé dans l’environnement où tourne l’agent. Le skill la valide par un appel whoami avant tout travail réel, donc une mauvaise clé échoue tout de suite et non au milieu d’une tâche.
Demander quelque chose à l’agent
Aucun câblage, aucun fichier de configuration. Demandez-lui de lire une page, de creuser un sujet ou de convertir un fichier, il choisira l’opération dans les instructions.
Si ENCONVERT_API_KEY ou curl manque, OpenClaw écarte le skill au chargement et l’agent se comporte comme s’il n’avait jamais été installé. Aucun message d’erreur n’apparaît, vérifiez donc les deux en premier si l’agent semble ignorer le skill.
Ce que les agents en font vraiment
Quatre tâches sans ingénierie de prompt. L’agent lit le skill et enchaîne les opérations lui-même.
« Lis cette page et résume-la »
- Perceive URL
Perceive renvoie un markdown stabilisé avec un score de qualité : le résumé porte sur la page, pas sur une fenêtre de consentement.
« Documente ce sujet et cite tes sources »
- Web Search
- Perceive URL
La recherche trouve des candidats, puis perceive lit les plus prometteurs. L’agent cite des URL qu’il a réellement lues.
« Récupère les tarifs de chaque page concurrente »
- Discover URLs
- Extract Structured
Discover recense le site, puis extract renvoie des champs typés par URL contre un seul schéma.
« Transforme ce contrat en notes »
- Convert File to Markdown
Convert lit le fichier Word ou PDF pour lequel l’agent n’a pas de parseur et renvoie du markdown.
Questions fréquentes
Donnez un regard honnête à votre agent
Installez le skill, définissez une variable d’environnement, et la prochaine page que vous ferez lire à votre agent reviendra avec un score.