Una mirada honesta para su agente OpenClaw
Un agente capaz de ejecutar curl ya puede descargar una URL. Lo que no puede es saber si la descarga sirvió de algo. Este skill añade seis operaciones sobre la API de EnConvert, y cada lectura de página vuelve con una puntuación render_quality, de modo que un muro anti-bots o una cáscara vacía llega marcada en lugar de resumirse como si fuera la página.
Por qué curl no basta
Los agentes OpenClaw manejan bien los comandos de shell. La web se deja leer mal con ellos. Cuatro cosas fallan en la práctica, y el skill cubre cada una.
Una página que se renderiza con JavaScript
Perceive URL abre un navegador real y devuelve la página ya asentada como markdown, no la cáscara vacía que ve curl.
Un archivo Word, PowerPoint o EPUB
Convert File to Markdown lee formatos para los que un agente no tiene parser y devuelve texto con el que puede razonar.
Saber si la lectura funcionó
Cada lectura lleva render_quality de 0.0 a 1.0. Una página de desafío puntúa bajo, así que el agente puede reintentar o detenerse en vez de alucinar a partir de un aviso de cookies.
Leer un sitio entero, no una página
Discover URLs enumera un sitio por sitemap o rastreo, así el agente elige en lugar de adivinar URL.
Seis operaciones, un archivo de instrucciones
Un skill de ClawHub es un único archivo markdown que el agente lee y ejecuta. No hay runtime que instalar, ni SDK que fijar, ni esquema de herramientas que registrar. Cada operación es una llamada curl documentada contra la misma API REST que usa cualquier otro cliente de EnConvert.
Perceive URL
Renderiza una página como markdown, HTML, captura, PDF, enlaces, imágenes o datos estructurados. Los artefactos vuelven como URL firmadas de vida corta; los datos estructurados vuelven en línea.
POST /v2/perceiveWeb Search
Busca en web, noticias, imágenes, académico, patentes o mapas y obtiene resultados ordenados con título, URL y fragmento para el siguiente paso.
POST /v2/lookupDiscover URLs
Enumera un sitio por sitemap, rastreo o ambos, con patrones de inclusión y exclusión, antes de gastar una sola lectura de página.
POST /v2/discoverExtract Structured
Pase un esquema JSON o un mapa plano de campos y reciba datos tipados por URL, desde una lista explícita o desde un sitio que la API rastrea por usted.
POST /v2/distillConvert File to Markdown
Convierte un documento, hoja de cálculo, presentación, PDF o EPUB en markdown limpio, listo para resumir o incrustar.
POST /v1/convert/anything-to-markdownConvert File to PDF
Convierte un documento, imagen, HTML o texto a PDF cuando el agente debe devolver un archivo real a una persona.
POST /v1/convert/anything-to-pdf
Un comando y un secreto
El skill no incluye ninguna clave y no llama a nada salvo la API de EnConvert. Usted aporta su propia clave privada y el agente la lee del entorno.
Instalar desde ClawHub
Ejecute el comando de instalación en el workspace del agente. El skill es público, MIT-0 y se publica bajo el publisher @enconvert.
Crear una clave privada
Genere una clave en el panel de EnConvert. Las claves privadas empiezan por sk_. Las públicas pk_ son para widgets de navegador y aquí se rechazan.
Exponerla como ENCONVERT_API_KEY
Coloque la clave en el entorno donde corre el agente. El skill la valida con una llamada whoami antes de hacer trabajo real, así una clave incorrecta falla de inmediato y no a mitad de una tarea.
Pedirle algo al agente
Sin cableado ni archivo de configuración. Pídale leer una página, investigar un tema o convertir un archivo, y elegirá la operación a partir de las instrucciones.
Si falta ENCONVERT_API_KEY o curl, OpenClaw filtra el skill al cargar y el agente se comporta como si nunca se hubiera instalado. No hay mensaje de error que leer, así que revise ambos primero si el agente parece no conocer el skill.
Qué hacen los agentes con esto
Cuatro tareas que no necesitan ingeniería de prompts. El agente lee el skill y encadena las operaciones por su cuenta.
«Lee esta página y resúmela»
- Perceive URL
Perceive devuelve markdown ya asentado con puntuación de calidad, así que el resumen es de la página y no de un diálogo de consentimiento.
«Investiga este tema y cita fuentes»
- Web Search
- Perceive URL
La búsqueda encuentra candidatos y luego perceive lee los prometedores. El agente cita URL que realmente leyó.
«Saca precios de cada página de la competencia»
- Discover URLs
- Extract Structured
Discover enumera el sitio y extract devuelve campos tipados por URL contra un solo esquema.
«Convierte este contrato en notas»
- Convert File to Markdown
Convert lee el archivo Word o PDF para el que el agente no tiene parser y devuelve markdown.
Preguntas frecuentes
Dé a su agente una mirada honesta
Instale el skill, defina una variable de entorno y lo próximo que pida leer a su agente volverá con una puntuación.