OpenClaw Session Tools: Sitzungen verwalten und steuern

Kennst du das Problem? Du arbeitest mit mehreren Agents gleichzeitig und verlierst völlig den Überblick, wer gerade was macht. Es ist oft frustrierend, wenn Informationen in einer Session feststecken und du sie manuell in eine andere kopieren musst, anstatt dass die Agents einfach direkt miteinander kommunizieren.

OpenClaw löst das mit Session Tools. Damit können deine Agents sessionübergreifend arbeiten – sie können Konversationen auflisten, die History lesen, Nachrichten an andere Sessions schicken oder Sub-Agents für Aufgaben im Hintergrund erstellen.

Verfügbare Tools

Tool	Funktion
sessions_list	Listet Sessions mit optionalen Filtern auf (kind, recency)
sessions_history	Liest das Transkript einer bestimmten Session
sessions_send	Sendet eine Nachricht an eine andere Session und wartet optional
sessions_spawn	Erstellt eine isolierte Sub-Agent-Session für Hintergrundarbeit

Sessions auflisten und lesen

sessions_list gibt dir Sessions mit ihrem key, kind, channel, model, den token counts und Timestamps zurück. Du kannst nach kind (main, group, cron, hook, node) oder nach Aktualität (activeMinutes) filtern.

sessions_history holt das Transkript einer Konversation für eine bestimmte Session. Standardmäßig sind Tool-Ergebnisse ausgeschlossen – setze includeTools: true, um sie zu sehen.

Beide Tools akzeptieren entweder einen session key (wie "main") oder eine session ID aus einem vorherigen Listenaufruf.

Nachrichten zwischen Sessions senden

sessions_send liefert eine Nachricht an eine andere Session aus und wartet optional auf die Antwort:

• Fire-and-forget: Setze timeoutSeconds: 0, um die Nachricht in die Warteschlange zu stellen und sofort fortzufahren.
• Auf Antwort warten: Setze ein Timeout und erhalte die Antwort direkt im Flow.

Sobald das Ziel antwortet, kann OpenClaw einen reply-back loop starten. Dabei tauschen die Agents abwechselnd Nachrichten aus (bis zu 5 Runden). Der Ziel-Agent kann REPLY_SKIP senden, um den Prozess vorzeitig zu beenden.

Sub-Agents erstellen

sessions_spawn erstellt eine isolierte Session für einen Hintergrund-Task. Das Tool blockiert nie – es gibt sofort eine runId und einen childSessionKey zurück. Ich empfehle, dies für rechenintensive Aufgaben zu nutzen, damit dein Haupt-Agent handlungsfähig bleibt.

Wichtige Optionen:

• runtime: "subagent" (Standard) oder "acp" für externe Harness-Agents.
• model und thinking Overrides für die Child-Session.
• thread: true, um den Spawn an einen Chat-Thread zu binden (Discord, Slack, etc.).