Agent coordination

Envío de agente

openclaw agent ejecuta un único turno de agente desde la línea de comandos sin necesitar un mensaje de chat entrante. Úsalo para flujos de trabajo con scripts, pruebas y entrega programática.

Inicio rápido

Ejecutar un turno de agente sencillo

bash

openclaw agent --agent main --message "What is the weather today?"

Esto envía el mensaje a través del Gateway e imprime la respuesta.

Enviar un prompt multilínea desde un archivo

bash

openclaw agent --agent ops --message-file ./task.md

Esto lee un archivo UTF-8 válido como cuerpo del mensaje del agente.

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

bash

# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

Entregar la respuesta a un canal

bash

# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

Flags

Flag	Descripción
`--message \<text\>`	Mensaje en línea que se 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
`--local`	Forzar el runtime embebido local (omitir el Gateway)
`--deliver`	Enviar la respuesta a un canal de chat
`--channel \<name\>`	Canal de entrega (whatsapp, telegram, discord, slack, 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\>`	Establecer el nivel de detalle
`--timeout \<seconds\>`	Anular el tiempo de espera del agente
`--json`	Generar JSON estructurado

Comportamiento

De forma predeterminada, la CLI pasa a través del 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 conservan el contenido multilínea después de eliminar un BOM UTF-8 opcional.
Si el Gateway no está disponible, la CLI recurre a la ejecución embebida local.
Selección de sesión: --to deriva la clave de sesión (los destinos de grupo/canal conservan el aislamiento; los chats directos se contraen 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 se proporcionan ambos. Las claves simples que no son 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 simples que no son centinela se acotan al agente predeterminado configurado. Los literales global y unknown permanecen sin ámbito solo cuando no se proporciona --agent; en ese caso, la reserva embebida y la propiedad del almacén usan el agente predeterminado configurado.
Las flags de razonamiento y detalle persisten en el almacén de sesión.
Salida: texto sin formato de forma predeterminada, o --json para carga estructurada + 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

bash

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"