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 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.
  • 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
  • Entrega opcional de vuelta a un canal con --deliver + --channel (los formatos de destino coinciden con openclaw message --target).
  • Usa --reply-channel/--reply-to/--reply-account para 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