Sessions and memory

Ancrage des canaux

Le docking de canal est un renvoi d’appel pour une session OpenClaw.

Il conserve le même contexte de conversation, mais change l’endroit où les futures réponses pour cette session sont livrées.

Exemple

Alice peut envoyer des messages à OpenClaw sur Telegram et Discord :

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

Si Alice envoie ceci depuis Telegram :

/dock_discord

OpenClaw conserve le contexte de session actuel et change la route de réponse :

Avant le docking	Après `/dock_discord`
Les réponses vont à Telegram `123`	Les réponses vont à Discord `456`

La session n’est pas recréée. L’historique de transcription reste attaché à la même session.

Pourquoi l’utiliser

Utilisez le docking lorsqu’une tâche commence dans une application de chat, mais que les réponses suivantes doivent arriver ailleurs.

Flux courant :

Démarrez une tâche d’agent depuis Telegram.
Passez à Discord, où vous coordonnez le travail.
Envoyez /dock_discord depuis la session Telegram.
Conservez la même session OpenClaw, mais recevez les futures réponses dans Discord.

Configuration requise

Le docking nécessite session.identityLinks. L’expéditeur source et le pair cible doivent se trouver dans le même groupe d’identité :

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

Les valeurs sont des identifiants de pairs préfixés par le canal :

Valeur	Signification
`telegram:123`	id d’expéditeur Telegram `123`
`discord:456`	id de pair direct Discord `456`
`slack:U123`	id d’utilisateur Slack `U123`

La clé canonique (alice ci-dessus) est uniquement le nom du groupe d’identité partagé. Les commandes de docking utilisent les valeurs préfixées par le canal pour prouver que l’expéditeur source et le pair cible sont la même personne.

Commandes

Les commandes de docking sont générées à partir des plugins de canal chargés qui prennent en charge les commandes natives. Commandes intégrées actuelles :

Canal cible	Commande	Alias
Discord	`/dock-discord`	`/dock_discord`
Mattermost	`/dock-mattermost`	`/dock_mattermost`
Slack	`/dock-slack`	`/dock_slack`
Telegram	`/dock-telegram`	`/dock_telegram`

Les alias avec tiret bas sont utiles sur les surfaces de commandes natives comme Telegram.

Ce qui change

Le docking met à jour les champs de livraison de la session active :

Champ de session	Exemple après `/dock_discord`
`lastChannel`	`discord`
`lastTo`	`456`
`lastAccountId`	le compte du canal cible, ou `default`

Ces champs sont conservés dans le magasin de sessions et utilisés par la livraison des réponses ultérieures pour cette session.

Ce qui ne change pas

Le docking ne fait pas ce qui suit :

créer des comptes de canal
connecter un nouveau bot Discord, Telegram, Slack ou Mattermost
accorder l’accès à un utilisateur
contourner les listes d’autorisation de canal ou les politiques de messages directs
déplacer l’historique de transcription vers une autre session
faire partager une session à des utilisateurs sans rapport

Il change uniquement la route de livraison pour la session actuelle.

Dépannage

La commande indique que l’expéditeur n’est pas lié.

Ajoutez à la fois l’expéditeur actuel et le pair cible au même groupe session.identityLinks. Par exemple, si l’expéditeur Telegram 123 doit docker vers le pair Discord 456, incluez à la fois telegram:123 et discord:456.

La commande indique qu’aucune session active n’existe.

Dockez depuis une session de chat direct existante. La commande a besoin d’une entrée de session active afin de pouvoir conserver la nouvelle route.

Les réponses vont toujours vers l’ancien canal.

Vérifiez que la commande a répondu avec un message de réussite, puis confirmez que l’id du pair cible correspond à l’id utilisé par ce canal. Le docking ne change que la route de la session active ; une autre session peut toujours router ailleurs.

Je dois revenir en arrière.

Envoyez la commande correspondante pour le canal d’origine, comme /dock_telegram ou /dock-telegram, depuis un expéditeur lié.

# Exemple

# Pourquoi l’utiliser

# Configuration requise

# Commandes

# Ce qui change

# Ce qui ne change pas

# Dépannage