Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

openclaw agent ejecuta un solo 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

1

Ejecutar 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

Dirigir 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"
3

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"

​
Indicadores

IndicadorDescripción
--message \<text\>Mensaje para enviar (obligatorio)
--to \<dest\>Deriva la clave de sesión de un destino (teléfono, id de chat)
--agent \<id\>Dirige a un agente configurado (usa su sesión main)
--session-id \<id\>Reutiliza una sesión existente por id
--localFuerza el runtime embebido local (omite el 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 pensamiento para el perfil de modelo seleccionado
--verbose \<on|full|off\>Establece el nivel de detalle
--timeout \<seconds\>Anula el tiempo de espera del agente
--jsonEmite 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.
  • Si no se puede acceder al Gateway, 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 reducen a main).
  • Los indicadores de pensamiento y detalle persisten en el almacén de sesiones.
  • Salida: texto sin formato 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. Consulta 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 CLI del agente

Referencia completa de indicadores y opciones 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 usados dentro de las sesiones de agente.