Envío del agente

​

Inicio rápido

openclaw agent --agent main --message "¿Qué tiempo hace hoy?"

openclaw agent --agent ops --message-file ./task.md

# Seleccionar un agente específico
openclaw agent --agent ops --message "Resume los registros"

# Seleccionar un número de teléfono (deriva la clave de sesión)
openclaw agent --to +15555550123 --message "Actualización de estado"

# Reutilizar una sesión existente
openclaw agent --session-id abc123 --message "Continúa la tarea"

# Seleccionar una clave de sesión exacta
openclaw agent --session-key agent:ops:incident-42 --message "Resume el estado"

# Entregar a WhatsApp (canal predeterminado)
openclaw agent --to +15555550123 --message "Informe listo" --deliver

# Entregar a Slack
openclaw agent --agent ops --message "Genera un informe" \
  --deliver --reply-channel slack --reply-to "#reports"

​

Indicadores

​

Comportamiento

• De forma predeterminada, la CLI funciona a través del Gateway. Añada --local para forzar el entorno de ejecución integrado en la máquina actual.
• Proporcione exactamente uno de --message o --message-file. Los mensajes de archivo conservan el contenido multilínea después de eliminar una marca BOM UTF-8 opcional. Los archivos de más de 4 MiB se rechazan antes del envío.
• Tras reintentos transitorios del protocolo de enlace, un tiempo de espera agotado del Gateway o una conexión cerrada hacen que el comando falle con una indicación en stderr; la CLI nunca vuelve a ejecutar silenciosamente el turno de forma integrada. Es posible que el Gateway finalice aun así un turno aceptado, por lo que se deben verificar el Gateway y el estado de la sesión antes de volver a intentarlo o ejecutarlo con --local.
• Selección de sesión: --to deriva la clave de sesión (los destinos de grupo o canal mantienen el aislamiento; los chats directos se agrupan en main). Cuando se usan conjuntamente --agent, --channel y --to, el enrutamiento sigue el destinatario canónico y session.dmScope del canal. Las identidades estables exclusivamente de salida usan una sesión propiedad del proveedor aislada de la sesión principal del agente.
• --session-key selecciona una clave explícita. Las claves con prefijo de agente deben usar agent:<agent-id>:<session-key>, y --agent debe coincidir con ese id de agente cuando se proporcionan ambos. Las claves simples que no sean centinelas se limitan al ámbito de --agent cuando se proporciona; por ejemplo, --agent ops --session-key incident-42 se dirige a agent:ops:incident-42. Sin --agent, las claves simples que no sean centinelas se limitan al ámbito del agente predeterminado configurado. Los valores literales global y unknown permanecen sin ámbito solo cuando no se proporciona --agent.
• --reply-channel y --reply-account solo afectan a la entrega.
• Los indicadores de razonamiento y nivel de detalle se conservan en el almacén de sesiones.
• Salida: texto sin formato de manera predeterminada, o --json para obtener una carga estructurada y metadatos.
• Con --json --deliver, el JSON incluye el estado de entrega de los envíos realizados, suprimidos, parciales y fallidos. Consulte Estado de entrega JSON.

​

Ejemplos

# Turno sencillo con salida JSON
openclaw agent --to +15555550123 --message "Rastrea los registros" --verbose on --json

# Turno con sustitución del modelo
openclaw agent --agent ops --model openai/gpt-5.4 --message "Resume los registros"

# Turno con nivel de razonamiento
openclaw agent --session-id 1234 --message "Resume la bandeja de entrada" --thinking medium

# Instrucción multilínea desde un archivo
openclaw agent --agent ops --message-file ./task.md

# Clave de sesión exacta
openclaw agent --session-key agent:ops:incident-42 --message "Resume el estado"

# Clave heredada limitada al ámbito de un agente
openclaw agent --agent ops --session-key incident-42 --message "Resume el estado"

# Entregar a un canal distinto del de la sesión
openclaw agent --agent ops --message "Alerta" --deliver --reply-channel telegram --reply-to "@admin"

​

Temas relacionados