Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Channel-Docking ist Anrufweiterleitung für eine OpenClaw-Sitzung. Es behält denselben Unterhaltungskontext bei, ändert aber, wohin zukünftige Antworten für diese Sitzung zugestellt werden.

​
Beispiel

Alice kann OpenClaw über Telegram und Discord eine Nachricht senden: 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456"],
    },
  },
}
Wenn Alice dies von Telegram sendet: 
/dock_discord
OpenClaw behält den aktuellen Sitzungskontext bei und ändert die Antwortroute:
Vor dem DockingNach /dock_discord
Antworten gehen an Telegram 123Antworten gehen an Discord 456
Die Sitzung wird nicht neu erstellt. Der Transkriptverlauf bleibt an dieselbe Sitzung angehängt.

​
Warum verwenden

Verwenden Sie Docking, wenn eine Aufgabe in einer Chat-App beginnt, die nächsten Antworten aber an einem anderen Ort ankommen sollen. Typischer Ablauf:
  1. Starten Sie eine Agent-Aufgabe von Telegram.
  2. Wechseln Sie zu Discord, wo Sie die Arbeit koordinieren.
  3. Senden Sie /dock_discord aus der Telegram-Sitzung.
  4. Behalten Sie dieselbe OpenClaw-Sitzung bei, empfangen Sie zukünftige Antworten aber in Discord.

​
Erforderliche Konfiguration

Docking erfordert session.identityLinks. Der Quellabsender und der Ziel-Peer müssen sich in derselben Identitätsgruppe befinden: 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456", "slack:U123"],
    },
  },
}
Die Werte sind kanalpräfixierte Peer-IDs:
WertBedeutung
telegram:123Telegram-Absender-ID 123
discord:456Discord-Direkt-Peer-ID 456
slack:U123Slack-Benutzer-ID U123
Der kanonische Schlüssel (alice oben) ist nur der gemeinsame Name der Identitätsgruppe. Dock-Befehle verwenden die kanalpräfixierten Werte, um nachzuweisen, dass der Quellabsender und der Ziel-Peer dieselbe Person sind.

​
Befehle

Dock-Befehle werden aus geladenen Kanal-Plugins generiert, die native Befehle unterstützen. Aktuelle gebündelte Befehle:
ZielkanalBefehlAlias
Discord/dock-discord/dock_discord
Mattermost/dock-mattermost/dock_mattermost
Slack/dock-slack/dock_slack
Telegram/dock-telegram/dock_telegram
Die Unterstrich-Aliasse sind auf nativen Befehlsoberflächen wie Telegram nützlich.

​
Was sich ändert

Docking aktualisiert die Zustellfelder der aktiven Sitzung:
SitzungsfeldBeispiel nach /dock_discord
lastChanneldiscord
lastTo456
lastAccountIddas Zielkanal-Konto oder default
Diese Felder werden im Sitzungsspeicher persistiert und von der späteren Antwortzustellung für diese Sitzung verwendet.

​
Was sich nicht ändert

Docking bewirkt nicht Folgendes:
  • Kanalkonten erstellen
  • einen neuen Discord-, Telegram-, Slack- oder Mattermost-Bot verbinden
  • einem Benutzer Zugriff gewähren
  • Kanal-Allowlists oder DM-Richtlinien umgehen
  • Transkriptverlauf in eine andere Sitzung verschieben
  • dafür sorgen, dass nicht zusammengehörige Benutzer eine Sitzung teilen
Es ändert nur die Zustellroute für die aktuelle Sitzung.

​
Fehlerbehebung

Der Befehl meldet, dass der Absender nicht verknüpft ist. Fügen Sie sowohl den aktuellen Absender als auch den Ziel-Peer derselben session.identityLinks-Gruppe hinzu. Wenn beispielsweise Telegram-Absender 123 zu Discord-Peer 456 docken soll, nehmen Sie sowohl telegram:123 als auch discord:456 auf. Der Befehl meldet, dass keine aktive Sitzung vorhanden ist. Docken Sie aus einer bestehenden Direktchat-Sitzung. Der Befehl benötigt einen aktiven Sitzungseintrag, damit er die neue Route persistieren 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 Ziel-Peer-ID mit der von diesem Kanal verwendeten ID übereinstimmt. Docking ändert nur die Route der aktiven Sitzung; eine andere Sitzung kann weiterhin anderswohin routen. Ich muss zurückwechseln. Senden Sie den passenden Befehl für den ursprünglichen Kanal, z. B. /dock_telegram oder /dock-telegram, von einem verknüpften Absender.