Sessions and memory

Channel-Andockung

Channel-Docking ist eine Anrufweiterleitung für eine einzelne OpenClaw-Sitzung. Dabei bleibt derselbe Konversationskontext erhalten, aber zukünftige Antworten für diese Sitzung werden an einen anderen Ort zugestellt. Docking funktioniert nur aus einem Direktchat; in einem Gruppenchat wird es nicht ausgeführt.

Beispiel

Alice kann OpenClaw über Telegram und Discord Nachrichten senden:

json5

{  session: {    identityLinks: {      alice: ["telegram:123", "discord:456"],    },  },}

Wenn Alice Folgendes aus einem Telegram-Direktchat sendet:

text

/dock_discord

behält OpenClaw den aktuellen Sitzungskontext bei und ändert die Antwortroute:

Vor dem Docking	Nach `/dock_discord`
Antworten gehen an Telegram `123`	Antworten gehen an Discord `456`

Die Sitzung wird nicht neu erstellt. Der Transkriptverlauf bleibt mit derselben Sitzung verknüpft.

Warum Sie es verwenden sollten

Verwenden Sie Docking, wenn eine Aufgabe in einer Chat-App beginnt, die nächsten Antworten aber an einem anderen Ort eingehen sollen.

Typischer Ablauf:

Starten Sie eine Agentenaufgabe über Telegram.
Wechseln Sie zu Discord, wo Sie die Arbeit koordinieren.
Senden Sie /dock_discord aus dem Telegram-Direktchat.
Behalten Sie dieselbe OpenClaw-Sitzung bei, empfangen Sie zukünftige Antworten aber in Discord.

Erforderliche Konfiguration

Docking erfordert session.identityLinks. Der Absender auf dem Quellkanal und der Zielkontakt müssen derselben Identitätsgruppe angehören:

json5

{  session: {    identityLinks: {      alice: ["telegram:123", "discord:456", "slack:U123"],    },  },}

Die Werte sind Kontakt-IDs mit vorangestelltem Kanalpräfix:

Wert	Bedeutung
`telegram:123`	Telegram-Absender-ID `123`
`discord:456`	Discord-Direktkontakt-ID `456`
`slack:U123`	Slack-Benutzer-ID `U123`

Der kanonische Schlüssel (oben alice) ist lediglich der gemeinsame Name der Identitätsgruppe. Docking- Befehle verwenden die Werte mit Kanalpräfix, um nachzuweisen, dass der Absender auf dem Quellkanal und der Zielkontakt dieselbe Person sind.

Befehle

OpenClaw erzeugt für jedes geladene Kanal-Plugin, das native Befehle unterstützt, einen /dock-<channel>-Befehl. Die Liste wächst daher, wenn Plugins hinzugefügt werden. Gebündelte Plugins, die dies derzeit unterstützen:

Zielkanal	Befehl	Alias
Discord	`/dock-discord`	`/dock_discord`
Mattermost	`/dock-mattermost`	`/dock_mattermost`
Slack	`/dock-slack`	`/dock_slack`
Telegram	`/dock-telegram`	`/dock_telegram`

Die Schreibweise mit Unterstrich ist zugleich der native Befehlsname auf Oberflächen wie Telegram, die Slash-Befehle direkt bereitstellen.

Was sich ändert

Docking aktualisiert die Zustellungsfelder der aktiven Sitzung:

Sitzungsfeld	Beispiel nach `/dock_discord`
`lastChannel`	`discord`
`lastTo`	`456`
`lastAccountId`	das Zielkanalkonto oder `default`

Diese Felder werden im Sitzungsspeicher dauerhaft gespeichert und für die spätere Zustellung von Antworten dieser Sitzung verwendet.

Was sich nicht ändert

Docking führt Folgendes nicht aus:

Kanalkonten erstellen
einen neuen Discord-, Telegram-, Slack- oder Mattermost-Bot verbinden
einem Benutzer Zugriff gewähren
Kanal-Zulassungslisten oder Direktnachrichtenrichtlinien umgehen
den Transkriptverlauf in eine andere Sitzung verschieben
dafür sorgen, dass nicht miteinander verbundene Benutzer eine Sitzung gemeinsam nutzen

Es ändert lediglich die Zustellungsroute der aktuellen Sitzung.

Fehlerbehebung

Der Befehl meldet, dass der Absender nicht verknüpft ist.

Fügen Sie sowohl den aktuellen Absender als auch den Zielkontakt derselben session.identityLinks-Gruppe hinzu. Wenn beispielsweise der Telegram-Absender 123 an den Discord-Kontakt 456 andocken soll, schließen Sie sowohl telegram:123 als auch discord:456 ein.

Der Befehl meldet, dass Docking nur aus Direktchats verfügbar ist.

Senden Sie den Docking-Befehl aus einem Direktchat mit OpenClaw und nicht aus einem Gruppenchat.

Der Befehl meldet, dass keine aktive Sitzung vorhanden ist.

Docken Sie aus einer bestehenden Direktchat-Sitzung an. Der Befehl benötigt einen aktiven Sitzungseintrag, damit er die neue Route dauerhaft speichern kann.

Antworten gehen weiterhin an den alten Kanal.

Prüfen Sie, ob der Befehl mit einer Erfolgsmeldung geantwortet hat, und bestätigen Sie, dass die ID des Zielkontakts mit der von diesem Kanal verwendeten ID übereinstimmt. Docking ändert nur die Route der aktiven Sitzung; eine andere Sitzung kann weiterhin an einen anderen Ort weiterleiten.

Ich muss zurückwechseln.

Senden Sie den passenden Befehl für den ursprünglichen Kanal, beispielsweise /dock_telegram oder /dock-telegram, von einem verknüpften Absender.

Was this useful?