Agent coordination

Envío del agente

OmeniaClaw 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

Ejecutar un turno de agente simple

bash

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

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

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

bash

# Target a specific agentOmeniaClaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)OmeniaClaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionOmeniaClaw agent --session-id abc123 --message "Continue the task"

Entregar la respuesta a un canal

bash

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

Indicadores

Indicador	Descripció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
`--local`	Fuerza el runtime embebido local (omite el Gateway)
`--deliver`	Enví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
`--json`	Emite 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

bash

# Simple turn with JSON outputOmeniaClaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelOmeniaClaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Deliver to a different channel than the sessionOmeniaClaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"