openclaw agent (ejecuciones directas del agente)
openclaw agent ejecuta un solo turno del agente sin necesitar un mensaje de chat entrante.
Por defecto pasa a través del Gateway; agrega --local para forzar el runtime
embebido en la máquina actual.
Comportamiento
- Requerido:
--message <text> - Selección de sesión:
--to <dest>deriva la clave de sesión (los destinos de grupo/canal preservan el aislamiento; los chats directos se colapsan amain), 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ónmainde ese agente)
- Ejecuta el mismo runtime de agente embebido que las respuestas entrantes normales.
- Los flags de pensamiento/verbose persisten en el almacén de sesión.
- Salida:
- por defecto: imprime el texto de respuesta (más líneas
MEDIA:<url>) --json: imprime la carga útil estructurada + metadatos
- por defecto: imprime el texto de respuesta (más líneas
- Entrega opcional de vuelta a un canal con
--deliver+--channel(los formatos de destino coinciden conopenclaw message --target). - Usa
--reply-channel/--reply-to/--reply-accountpara sobrecargar la entrega sin cambiar la sesión.
Si el Gateway no está accesible, el CLI recurre 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 del proveedor de modelo en tu shell)--deliver: enviar la respuesta al canal elegido--channel: canal de entrega (whatsapp|telegram|discord|googlechat|slack|signal|imessage, por defecto:whatsapp)--reply-to: sobrecarga del destino de entrega--reply-channel: sobrecarga del canal de entrega--reply-account: sobrecarga del id de cuenta de entrega--thinking <off|minimal|low|medium|high|xhigh>: persistir nivel de pensamiento (solo modelos GPT-5.2 + Codex)--verbose <on|full|off>: persistir nivel de verbose--timeout <seconds>: sobrecargar el timeout del agente--json: salida en JSON estructurado