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.
Il docking del canale è l’inoltro delle chiamate per una sessione OpenClaw.
Mantiene lo stesso contesto della conversazione, ma cambia dove vengono recapitate
le risposte future per quella sessione.
Esempio
Alice può inviare messaggi a OpenClaw su Telegram e Discord:
{
session: {
identityLinks: {
alice: ["telegram:123", "discord:456"],
},
},
}
| Prima del docking | Dopo /dock_discord |
|---|
Le risposte vanno a Telegram 123 | Le risposte vanno a Discord 456 |
Perché usarlo
Usa il docking quando un’attività inizia in un’app di chat ma le risposte successive devono arrivare
da qualche altra parte.
Flusso comune:
- Avvia un’attività dell’agente da Telegram.
- Passa a Discord, dove stai coordinando il lavoro.
- Invia
/dock_discord dalla sessione Telegram.
- Mantieni la stessa sessione OpenClaw, ma ricevi le risposte future in Discord.
Configurazione richiesta
Il docking richiede session.identityLinks. Il mittente sorgente e il peer di destinazione
devono essere nello stesso gruppo di identità:
{
session: {
identityLinks: {
alice: ["telegram:123", "discord:456", "slack:U123"],
},
},
}
| Valore | Significato |
|---|
telegram:123 | ID mittente Telegram 123 |
discord:456 | ID peer diretto Discord 456 |
slack:U123 | ID utente Slack U123 |
alice sopra) è solo il nome del gruppo di identità condiviso. I comandi di dock
usano i valori con prefisso del canale per dimostrare che il mittente sorgente e
il peer di destinazione sono la stessa persona.
Comandi
I comandi di dock sono generati dai Plugin di canale caricati che supportano i comandi
nativi. Comandi attualmente inclusi:
| Canale di destinazione | Comando | Alias |
|---|
| Discord | /dock-discord | /dock_discord |
| Mattermost | /dock-mattermost | /dock_mattermost |
| Slack | /dock-slack | /dock_slack |
| Telegram | /dock-telegram | /dock_telegram |
Cosa cambia
Il docking aggiorna i campi di recapito della sessione attiva:
| Campo della sessione | Esempio dopo /dock_discord |
|---|
lastChannel | discord |
lastTo | 456 |
lastAccountId | l’account del canale di destinazione, o default |
Cosa non cambia
Il docking non:
- crea account di canale
- connette un nuovo bot Discord, Telegram, Slack o Mattermost
- concede accesso a un utente
- aggira allowlist dei canali o criteri dei DM
- sposta la cronologia della trascrizione in un’altra sessione
- fa sì che utenti non correlati condividano una sessione
Cambia solo il percorso di recapito per la sessione corrente.
Risoluzione dei problemi
Il comando dice che il mittente non è collegato.
Aggiungi sia il mittente corrente sia il peer di destinazione allo stesso gruppo
session.identityLinks. Ad esempio, se il mittente Telegram 123 deve fare il dock
verso il peer Discord 456, includi sia telegram:123 sia discord:456.
Il comando dice che non esiste alcuna sessione attiva.
Esegui il dock da una sessione di chat diretta esistente. Il comando ha bisogno di una voce di sessione
attiva per poter persistere il nuovo percorso.
Le risposte continuano ad andare al vecchio canale.
Controlla che il comando abbia risposto con un messaggio di successo e conferma che l’ID
del peer di destinazione corrisponda all’ID usato da quel canale. Il docking cambia solo il percorso
della sessione attiva; un’altra sessione potrebbe comunque instradare altrove.
Devo tornare indietro.
Invia il comando corrispondente per il canale originale, come /dock_telegram o
/dock-telegram, da un mittente collegato.