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 de agente simple

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

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

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

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

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)
--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 objetivo 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 nivel detallado
--timeout \<seconds\>	Anular el tiempo de espera del agente
--json	Salida JSON estructurada

Comportamiento

• De forma predeterminada, la CLI funciona a través del Gateway. Agregue --local para forzar el tiempo de ejecución integrado en la máquina actual.
• Si la Gateway no es accesible, 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).
• Las opciones de pensamiento y detallado persisten en el almacén de sesiones.
• Salida: texto plano de forma predeterminada, o --json para carga útil estructurada + metadatos.
• Con --json --deliver, el JSON incluye el estado de entrega para envíos enviados, suprimidos, parciales y fallidos. Consulte 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

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

Referencia completa de opciones y marcas 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 y --session-id las resuelven.

Comandos de barra

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