Agent coordination
Invio dell’agente
openclaw agent esegue un singolo turno agente dalla riga di comando senza bisogno
di un messaggio di chat in ingresso. Usalo per workflow con script, test e
consegna programmatica.
Avvio rapido
Esegui un semplice turno agente
openclaw agent --message "What is the weather today?"
Questo invia il messaggio tramite il Gateway e stampa la risposta.
Indirizza a un agente o a una sessione specifica
# 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"
Consegna la risposta a un canale
# 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
| Flag | Descrizione |
|---|---|
--message \<text\> |
Messaggio da inviare (obbligatorio) |
--to \<dest\> |
Deriva la chiave di sessione da una destinazione (telefono, chat id) |
--agent \<id\> |
Indirizza a un agente configurato (usa la sua sessione main) |
--session-id \<id\> |
Riutilizza una sessione esistente per 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 verbose |
--timeout \<seconds\> |
Override del timeout dell'agente |
--json |
Restituisce JSON strutturato |
Comportamento
- Per impostazione predefinita, la CLI passa tramite il Gateway. Aggiungi
--localper forzare il runtime incorporato sulla macchina corrente. - Se il Gateway non è raggiungibile, la CLI ripiega sull'esecuzione incorporata locale.
- Selezione della sessione:
--toderiva la chiave di sessione (i target di gruppo/canale preservano l'isolamento; le chat dirette convergono sumain). - I flag thinking e verbose persistono nell'archivio delle sessioni.
- Output: testo semplice per impostazione predefinita, oppure
--jsonper payload strutturato + metadati.
Esempi
# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"