Skip to main content
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

Verstuurt het bericht via de Gateway en drukt het antwoord af.
2

Een prompt met meerdere regels vanuit een bestand versturen

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

Een specifieke agent of sessie kiezen

4

Het antwoord aan een kanaal leveren

Vlaggen

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. 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: --to leidt de sessiesleutel af (doelen voor groepen/kanalen behouden isolatie; directe chats worden samengevoegd tot main). Met --agent, --channel en --to samen volgt de routering de canonieke ontvanger en session.dmScope van 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-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 worden opgegeven. Kale sleutels die geen sentinel zijn, worden beperkt tot --agent wanneer die wordt opgegeven; --agent ops --session-key incident-42 wordt bijvoorbeeld gerouteerd naar agent:ops:incident-42. Zonder --agent worden kale sleutels die geen sentinel zijn, beperkt tot de geconfigureerde standaardagent. Letterlijke global en unknown blijven alleen onbeperkt wanneer geen --agent wordt opgegeven.
  • --reply-channel en --reply-account zijn alleen van invloed op de levering.
  • Vlaggen voor denken en uitgebreidheid worden in de sessieopslag bewaard.
  • Uitvoer: standaard platte tekst, of --json voor een gestructureerde payload + metagegevens.
  • Met --json --deliver bevat 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.