Beschikbare tools
| Tool | Wat het doet |
|---|---|
sessions_list | Sessies weergeven met optionele filters (soort, label, agent, archief, voorbeeldweergave) |
sessions_history | Het transcript van een specifieke sessie lezen |
sessions_send | Een bericht naar een andere sessie sturen en optioneel wachten |
sessions_spawn | Een geïsoleerde subagentsessie starten voor achtergrondwerk |
sessions_yield | De huidige beurt beëindigen en wachten op vervolgresulaten van subagents |
subagents | De status van gestarte subagents voor deze sessie weergeven |
session_status | Een /status-achtige kaart tonen en optioneel een modelspecifieke overschrijving per sessie instellen |
tools.profile: "coding" bevat de volledige set voor sessieorkestratie,
inclusief sessions_spawn, sessions_yield en subagents.
tools.profile: "messaging" bevat messagingtools tussen sessies
(sessions_list, sessions_history, sessions_send, session_status), maar
bevat geen starten van subagents. Voeg het volgende toe om een messagingprofiel
te behouden en toch native delegatie toe te staan:
/tools vanuit de betreffende
sessie om de effectieve toollijst te inspecteren.
Sessies weergeven en lezen
sessions_list retourneert sessies met hun sleutel, agentId, soort, kanaal, model,
tokentellingen en tijdstempels. Filter op soort (main, group, cron, hook,
node), exact label, exact agentId, zoektekst of recentheid
(activeMinutes). Actieve sessies worden standaard geretourneerd; geef
archived: true mee om gearchiveerde sessies te inspecteren. Rijen bevatten hun
vastgezette en gearchiveerde status. Wanneer je triage in mailboxstijl nodig hebt,
kan de tool ook vragen om een van zichtbaarheid afgeleide titel, een
voorbeeldfragment van het laatste bericht of begrensde recente berichten op elke rij.
Afgeleide titels en voorbeeldweergaven worden alleen geproduceerd voor sessies die
de aanroeper al mag zien onder het geconfigureerde zichtbaarheidsbeleid voor
sessietools, zodat niet-gerelateerde sessies verborgen blijven. Wanneer zichtbaarheid
beperkt is, retourneert sessions_list optionele visibility-metadata die de
effectieve modus tonen en een waarschuwing dat resultaten mogelijk in bereik beperkt zijn.
sessions_history haalt het gesprekstranscript op voor een specifieke sessie.
Standaard worden toolresultaten uitgesloten — geef includeTools: true mee om ze
te zien. Gebruik limit voor de nieuwste begrensde staart. Geef offset: 0 mee
wanneer je pagineringsmetadata nodig hebt, en geef daarna de geretourneerde
nextOffset-waarden mee om achteruit te bladeren door oudere
OpenClaw-transcriptvensters zonder ruwe transcriptbestanden te lezen.
Expliciete offsetpagina’s voegen geen externe CLI-fallbackimports samen; gebruik
de standaardweergave met nieuwste staart wanneer je die samengevoegde
weergavegeschiedenis nodig hebt.
De geretourneerde weergave is bewust begrensd en veiligheidsgefilterd:
- assistenttekst wordt genormaliseerd vóór herinnering:
- denktags worden verwijderd
<relevant-memories>- /<relevant_memories>-steigerblokken worden verwijderd- XML-payloadblokken voor toolaanroepen in platte tekst, zoals
<tool_call>...</tool_call>,<function_call>...</function_call>,<tool_calls>...</tool_calls>en<function_calls>...</function_calls>, worden verwijderd, inclusief afgebroken payloads die nooit netjes sluiten - gedegradeerde steigertekst voor toolaanroepen/-resultaten zoals
[Tool Call: ...],[Tool Result ...]en[Historical context ...]wordt verwijderd - gelekte modelcontroletokens zoals
<|assistant|>, andere ASCII-<|...|>-tokens en full-width<｜...｜>-varianten worden verwijderd - misvormde MiniMax-toolaanroep-XML zoals
<invoke ...>/</minimax:tool_call>wordt verwijderd
- credential-/tokenachtige tekst wordt geredigeerd voordat die wordt geretourneerd
- lange tekstblokken worden afgekapt
- zeer grote geschiedenissen kunnen oudere rijen laten vallen of een te grote rij vervangen door
[sessions_history omitted: message too large] - de tool rapporteert samenvattingsvlaggen zoals
truncated,droppedMessages,contentTruncated,contentRedacted,bytesen pagineringsmetadata
"main") of een sessie-ID
uit een eerdere lijstaanroep.
Als je het exacte byte-voor-byte transcript nodig hebt, inspecteer dan het
transcriptbestand op schijf in plaats van sessions_history als ruwe dump te behandelen.
Berichten tussen sessies verzenden
sessions_send levert een bericht af bij een andere sessie en wacht optioneel op
het antwoord:
- Verzenden zonder te wachten: stel
timeoutSeconds: 0in om in de wachtrij te plaatsen en onmiddellijk terug te keren. - Wachten op antwoord: stel een time-out in en ontvang het antwoord inline.
:thread:<id>, zijn geen geldige sessions_send-doelen. Gebruik de sessiesleutel
van het bovenliggende kanaal voor coördinatie tussen agents, zodat via tools gerouteerde
berichten niet verschijnen binnen een actieve mensgerichte thread.
Berichten en A2A-vervolgantwoorden worden gemarkeerd als gegevens tussen sessies in de
ontvangende prompt ([Inter-session message ... isUser=false]) en in de
transcriptherkomst. De ontvangende agent moet ze behandelen als via tools gerouteerde
gegevens, niet als een directe instructie die door een eindgebruiker is geschreven.
Nadat het doel antwoordt, kan OpenClaw een antwoord-terug-lus uitvoeren waarbij de
agents afwisselend berichten sturen (tot session.agentToAgent.maxPingPongTurns, bereik
0-20, standaard 5). De doelagent kan antwoorden met
REPLY_SKIP om vroegtijdig te stoppen.
Status- en orkestratiehelpers
session_status is de lichte /status-equivalente tool voor de huidige of een
andere zichtbare sessie. De tool rapporteert gebruik, tijd, model-/runtimestatus en
gekoppelde achtergrondtaakcontext wanneer aanwezig. Net als /status kan de tool
schaarse token-/cachetellers aanvullen vanuit de nieuwste transcriptgebruiksvermelding, en
model=default wist een overschrijving per sessie. Gebruik sessionKey="current" voor
de huidige sessie van de aanroeper; zichtbare clientlabels zoals openclaw-tui zijn
geen sessiesleutels.
Wanneer routemetadata beschikbaar zijn, bevat session_status ook een zichtbaar
Route context-JSON-blok en overeenkomende gestructureerde details-velden. Deze
velden onderscheiden de sessiesleutel van de route die momenteel de live uitvoering
afhandelt:
originis waar de sessie is gemaakt, of de provider die is afgeleid uit een afleverbare sessiesleutelprefix wanneer oudere status geen opgeslagen oorsprongsmetadata heeft.activeis de huidige live-uitvoeringsroute. Dit wordt alleen gerapporteerd voor de live of huidige sessie die nu wordt afgehandeld.deliveryContextis de persistente afleverroute die op de sessie is opgeslagen, die OpenClaw opnieuw kan gebruiken voor latere aflevering, zelfs wanneer het actieve oppervlak verschilt.
sessions_yield beëindigt bewust de huidige beurt zodat het volgende bericht de
vervolggebeurtenis kan zijn waarop je wacht. Gebruik dit na het starten van subagents
wanneer je wilt dat voltooiingsresultaten als het volgende bericht binnenkomen in plaats van
poll-lussen te bouwen.
subagents is de zichtbaarheidshelper voor al gestarte OpenClaw-
subagents. De tool ondersteunt action: "list" om actieve/recente uitvoeringen te inspecteren.
Subagents starten
sessions_spawn maakt standaard een geïsoleerde sessie voor een achtergrondtaak.
De tool is altijd niet-blokkerend — hij retourneert onmiddellijk met een runId en
childSessionKey. Native subagentuitvoeringen ontvangen de gedelegeerde taak in het
eerste zichtbare [Subagent Task]-bericht van de kindsessie, terwijl de systeemprompt
alleen runtime-regels voor subagents en routeringscontext bevat.
Belangrijke opties:
runtime: "subagent"(standaard) of"acp"voor externe harnessagents.model- enthinking-overschrijvingen voor de kindsessie.thread: trueom de spawn aan een chatthread te binden (Discord, Slack, enz.).sandbox: "require"om sandboxing op het kind af te dwingen.context: "fork"voor native subagents wanneer het kind het huidige aanvragerstranscript nodig heeft; laat dit weg of gebruikcontext: "isolated"voor een schoon kind. Threadgebonden native subagents gebruiken standaardcontext: "fork", tenzijthreadBindings.defaultSpawnContextanders aangeeft.
maxSpawnDepth >= 2, ontvangen depth-1-orkestrator-subagents daarnaast
sessions_spawn, subagents, sessions_list en sessions_history, zodat ze
hun eigen kinderen kunnen beheren. Leaf-uitvoeringen krijgen nog steeds geen recursieve
orkestratietools.
Na voltooiing plaatst een aankondigingsstap het resultaat in het kanaal van de aanvrager.
Voltooiingsaflevering behoudt gebonden thread-/topicroutering wanneer beschikbaar, en als
de voltooiingsoorsprong alleen een kanaal identificeert, kan OpenClaw nog steeds de
opgeslagen route van de aanvragersessie (lastChannel / lastTo) opnieuw gebruiken voor directe
aflevering.
Zie ACP Agents voor ACP-specifiek gedrag.
Zichtbaarheid
Sessietools zijn begrensd om te beperken wat de agent kan zien:| Niveau | Bereik |
|---|---|
self | Alleen de huidige sessie |
tree | Huidige sessie + gestarte subagents |
agent | Alle sessies voor deze agent |
all | Alle sessies (over agents heen indien geconfigureerd) |
tree. Gesandboxte sessies worden beperkt tot tree, ongeacht de
configuratie.
Verder lezen
- Sessiebeheer — routering, levenscyclus, onderhoud
- ACP Agents — externe harness-start
- Multi-agent — multi-agentarchitectuur
- Gateway-configuratie — configuratieknoppen voor sessietools