Saltar al contenido principal
openclaw agent ejecuta un único turno de agente desde la línea de comandos sin un mensaje de chat entrante. Úsalo para flujos de trabajo con scripts, pruebas y entrega programática. Referencia completa de flags y comportamiento: Referencia de la CLI de agente.

​
Inicio rápido

1

Ejecutar un turno de agente simple

openclaw agent --agent main --message "What is the weather today?"
Envía el mensaje a través del Gateway e imprime la respuesta.
2

Enviar un prompt multilínea desde un archivo

openclaw agent --agent ops --message-file ./task.md
Lee un archivo UTF-8 válido como cuerpo del mensaje del agente.
3

Apuntar a un agente o una sesión específicos

# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"

# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"

# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"

# Target an exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"
4

Entregar la respuesta a un canal

# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver

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

​
Flags

FlagDescripción
--message <text>Mensaje en línea para enviar
--message-file <path>Leer el mensaje desde un archivo UTF-8 válido
--to <dest>Derivar la clave de sesión desde un destino (teléfono, id de chat)
--session-key <key>Usar una clave de sesión explícita
--agent <id>Apuntar a un agente configurado (usa su sesión main)
--session-id <id>Reutilizar una sesión existente por id
--model <id>Anulación de modelo para esta ejecución (provider/model o id de modelo)
--localForzar runtime embebido local (omitir Gateway)
--deliverEnviar la respuesta a un canal de chat
--channel <name>Canal de entrega (discord, slack, telegram, whatsapp, etc.)
--reply-to <target>Anulación del destino de entrega
--reply-channel <name>Anulación del canal de entrega
--reply-account <id>Anulación del id de cuenta de entrega
--thinking <level>Establecer el nivel de razonamiento para el perfil de modelo seleccionado
--verbose <on|full|off>Persistir el nivel detallado para la sesión (full también registra la salida de herramientas)
--timeout <seconds>Anular el timeout del agente (predeterminado 600, o valor de configuración)
--jsonGenerar JSON estructurado

​
Comportamiento

  • De forma predeterminada, la CLI pasa por el Gateway. Añade --local para forzar el runtime embebido en la máquina actual.
  • Pasa exactamente uno de --message o --message-file. Los mensajes de archivo preservan el contenido multilínea tras eliminar un BOM UTF-8 opcional.
  • Si la solicitud al Gateway falla, la CLI recurre a la ejecución embebida local; un timeout del Gateway recurre con una sesión nueva en lugar de competir con la transcripción original.
  • Selección de sesión: --to deriva la clave de sesión (los destinos de grupo/canal preservan el aislamiento; los chats directos se reducen a main).
  • --session-key selecciona una clave explícita. Las claves con prefijo de agente deben usar agent:<agent-id>:<session-key>, y --agent debe coincidir con ese id de agente cuando ambos se proporcionan. Las claves sin formato que no sean centinela se acotan a --agent cuando se proporciona; por ejemplo, --agent ops --session-key incident-42 enruta a agent:ops:incident-42. Sin --agent, las claves sin formato que no sean centinela se acotan al agente predeterminado configurado. Los literales global y unknown permanecen sin acotar solo cuando no se proporciona --agent; la ruta de fallback embebida resuelve esas sesiones centinela al agente predeterminado configurado.
  • --channel, --reply-channel y --reply-account afectan la entrega de respuestas, no el enrutamiento de sesiones.
  • Los flags de razonamiento y detalle persisten en el almacén de sesiones.
  • Salida: texto sin formato de forma predeterminada, o --json para payload estructurado + metadatos.
  • Con --json --deliver, el JSON incluye el estado de entrega para envíos enviados, suprimidos, parciales y fallidos. Consulta estado de entrega JSON.

​
Ejemplos

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with a model override
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​
Relacionado

Referencia de la CLI de agente

Referencia completa de flags y opciones de openclaw agent.

Subagentes

Creación de subagentes en segundo plano.

Sesiones

Cómo funcionan las claves de sesión y cómo --to, --agent y --session-id las resuelven.

Comandos slash

Catálogo de comandos nativos usado dentro de las sesiones de agente.