Agent coordination

Agent verzenden

openclaw agent voert één agentbeurt uit vanaf de opdrachtregel zonder een inkomend chatbericht. Gebruik dit voor gescripte workflows, tests en programmatische aflevering. Volledige referentie voor vlaggen en gedrag: Agent-CLI-referentie.

Snel aan de slag

Een eenvoudige agentbeurt uitvoeren

bash

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

Verstuurt het bericht via de Gateway en geeft het antwoord weer.

Een prompt met meerdere regels vanuit een bestand verzenden

bash

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

Leest een geldig UTF-8-bestand als de berichttekst voor de agent.

Een specifieke agent of sessie kiezen

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"

Het antwoord bij een kanaal afleveren

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"

Vlaggen

Vlag	Beschrijving
`--message <text>`	Inlinebericht om te verzenden
`--message-file <path>`	Lees het bericht uit een geldig UTF-8-bestand
`--to <dest>`	Leid de sessiesleutel af van een doel (telefoon, chat-id)
`--session-key <key>`	Gebruik een expliciete sessiesleutel
`--agent <id>`	Kies een geconfigureerde agent (gebruikt diens `main`-sessie)
`--session-id <id>`	Hergebruik een bestaande sessie op basis van id
`--model <id>`	Modeloverschrijving voor deze uitvoering (`provider/model` of model-id)
`--local`	Dwing de lokale ingebedde runtime af (sla Gateway over)
`--deliver`	Verzend het antwoord naar een chatkanaal
`--channel <name>`	Afleverkanaal; met `--agent` + `--to` geldt dit ook voor het DM-bereik
`--reply-to <target>`	Overschrijving van het afleverdoel
`--reply-channel <name>`	Overschrijving van het afleverkanaal
`--reply-account <id>`	Overschrijving van de afleveraccount-id
`--thinking <level>`	Stel het denkniveau in voor het geselecteerde modelprofiel
`--verbose <on\|full\|off>`	Sla het detailniveau voor de sessie op (`full` logt ook tooluitvoer)
`--timeout <seconds>`	Overschrijf de agenttime-out (standaard 600 of de configuratiewaarde)
`--json`	Voer gestructureerde JSON uit

Gedrag

Standaard gaat de CLI via de Gateway. Voeg --local toe om de ingebedde runtime op de huidige machine af te dwingen.
Geef precies één van --message of --message-file door. Bestandsberichten behouden inhoud met meerdere regels nadat een optionele UTF-8-BOM is verwijderd.
Als het Gateway-verzoek mislukt, valt de CLI terug op de lokale ingebedde uitvoering; bij een Gateway-time-out wordt teruggevallen met een nieuwe sessie in plaats van de oorspronkelijke transcriptie gelijktijdig voort te zetten.
Sessieselectie: --to leidt de sessiesleutel af (groeps-/kanaaldoelen behouden isolatie; directe chats worden samengevoegd tot main). Wanneer --agent, --channel en --to samen worden gebruikt, volgt de routering de canonieke ontvanger van het kanaal en session.dmScope. Stabiele identiteiten die alleen voor uitgaande berichten worden gebruikt, gebruiken een sessie die eigendom is van de provider en is geïsoleerd van de hoofdsessie van de agent.
--session-key selecteert een expliciete sleutel. Sleutels met een agentvoorvoegsel moeten agent:<agent-id>:<session-key> gebruiken, en --agent moet overeenkomen met die agent-id wanneer beide zijn opgegeven. Kale sleutels die geen sentinel zijn, worden, indien opgegeven, beperkt tot --agent; --agent ops --session-key incident-42 routeert bijvoorbeeld naar agent:ops:incident-42. Zonder --agent worden kale sleutels die geen sentinel zijn, beperkt tot de geconfigureerde standaardagent. De letterlijke waarden global en unknown blijven alleen buiten een bereik wanneer geen --agent is opgegeven; het ingebedde terugvalpad koppelt deze sentinelsessies aan de geconfigureerde standaardagent.
--reply-channel en --reply-account beïnvloeden alleen de aflevering.
Vlaggen voor denkniveau en detailniveau worden opgeslagen in de sessieopslag.
Uitvoer: standaard platte tekst, of --json voor een gestructureerde payload met metagegevens.
Met --json --deliver bevat de JSON de afleverstatus voor verzonden, onderdrukte, gedeeltelijke en mislukte verzendingen. Zie JSON-afleverstatus.

Voorbeelden

bash

# Simple turn with JSON outputopenclaw agent --to +15555550123 --message "Trace logs" --verbose on --json # Turn with a model overrideopenclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs" # 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"