English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Agent coordination

Invio dell'agente

Edit source

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

  • Run a simple agent turn

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

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

  • Target a specific agent or session

    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"

  • Deliver the reply to a channel

    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"

    • Flag

    Flag Descrizione
    --message \<text\> Messaggio da inviare (obbligatorio)
    --to \<dest\> Deriva la chiave di sessione da una destinazione (telefono, id chat)
    --agent \<id\> Indirizza 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 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\> Override del timeout dell'agente
    --json Restituisce JSON strutturato

    Comportamento

    • Per impostazione predefinita, la CLI passa tramite il Gateway. Aggiungi --local per forzare il runtime incorporato sulla macchina corrente.
    • Se il Gateway non è raggiungibile, la CLI ripiega sull'esecuzione incorporata locale.
    • Selezione della sessione: --to deriva la chiave di sessione (i target di gruppo/canale preservano l'isolamento; le chat dirette convergono su main).
    • I flag di ragionamento e verbosità persistono nello store delle sessioni.
    • Output: testo normale per impostazione predefinita, oppure --json per payload + metadati strutturati.
    • Con --json --deliver, il JSON include lo stato di consegna per invii riusciti, 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 # Deliver to a different channel than the sessionopenclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

    Correlati

    Agent CLI reference

    Riferimento completo per flag e opzioni di openclaw agent.
    Sub-agents

    Avvio di sotto-agenti in background.
    Sessions

    Come funzionano le chiavi di sessione e come --to, --agent e --session-id le risolvono.
    Slash commands

    Catalogo dei comandi nativi usati nelle sessioni degli agenti.
    Was this useful?