Visión General del Framework OpenClaw
Introducción a OpenClaw — el runtime experimental de agentes que proporciona el modelo de misión, el bucle de ejecución y el ciclo de vida de artefactos utilizado en todo el laboratorio.
Propósito
Esta nota introduce OpenClaw, la capa de framework experimental utilizada para construir y ejecutar agentes en este laboratorio. En lugar de describir agentes individuales de forma aislada, esta página cubre el modelo de runtime compartido que da estructura a esos agentes: cómo los objetivos se convierten en misiones, cómo las misiones impulsan la ejecución y cómo los resultados se convierten en artefactos.
Estado: Experimental (en desarrollo activo junto con los agentes del laboratorio)
Por qué existe OpenClaw
Construir agentes que realicen investigación web o trabajo de software significativo requiere coordinar varias cosas a la vez: un objetivo claro, un plan, acceso a herramientas y entornos de navegador, acumulación de estado, salidas estructuradas y una forma de evaluar si se está progresando. Sin un modelo de runtime compartido, cada agente se convierte en un script ad hoc — difícil de razonar, difícil de extender y difícil de comparar entre experimentos.
OpenClaw existe para proporcionar ese modelo compartido. Define cómo un agente recibe un objetivo, cómo lo transforma en un plan, cómo interactúa con su entorno y cómo produce salidas auditables. El objetivo no es un framework de agentes de propósito general para todo tipo de tareas, sino un runtime enfocado, adaptado a las restricciones específicas de los agentes orientados a la web y a la investigación.
Idea central
OpenClaw se articula en torno a un único concepto organizador: la misión. Una misión es una unidad acotada de trabajo de agente con un objetivo definido, un conjunto de restricciones y una condición de éxito. Todo lo que hace el agente está al servicio de completar esa misión.
Dentro de una misión, el agente opera en un bucle iterativo: planificar un paso, actuar sobre el entorno, observar resultados, actualizar el estado, producir artefactos, evaluar el progreso y repetir. Este bucle se ejecuta hasta alcanzar una condición terminal — el objetivo se cumple, el agente decide que no puede continuar, o un paso de evaluación dispara una detención.
El rol del framework es gestionar este bucle — proporcionando el andamiaje para la planificación, el despacho de herramientas, la interacción con el navegador, la persistencia del estado, la escritura de artefactos y la evaluación — de modo que los experimentos de agentes puedan centrarse en los objetivos y la estrategia en lugar de en la infraestructura.
Abstracciones principales
Misión
Una Misión es la unidad de trabajo de nivel superior. Contiene un objetivo — una descripción en lenguaje natural de lo que debe lograrse — junto con restricciones (límites de alcance, presupuestos de pasos, herramientas permitidas) y criterios de éxito (condiciones bajo las cuales la misión se considera completada). La misión es el contrato entre el usuario y el runtime del agente.
Agente
Un Agente es la unidad de ejecución asignada a una misión. Mantiene referencias al runtime, a la misión actual y al estado de memoria activo. El agente no contiene lógica de dominio directamente; opera a través del bucle de planificación y delega en las herramientas y el entorno del navegador. La misma estructura de agente se reutiliza entre distintos tipos de misión.
Runtime
El Runtime es el host de ejecución. Inicializa el entorno (sesión de navegador, almacén de memoria, directorio de artefactos, logging), gestiona el bucle de planificación y controla los eventos del ciclo de vida — inicialización, cada paso, descarga de artefactos y evaluación final. Los agentes no se instancian directamente; el runtime es dueño del ciclo de vida.
Planificador / Bucle de Razonamiento
El Planificador es el componente de decisión. Dado el objetivo de la misión actual y el estado de memoria acumulado, produce la siguiente acción: una llamada a herramienta, una navegación en el navegador, una consulta estructurada o una decisión de detención. El planificador no mantiene su propio estado; opera sobre lo que el runtime expone, lo que permite intercambiar la estrategia de razonamiento de forma independiente a la infraestructura.
Capa de Herramientas
La Capa de Herramientas expone operaciones invocables al agente: búsqueda web, extracción de contenido, operaciones de archivo, consultas de datos estructurados y llamadas a APIs externas. Cada herramienta tiene un esquema de entrada definido, una interfaz de llamada y un tipo de resultado. El planificador selecciona las herramientas; el runtime las despacha y devuelve los resultados a la memoria del agente.
Navegador / Entorno Web
Para los agentes orientados a la web, el entorno del navegador proporciona acceso a páginas en tiempo real: navegación, interacción con el DOM, captura de pantallas y extracción de contenido. El agente interactúa con él mediante acciones estructuradas en lugar de scripts directos. La sesión del navegador está acotada a la misión y se destruye al completarse o fallar.
Estado y Memoria
La memoria es el contexto de trabajo del agente: observaciones acumuladas, resultados parciales y decisiones de razonamiento tomadas a lo largo de una misión. El estado se distingue de los artefactos de salida — es el material de trabajo interno del agente durante la ejecución, no el entregable final. La memoria está acotada a una ejecución de misión y no se persiste entre misiones independientes por defecto.
Artefactos
Los artefactos son las salidas estructuradas de una misión: informes de investigación, extractos de datos, contenido scrapeado, registros de decisiones o archivos generados. Los artefactos se escriben en un directorio de ejecución aislado, tipados por fase o propósito, y diseñados para ser legibles por humanos. El modelo de artefactos es lo que hace que las ejecuciones de misión sean auditables — la salida de cada fase puede inspeccionarse de forma independiente.
Registros y Evaluación
Cada ejecución de misión produce registros estructurados: records paso a paso de lo que el agente planificó, ejecutó y observó. La evaluación ocurre tanto dentro del bucle — el agente evalúa si los artefactos acumulados cumplen los criterios de éxito de la misión — como de forma retrospectiva, revisando los registros y el directorio de artefactos tras la finalización.
Arquitectura de alto nivel
Ciclo de vida de ejecución del agente
Cómo encaja esto en el Laboratorio
Las páginas de este laboratorio describen experimentos construidos sobre OpenClaw. Cada nota de agente cubre un dominio específico — investigación web, ejecución de código, exploración de información, automatización multimedia — pero el modelo de ejecución subyacente es el mismo. Entender OpenClaw facilita la lectura de esas notas: las diferencias entre agentes son principalmente diferencias en el dominio del objetivo, la selección de herramientas y la estrategia de evaluación, no en el bucle de ejecución fundamental.
El framework es experimental y evoluciona junto con los agentes. Algunas abstracciones descritas aquí reflejan la implementación actual; otras describen estructura que está activamente en progreso. Donde el estado de implementación difiera de esta visión general, las notas individuales de cada agente son la fuente de referencia.
Referencias
Páginas relacionadas
→ Arquitectura de Agentes — documentación más amplia del ecosistema local de agentes
→ Resumen del Sistema — roles de los agentes y topología de componentes
→ Flujo de Datos — cómo se mueven las solicitudes y artefactos
→ Agente de Investigación — agente de investigación web sobre el modelo de misión OpenClaw
→ Framework de Investigación — componentes del pipeline y detalles del flujo de misión