Invio dell’agente

​

Avvio rapido

openclaw agent --agent main --message "What is the weather today?"

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

# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"

# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"

# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"

# Target an exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver

# Deliver to Slack
openclaw agent --agent ops --message "Generate report" \
  --deliver --reply-channel slack --reply-to "#reports"

​

Flag

​

Comportamento

• Per impostazione predefinita, la CLI passa attraverso il Gateway. Aggiungi --local per forzare il runtime incorporato sulla macchina corrente.
• Passa esattamente uno tra --message e --message-file. I messaggi da file conservano il contenuto su più righe dopo la rimozione di un BOM UTF-8 facoltativo.
• Se la richiesta al Gateway non riesce, la CLI ripiega sull’esecuzione incorporata locale; in caso di timeout del Gateway, ripiega usando una nuova sessione anziché eseguire in parallelo con la trascrizione originale.
• Selezione della sessione: --to deriva la chiave di sessione (le destinazioni di gruppo/canale mantengono l’isolamento; le chat dirette confluiscono in main). Quando --agent, --channel e --to sono usati insieme, l’instradamento segue il destinatario canonico del canale e session.dmScope. Le identità stabili utilizzate solo per l’invio usano una sessione gestita dal provider, isolata dalla sessione principale dell’agente.
• --session-key seleziona una chiave esplicita. Le chiavi con prefisso dell’agente devono usare agent:<agent-id>:<session-key> e, quando sono specificati entrambi, --agent deve corrispondere a tale ID agente. Le chiavi semplici che non sono sentinelle vengono associate a --agent, se specificato; ad esempio, --agent ops --session-key incident-42 viene instradato a agent:ops:incident-42. Senza --agent, le chiavi semplici che non sono sentinelle vengono associate all’agente predefinito configurato. I valori letterali global e unknown rimangono senza ambito solo quando --agent non è specificato; il percorso di ripiego incorporato risolve tali sessioni sentinella nell’agente predefinito configurato.
• --reply-channel e --reply-account influiscono solo sulla consegna.
• I flag di ragionamento e verbosità vengono mantenuti nell’archivio della sessione.
• Output: testo normale per impostazione predefinita oppure --json per payload strutturato e metadati.
• Con --json --deliver, il JSON include lo stato di consegna per gli invii effettuati, soppressi, parziali e non riusciti. Consulta Stato di consegna JSON.

​

Esempi

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with a model override
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Multiline prompt from a file
openclaw agent --agent ops --message-file ./task.md

# Exact session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# Legacy key scoped to an agent
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​

Argomenti correlati