Saltar al contenido principal

​
openclaw agent (ejecuciones directas del agente)

openclaw agent ejecuta un solo turno del agente sin necesitar un mensaje de chat entrante. De forma predeterminada pasa por el Gateway; agregue --local para forzar el runtime integrado 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 consolidan en main), o
    • --session-id <id> reutiliza una sesión existente por id, o
    • --agent <id> apunta directamente a un agente configurado (usa la clave de sesión main de ese agente)
  • Ejecuta el mismo runtime de agente integrado que las respuestas entrantes normales.
  • Los flags de thinking/verbose persisten en el almacén de sesiones.
  • Salida:
    • predeterminado: 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).
  • Use --reply-channel/--reply-to/--reply-account para anular la entrega sin cambiar la sesión.
Si el Gateway no está disponible, la CLI hace fallback a la ejecución local integrada.

​
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"

​
Banderas

  • --local: ejecutar localmente (requiere claves de API del proveedor de modelos en su shell)
  • --deliver: enviar la respuesta al canal elegido
  • --channel: canal de entrega (whatsapp|telegram|discord|googlechat|slack|signal|imessage, predeterminado: whatsapp)
  • --reply-to: anulación del destino de entrega
  • --reply-channel: anulación del canal de entrega
  • --reply-account: anulación del id de la cuenta de entrega
  • --thinking <off|minimal|low|medium|high|xhigh>: persistir el nivel de thinking (solo modelos GPT-5.2 + Codex)
  • --verbose <on|full|off>: persistir el nivel verbose
  • --timeout <seconds>: anular el tiempo de espera del agente
  • --json: salida JSON estructurada