Cómo Usar OpenClaw
Una guía práctica para sacarle el máximo partido al agente de IA autónomo de RoqueOS.
Interfaz del Agente
La aplicación del Agente de IA está dividida en dos áreas principales:
- Panel de Chat (izquierda) — donde envías mensajes y sigues las respuestas
- Vista Previa del Escritorio (derecha) — transmisión en vivo de lo que hace el agente en el contenedor
Panel de Pasos
Debajo del chat, un panel de Pasos en Tiempo Real muestra cada acción que está tomando el agente: navegando a una URL, haciendo clic en un elemento, ejecutando un comando, etc.
Crear una Sesión
Cada conversación con el agente crea una sesión — un contenedor Docker aislado con un escritorio Linux exclusivo. Para comenzar:
- Abre la aplicación Agente de IA en el Launchpad.
- Haz clic en Nueva Sesión.
- El contenedor se inicializará (puede tomar de 10 a 30 segundos la primera vez).
- Cuando el escritorio aparezca en el panel derecho, el agente estará listo.
Enviar Tareas
Mejores Prácticas para Prompts
Sé específico y objetivo al describir la tarea. Cuanto más contexto proporciones, mejor será el resultado.
❌ Vago:
Investiga Docker✅ Específico:
Investiga las 5 principales diferencias entre Docker Compose v2 y v3,
crea un archivo markdown resumiendo los puntos y guárdalo en /home/user/docker-comparison.mdEjemplos de Tareas
Investigación y documentación:
Ve al sitio web hetzner.com, encuentra los planes VPS disponibles,
y crea una tabla comparativa con precios y características en CSV.Automatización de formularios:
Rellena el formulario de registro en [URL] con los siguientes datos:
nombre: Juan Pérez, correo: juan@ejemplo.com, plan: básicoDesarrollo:
Crea un script de Python que recopile los titulares de noticias
de Hacker News y guarde los 10 primeros en un archivo JSON.Análisis de sitios web:
Ve a este repositorio de GitHub [URL], lee el README, y explícame
qué hace el proyecto y cuáles son los requisitos previos de instalación.Acciones que el Agente Puede Realizar en RoqueOS
OpenClaw puede interactuar directamente con tu RoqueOS fuera del contenedor aislado:
| Acción | Descripción |
|---|---|
| Notificación | Enviar una alerta a tu escritorio de RoqueOS |
| Abrir App | Abrir una aplicación específica en el Launchpad |
| Abrir URL | Abrir una URL en el navegador de RoqueOS |
Ejemplo de uso: al final de una tarea larga, el agente puede enviar una notificación automática para hacerte saber que ha terminado.
Gestión de Sesiones
Sesiones Activas
Todas las sesiones activas aparecen listadas en la parte superior de la aplicación. Puedes:
- Reanudar una sesión anterior haciendo clic en ella
- Finalizar una sesión para liberar recursos del servidor
Límite de Sesiones Concurrentes
Por defecto, el servidor permite hasta 3 sesiones concurrentes (configurable a través de AGENT_MAX_SESSIONS). Finaliza las sesiones que ya no estés usando para ahorrar memoria RAM.
Capturas de Pantalla y Pantalla Completa
- Captura de Pantalla — haz clic en el icono de la cámara para capturar el estado actual del escritorio del agente
- Pantalla Completa — expande la vista del escritorio a pantalla completa para seguir mejor las tareas visuales
Limitaciones Conocidas
- El agente opera en un entorno aislado — no tiene acceso directo a tus archivos locales a menos que proporciones la información a través del chat.
- Las tareas que requieren inicio de sesión en cuentas (correo, redes sociales) requieren que proporciones credenciales durante la conversación.
- El tiempo de espera predeterminado es de 30 minutos de inactividad — tareas muy largas pueden requerir interacción periódica.
Solución de Problemas
El agente no responde
- Comprueba si el servidor está en línea:
curl http://localhost:27021/health - Confirma que la clave API esté configurada correctamente.
- Finaliza la sesión actual y crea una nueva.
El escritorio no aparece en el panel
El contenedor aún podría estar inicializándose. Espera 30 segundos y recarga la aplicación.
Respuestas lentas o incompletas
Puede ser un problema de límite de tasa del proveedor de IA. Espera unos momentos e inténtalo de nuevo, o reduce la complejidad de la tarea.