Exemple
Alice peut envoyer des messages à OpenClaw sur Telegram et Discord :
La session n’est pas recréée. L’historique de la transcription reste associé à la
même session.
Pourquoi l’utiliser
Utilisez l’amarrage lorsqu’une tâche commence dans une application de discussion, mais que les réponses suivantes doivent arriver ailleurs. Déroulement courant :- Démarrez une tâche d’agent depuis Telegram.
- Passez à Discord, où vous coordonnez le travail.
- Envoyez
/dock_discorddepuis la discussion directe Telegram. - Conservez la même session OpenClaw, mais recevez les prochaines réponses dans Discord.
Configuration requise
L’amarrage nécessitesession.identityLinks. L’expéditeur source et le pair cible
doivent appartenir au même groupe d’identité :
La clé canonique (
alice ci-dessus) est uniquement le nom du groupe d’identité partagé. Les commandes
d’amarrage 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
OpenClaw génère une commande/dock-<channel> pour chaque Plugin de canal chargé
qui prend en charge les commandes natives ; la liste s’allonge donc à mesure que des Plugins sont ajoutés. Les
Plugins intégrés qui la prennent actuellement en charge sont les suivants :
La forme avec un trait de soulignement est également le nom de la commande native sur les interfaces comme Telegram
qui exposent directement les commandes à barre oblique.
Ce qui change
L’amarrage met à jour les champs de livraison de la session active :
Ces champs sont conservés dans le stockage des sessions et utilisés pour la livraison des
réponses ultérieures de cette session.
Ce qui ne change pas
L’amarrage ne permet pas de :- créer des comptes de canal
- connecter un nouveau bot Discord, Telegram, Slack ou Mattermost
- accorder un accès à un utilisateur
- contourner les listes d’autorisation des canaux ou les politiques de messages directs
- déplacer l’historique de la transcription vers une autre session
- faire partager une session à des utilisateurs sans lien entre eux
Dépannage
La commande indique que l’expéditeur n’est pas lié. Ajoutez l’expéditeur actuel et le pair cible au même groupesession.identityLinks. Par exemple, si l’expéditeur Telegram 123 doit être amarré
au pair Discord 456, incluez telegram:123 et discord:456.
La commande indique que l’amarrage est uniquement disponible depuis les discussions directes.
Envoyez la commande d’amarrage depuis une discussion directe avec OpenClaw, et non depuis une discussion de groupe.
La commande indique qu’aucune session active n’existe.
Effectuez l’amarrage depuis une session de discussion directe existante. La commande nécessite une entrée de session
active afin de pouvoir conserver le nouvel itinéraire.
Les réponses sont toujours envoyées vers l’ancien canal.
Vérifiez que la commande a répondu par un message de réussite et confirmez que l’identifiant du
pair cible correspond à celui utilisé par ce canal. L’amarrage modifie uniquement l’itinéraire de la session
active ; une autre session peut toujours acheminer ses réponses ailleurs.
Je dois revenir au canal précédent.
Envoyez la commande correspondante pour le canal d’origine, telle que /dock_telegram ou
/dock-telegram, depuis un expéditeur lié.