> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ancoraggio dei canali

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:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456"],
    },
  },
}
```

Se Alice invia questo da Telegram:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/dock_discord
```

OpenClaw mantiene il contesto della sessione corrente e cambia il percorso di risposta:

| Prima del docking                  | Dopo `/dock_discord`              |
| ---------------------------------- | --------------------------------- |
| Le risposte vanno a Telegram `123` | Le risposte vanno a Discord `456` |

La sessione non viene ricreata. La cronologia della trascrizione resta associata alla
stessa sessione.

## 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:

1. Avvia un'attività dell'agente da Telegram.
2. Passa a Discord, dove stai coordinando il lavoro.
3. Invia `/dock_discord` dalla sessione Telegram.
4. 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à:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456", "slack:U123"],
    },
  },
}
```

I valori sono ID peer con prefisso del canale:

| Valore         | Significato                   |
| -------------- | ----------------------------- |
| `telegram:123` | ID mittente Telegram `123`    |
| `discord:456`  | ID peer diretto Discord `456` |
| `slack:U123`   | ID utente Slack `U123`        |

La chiave canonica (`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`   |

Gli alias con trattino basso sono utili sulle superfici di comando native come 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` |

Questi campi vengono persistiti nello store della sessione e usati dal recapito
delle risposte successive per quella sessione.

## 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.