​

Session Tools

OpenClaw stellt Agenten Tools zur Verfügung, um sitzungsübergreifend zu arbeiten, den Status zu prüfen und Sub-Agents zu orchestrieren.

​

Verfügbare Tools

​

Sitzungen auflisten und lesen

sessions_list gibt Sitzungen mit ihrem Schlüssel, ihrer Art, ihrem Kanal, Modell, Token- Zählwerten und Zeitstempeln zurück. Filtern Sie nach Art (main, group, cron, hook, node) oder Aktualität (activeMinutes). sessions_history ruft das Konversationstranskript für eine bestimmte Sitzung ab. Standardmäßig sind Tool-Ergebnisse ausgeschlossen — übergeben Sie includeTools: true, um sie zu sehen. Die zurückgegebene Ansicht ist absichtlich begrenzt und sicherheitsgefiltert:

• Assistant-Text wird vor dem Recall normalisiert:
  • Thinking-Tags werden entfernt
  • Gerüstblöcke <relevant-memories> / <relevant_memories> werden entfernt
  • XML-Nutzlastblöcke von Tool-Aufrufen im Klartext wie <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls> und <function_calls>...</function_calls> werden entfernt, einschließlich abgeschnittener Nutzlasten, die nie sauber geschlossen werden
  • herabgestuftes Tool-Call-/Result-Gerüst wie [Tool Call: ...], [Tool Result ...] und [Historical context ...] wird entfernt
  • durchgesickerte Modell-Kontrolltokens wie <|assistant|>, andere ASCII- <|...|>-Tokens und Varianten mit voller Breite <｜...｜> werden entfernt
  • fehlerhaftes MiniMax-Tool-Call-XML wie <invoke ...> / </minimax:tool_call> wird entfernt
• Anmeldedaten-/tokenähnlicher Text wird vor der Rückgabe geschwärzt
• lange Textblöcke werden abgeschnitten
• sehr große Verläufe können ältere Zeilen verwerfen oder eine übergroße Zeile durch [sessions_history omitted: message too large] ersetzen
• das Tool meldet Zusammenfassungs-Flags wie truncated, droppedMessages, contentTruncated, contentRedacted und bytes

Beide Tools akzeptieren entweder einen Sitzungsschlüssel (wie "main") oder eine Sitzungs-ID aus einem vorherigen Listenaufruf. Wenn Sie das exakte bytegenaue Transkript benötigen, prüfen Sie stattdessen die Transkriptdatei auf der Festplatte, statt sessions_history als Rohdump zu behandeln.

​

Sitzungsübergreifende Nachrichten senden

sessions_send stellt eine Nachricht an eine andere Sitzung zu und wartet optional auf die Antwort:

• Fire-and-forget: Setzen Sie timeoutSeconds: 0, um die Nachricht in die Warteschlange zu stellen und sofort zurückzukehren.
• Auf Antwort warten: Setzen Sie ein Timeout und erhalten Sie die Antwort inline.

Nachdem das Ziel geantwortet hat, kann OpenClaw eine Reply-back-Schleife ausführen, bei der die Agenten abwechselnd Nachrichten austauschen (bis zu 5 Durchläufe). Der Ziel-Agent kann REPLY_SKIP antworten, um frühzeitig zu stoppen.

​

Status- und Orchestrierungshelfer

session_status ist das leichtgewichtige Äquivalent zu /status für die aktuelle oder eine andere sichtbare Sitzung. Es meldet Nutzung, Zeit, Modell-/Laufzeitstatus und verknüpften Hintergrundaufgabenkontext, wenn vorhanden. Wie /status kann es spärliche Token-/Cache-Zähler aus dem neuesten Nutzungseintrag des Transkripts nachfüllen, und model=default entfernt eine Überschreibung pro Sitzung. sessions_yield beendet absichtlich den aktuellen Durchlauf, sodass die nächste Nachricht das Follow-up-Ereignis sein kann, auf das Sie warten. Verwenden Sie es nach dem Starten von Sub-Agents, wenn Sie möchten, dass Abschlussresultate als nächste Nachricht eintreffen, statt Polling-Schleifen zu bauen. subagents ist der Control-Plane-Helfer für bereits gestartete OpenClaw- Sub-Agents. Unterstützt werden:

• action: "list" zum Prüfen aktiver/kürzlich ausgeführter Läufe
• action: "steer" zum Senden weiterer Anweisungen an ein laufendes Kind
• action: "kill" zum Stoppen eines Kindes oder all

​

Sub-Agents starten

sessions_spawn erstellt eine isolierte Sitzung für eine Hintergrundaufgabe. Es ist immer nicht blockierend — es gibt sofort mit einer runId und childSessionKey zurück. Wichtige Optionen:

• runtime: "subagent" (Standard) oder "acp" für Agents mit externer Harness.
• Überschreibungen von model und thinking für die untergeordnete Sitzung.
• thread: true, um den Start an einen Chat-Thread zu binden (Discord, Slack usw.).
• sandbox: "require", um Sandboxing für das Kind zu erzwingen.

Standardmäßige Leaf-Sub-Agents erhalten keine Session Tools. Wenn maxSpawnDepth >= 2, erhalten Orchestrator-Sub-Agents auf Tiefe 1 zusätzlich sessions_spawn, subagents, sessions_list und sessions_history, damit sie ihre eigenen Kinder verwalten können. Leaf-Läufe erhalten weiterhin keine rekursiven Orchestrierungs-Tools. Nach Abschluss veröffentlicht ein Ankündigungsschritt das Ergebnis im Kanal des Anfragenden. Die Abschlusszustellung bewahrt gebundenes Thread-/Topic-Routing, wenn verfügbar, und wenn der Abschlussursprung nur einen Kanal identifiziert, kann OpenClaw für die direkte Zustellung trotzdem die gespeicherte Route der anfragenden Sitzung (lastChannel / lastTo) wiederverwenden. Für ACP-spezifisches Verhalten siehe ACP Agents.

​

Sichtbarkeit

Session Tools sind so begrenzt, dass eingeschränkt wird, was der Agent sehen kann: Standard ist tree. Sitzungen in einer Sandbox werden unabhängig von der Konfiguration auf tree begrenzt.

​

Weiterführende Informationen

• Session Management — Routing, Lebenszyklus, Wartung
• ACP Agents — Starten mit externer Harness
• Multi-agent — Multi-Agent-Architektur
• Gateway Configuration — Konfigurationsoptionen für Session Tools