Ejecuta agentes de OpenClaw desde la terminal

A veces, el flujo de trabajo de chat es demasiado lento cuando solo necesitas una respuesta rápida o quieres automatizar un proceso. Abrir una aplicación, buscar el contacto y enviar un mensaje para obtener un reporte consume tiempo que podrías usar en tareas más importantes.

Si estás probando la lógica de tus agentes o quieres integrar respuestas en tus propios scripts, enviar mensajes manuales no es la mejor opción. Necesitas una forma de interactuar con el runtime sin fricciones.

What You’ll Need

• OpenClaw CLI instalada.
• Acceso al Gateway (o API keys de tus proveedores de modelos para ejecución local).
• Un agente configurado o un ID de sesión existente.

Quick Start

El comando openclaw agent ejecuta un único turno del agente sin necesidad de recibir un mensaje externo. La mejor forma de usarlo es a través del Gateway, que viene configurado por defecto. Si prefieres usar el runtime embebido en tu propia máquina, añade el flag --local.

Aquí tienes los pasos para empezar en menos de 5 minutos:

1. Ejecución básica a un destinatario Usa --to para definir el destino. Esto mantiene el aislamiento de la sesión según el canal:

openclaw agent --to +15555550123 --message "status update"

2. Ejecución directa a un agente Si quieres hablar con un agente específico (usando su sesión main), usa el flag --agent:

openclaw agent --agent ops --message "Summarize logs"

3. Control de salida y razonamiento Puedes ajustar el nivel de thinking (para modelos compatibles como GPT-5.2) y obtener la respuesta en formato JSON para procesarla con otras herramientas:

openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

4. Entrega de resultados a canales externos Si quieres que el agente no solo responda en tu terminal, sino que envíe el resultado a un canal específico, combina --deliver con los parámetros de destino:

openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

Troubleshooting

• El Gateway no responde: Si el Gateway no es alcanzable, la CLI tiene un sistema de fallback automático. Ejecutará el agente usando el runtime local embebido (asegúrate de tener las API keys de tus modelos cargadas en tu shell).
• La configuración de verbosidad no se guarda: Los flags --thinking y --verbose persisten en el almacenamiento de la sesión. Verifica que estás usando el --session-id correcto si quieres mantener comportamientos específicos entre ejecuciones.

Para resolver dudas específicas sobre tu configuración, consulta el AI Setup Assistant.

What’s Next

• openclaw message documentation
• Configuración de canales y targets