Envío de Agente
Ejecuciones directas de CLI `openclaw agent` (con entrega opcional)
''openclaw agent'' ejecuta un turno único de agente sin necesitar un mensaje de chat entrante.
Por defecto va ''a través del Gateway''; agrega ''--local'' para forzar el runtime
embebido en la máquina actual.
Comportamiento
- Requerido: ''--message <texto>''
- Selección de sesión:
- ''--to <dest>'' deriva la clave de sesión (objetos grupo/canal preservan aislamiento; chats directos colapsan a ''main''), ''o''
- ''--session-id <id>'' reutiliza una sesión existente por id, ''o''
- ''--agent <id>'' apunta a un agente configurado directamente (usa la clave de sesión ''main'' de ese agente)
- Ejecuta el mismo runtime de agente embebido que las respuestas entrantes normales.
- Flags de thinking/verbose persisten en el almacén de sesiones.
- Salida:
- predeterminado: imprime texto de respuesta (más líneas ''MEDIA:<url>'')
- ''--json'': imprime payload estructurado + metadatos
- Entrega opcional de vuelta a un canal con ''--deliver'' + ''--channel'' (formatos de objetivo coinciden con ''openclaw message --target'').
- Usa ''--reply-channel''/''--reply-to''/''--reply-account'' para sobrescribir entrega sin cambiar la sesión.
Si el Gateway es inalcanzable, el CLI retrocede a la ejecución local embebida.
Ejemplos
openclaw agent --to +15555550123 --message "status update" openclaw agent --agent ops --message "Summarize logs" openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json openclaw agent --to +15555550123 --message "Summon reply" --deliver openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
Flags
- ''--local'': ejecutar localmente (requiere claves API de proveedor de modelo en tu shell)
- ''--deliver'': enviar la respuesta al canal elegido
- ''--channel'': canal de entrega (''whatsapp|telegram|discord|googlechat|slack|signal|imessage'', predeterminado: ''whatsapp'')
- ''--reply-to'': sobrescribir objetivo de entrega
- ''--reply-channel'': sobrescribir canal de entrega
- ''--reply-account'': sobrescribir id de cuenta de entrega
- ''--thinking <off|minimal|low|medium|high|xhigh>'': persistir nivel de thinking (solo modelos GPT-5.2 + Codex)
- ''--verbose <on|full|off>'': persistir nivel de verbose
- ''--timeout <segundos>'': sobrescribir timeout de agente
- ''--json'': salida JSON estructurada