Envío de agente

openclaw agent ejecuta un solo turno de agente desde la línea de comandos sin necesidad de un mensaje de chat entrante. Úselo para flujos de trabajo con guiones, pruebas y entrega programática.

Inicio rápido

1. Ejecutar un turno simple de agente

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

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

2. Apuntar a un agente o sesión específico

   # 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"

3. Enviar 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"

Opciones

Opción	Descripción
--message \<text\>	Mensaje a enviar (obligatorio)
--to \<dest\>	Derivar clave de sesión de un objetivo (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 tiempo de ejecución integrado local (omitir 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 pensamiento para el perfil de modelo seleccionado
--verbose \<on|full|off\>	Establecer el nivel detallado (verbose)
--timeout \<seconds\>	Anular el tiempo de espera del agente
--json	Salir JSON estructurado

Comportamiento

• De forma predeterminada, la CLI va a través del Gateway. Agregue --local para forzar el tiempo de ejecución integrado en la máquina actual.
• Si el Gateway es inalcanzable, la CLI retrocede a la ejecución integrada local.
• Selección de sesión: --to deriva la clave de sesión (los objetivos de grupo/canal preservan el aislamiento; los chats directos colapsan 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 suministran. Las claves desnudas no centinela se limitan a --agent cuando se suministran; por ejemplo, --agent ops --session-key incident-42 se dirige a agent:ops:incident-42. Sin --agent, las claves desnudas no centinela se limitan al agente predeterminado configurado. Los literales global y unknown permanecen sin ámbito solo cuando no se proporciona ningún --agent; en ese caso, el respaldo integrado y la propiedad de la tienda utilizan el agente predeterminado configurado.
• Las opciones de pensamiento (thinking) y detallado (verbose) persisten en el almacén de la sesión.
• Salida: texto sin formato por defecto, o --json para carga estructurada + metadatos.
• Con --json --deliver, el JSON incluye el estado de entrega para envíos enviados, suprimidos, parciales y fallidos. Vea Estado de entrega JSON.

Ejemplos

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

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

# 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 Agent

Referencia completa de opciones y banderas de openclaw agent.

Subagentes

Generación de subagentes en segundo plano.

Sesiones

Cómo funcionan las claves de sesión y cómo --to``--agent, %%PH:INLINE_CODE:69:5d8396b%% y --session-id las resuelven.

Comandos de barra

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