openclaw agent voert één agentbeurt uit vanaf de opdrachtregel zonder een
inkomend chatbericht. Gebruik dit voor gescripte workflows, tests en
programmatische levering. Volledige naslag voor vlaggen en gedrag:
Agent-CLI-naslag.
Snel aan de slag
1
Een eenvoudige agentbeurt uitvoeren
2
Een prompt met meerdere regels vanuit een bestand versturen
3
Een specifieke agent of sessie kiezen
4
Het antwoord aan een kanaal leveren
Vlaggen
Gedrag
- Standaard gaat de CLI via de Gateway. Voeg
--localtoe om de ingebedde runtime op de huidige machine af te dwingen. - Geef precies één van
--messageof--message-filedoor. Bestandsberichten behouden inhoud met meerdere regels nadat een optionele UTF-8-BOM is verwijderd. Bestanden groter dan 4 MiB worden vóór verzending geweigerd. - Na tijdelijke nieuwe verbindingspogingen tijdens de handshake zorgt een Gateway-time-out of gesloten verbinding
ervoor dat de opdracht mislukt met een aanwijzing op stderr; de CLI voert de beurt nooit stilzwijgend opnieuw
ingebed uit. De Gateway kan een geaccepteerde beurt nog steeds voltooien, dus controleer de status van de Gateway
en sessie voordat je het opnieuw probeert of opnieuw uitvoert met
--local. - Sessieselectie:
--toleidt de sessiesleutel af (doelen voor groepen/kanalen behouden isolatie; directe chats worden samengevoegd totmain). Met--agent,--channelen--tosamen volgt de routering de canonieke ontvanger ensession.dmScopevan het kanaal. Stabiele identiteiten die alleen voor uitgaand verkeer worden gebruikt, gebruiken een sessie die eigendom is van de provider en is geïsoleerd van de hoofdsessie van de agent. --session-keyselecteert een expliciete sleutel. Sleutels met een agentvoorvoegsel moetenagent:<agent-id>:<session-key>gebruiken, en--agentmoet overeenkomen met die agent-id wanneer beide worden opgegeven. Kale sleutels die geen sentinel zijn, worden beperkt tot--agentwanneer die wordt opgegeven;--agent ops --session-key incident-42wordt bijvoorbeeld gerouteerd naaragent:ops:incident-42. Zonder--agentworden kale sleutels die geen sentinel zijn, beperkt tot de geconfigureerde standaardagent. Letterlijkeglobalenunknownblijven alleen onbeperkt wanneer geen--agentwordt opgegeven.--reply-channelen--reply-accountzijn alleen van invloed op de levering.- Vlaggen voor denken en uitgebreidheid worden in de sessieopslag bewaard.
- Uitvoer: standaard platte tekst, of
--jsonvoor een gestructureerde payload + metagegevens. - Met
--json --deliverbevat de JSON de leveringsstatus voor verzonden, onderdrukte, gedeeltelijke en mislukte verzendingen. Zie JSON-leveringsstatus.
Voorbeelden
Gerelateerd
Agent-CLI-naslag
Volledige naslag voor vlaggen en opties van
openclaw agent.Subagents
Subagents op de achtergrond starten.
Sessies
Hoe sessiesleutels werken en hoe
--to, --agent en --session-id ze omzetten.Slash-opdrachten
Systeemeigen opdrachtencatalogus die binnen agentsessies wordt gebruikt.