Agent coordination

Invio agente

openclaw agent esegue un singolo turno dell'agente dalla riga di comando senza richiedere un messaggio di chat in ingresso. Usalo per workflow con script, test e consegna programmatica.

Avvio rapido

Esegui un semplice turno dell'agente

bash

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

Questo invia il messaggio tramite il Gateway e stampa la risposta.

Invia un prompt multilinea da un file

bash

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

Questo legge un file UTF-8 valido come corpo del messaggio dell'agente.

Indirizza a un agente o una sessione specifici

bash

# Target a specific agentopenclaw agent --agent ops --message "Summarize logs" # Target a phone number (derives session key)openclaw agent --to +15555550123 --message "Status update" # Reuse an existing sessionopenclaw agent --session-id abc123 --message "Continue the task" # Target an exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

Consegna la risposta a un canale

bash

# Deliver to WhatsApp (default channel)openclaw agent --to +15555550123 --message "Report ready" --deliver # Deliver to Slackopenclaw agent --agent ops --message "Generate report" \  --deliver --reply-channel slack --reply-to "#reports"

Opzioni

Opzione	Descrizione
`--message \<text\>`	Messaggio inline da inviare
`--message-file \<path\>`	Legge il messaggio da un file UTF-8 valido
`--to \<dest\>`	Deriva la chiave di sessione da una destinazione (telefono, id chat)
`--session-key \<key\>`	Usa una chiave di sessione esplicita
`--agent \<id\>`	Indirizza a un agente configurato (usa la sua sessione `main`)
`--session-id \<id\>`	Riutilizza una sessione esistente tramite id
`--local`	Forza il runtime incorporato locale (salta il Gateway)
`--deliver`	Invia la risposta a un canale di chat
`--channel \<name\>`	Canale di consegna (whatsapp, telegram, discord, slack, ecc.)
`--reply-to \<target\>`	Override della destinazione di consegna
`--reply-channel \<name\>`	Override del canale di consegna
`--reply-account \<id\>`	Override dell'id dell'account di consegna
`--thinking \<level\>`	Imposta il livello di ragionamento per il profilo modello selezionato
`--verbose \<on\|full\|off\>`	Imposta il livello di verbosità
`--timeout \<seconds\>`	Esegue l'override del timeout dell'agente
`--json`	Produce JSON strutturato

Comportamento

Per impostazione predefinita, la CLI passa tramite il Gateway. Aggiungi --local per forzare il runtime incorporato sulla macchina corrente.
Passa esattamente uno tra --message e --message-file. I messaggi da file preservano il contenuto multilinea dopo la rimozione di un BOM UTF-8 opzionale.
Se il Gateway non è raggiungibile, la CLI ripiega sull'esecuzione incorporata locale.
Selezione della sessione: --to deriva la chiave di sessione (le destinazioni gruppo/canale preservano l'isolamento; le chat dirette convergono su main).
--session-key seleziona una chiave esplicita. Le chiavi con prefisso agente devono usare agent:<agent-id>:<session-key> e --agent deve corrispondere a quell'id agente quando entrambi sono forniti. Le chiavi bare non sentinel vengono collocate nell'ambito di --agent quando fornito; per esempio, --agent ops --session-key incident-42 instrada a agent:ops:incident-42. Senza --agent, le chiavi bare non sentinel vengono collocate nell'ambito dell'agente predefinito configurato. I letterali global e unknown restano senza ambito solo quando non viene fornito --agent; in quel caso, il fallback incorporato e la proprietà dello store usano l'agente predefinito configurato.
Le opzioni di ragionamento e verbosità persistono nello store della sessione.
Output: testo semplice per impostazione predefinita, oppure --json per payload + metadati strutturati.
Con --json --deliver, il JSON include lo stato di consegna per invii inviati, soppressi, parziali e non riusciti. Vedi stato di consegna JSON.

Esempi

bash

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with thinking levelopenclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium # Multiline prompt from a fileopenclaw agent --agent ops --message-file ./task.md # Exact session keyopenclaw agent --session-key agent:ops:incident-42 --message "Summarize status" # Legacy key scoped to an agentopenclaw agent --agent ops --session-key incident-42 --message "Summarize status" # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"