Saltar al contenido principal

Agent Send

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

Inicio rápido

1

Ejecuta un turno de agente simple

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

Dirígete a un agente o sesión específicos

# Dirigirse a un agente específico
openclaw agent --agent ops --message "Summarize logs"

# Dirigirse a un número de teléfono (deriva la clave de sesión)
openclaw agent --to +15555550123 --message "Status update"

# Reutilizar una sesión existente
openclaw agent --session-id abc123 --message "Continue the task"
3

Entrega la respuesta a un canal

# Entregar a WhatsApp (canal predeterminado)
openclaw agent --to +15555550123 --message "Report ready" --deliver

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

Indicadores

FlagDescripción
--message \<text\>Mensaje que se enviará (obligatorio)
--to \<dest\>Deriva la clave de sesión desde un destino (teléfono, id de chat)
--agent \<id\>Se dirige a un agente configurado (usa su sesión main)
--session-id \<id\>Reutiliza una sesión existente por id
--localFuerza el entorno de ejecución integrado local (omite Gateway)
--deliverEnvía 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\>Establece el nivel de thinking (off, minimal, low, medium, high, xhigh)
--verbose \<on|full|off\>Establece el nivel detallado
--timeout \<seconds\>Anula el tiempo de espera del agente
--jsonGenera JSON estructurado

Comportamiento

  • De forma predeterminada, la CLI pasa por el Gateway. Agrega --local para forzar el entorno de ejecución integrado en la máquina actual.
  • Si el Gateway no es accesible, la CLI recurre a la ejecución integrada local.
  • Selección de sesión: --to deriva la clave de sesión (los destinos de grupo/canal conservan el aislamiento; los chats directos colapsan a main).
  • Los indicadores de thinking y verbose persisten en el almacenamiento de la sesión.
  • Salida: texto sin formato de manera predeterminada, o --json para carga útil estructurada + metadatos.

Ejemplos

# Turno simple con salida JSON
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turno con nivel de thinking
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Entregar a un canal diferente al de la sesión
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

Relacionado