Sessions and memory
Acoplamento de canais
O acoplamento de canais é o encaminhamento de chamadas para uma sessão do OpenClaw. Ele mantém o mesmo contexto da conversa, mas altera o local para onde as respostas futuras dessa sessão são entregues. O acoplamento funciona apenas em uma conversa direta; ele não é executado em uma conversa em grupo.
Exemplo
Alice pode enviar mensagens ao OpenClaw pelo Telegram e pelo Discord:
{ session: { identityLinks: { alice: ["telegram:123", "discord:456"], }, },}Se Alice enviar isto em uma conversa direta no Telegram:
/dock_discordO OpenClaw mantém o contexto da sessão atual e altera a rota de resposta:
| Antes do acoplamento | Depois de /dock_discord |
|---|---|
As respostas vão para o Telegram 123 |
As respostas vão para o Discord 456 |
A sessão não é recriada. O histórico da transcrição permanece vinculado à mesma sessão.
Por que usar
Use o acoplamento quando uma tarefa começar em um aplicativo de conversa, mas as próximas respostas precisarem ser entregues em outro lugar.
Fluxo comum:
- Inicie uma tarefa de agente pelo Telegram.
- Vá para o Discord, onde você está coordenando o trabalho.
- Envie
/dock_discordpela conversa direta no Telegram. - Mantenha a mesma sessão do OpenClaw, mas receba as respostas futuras no Discord.
Configuração obrigatória
O acoplamento requer session.identityLinks. O remetente de origem e o contato de destino
devem estar no mesmo grupo de identidade:
{ session: { identityLinks: { alice: ["telegram:123", "discord:456", "slack:U123"], }, },}Os valores são IDs de contatos prefixados pelo canal:
| Valor | Significado |
|---|---|
telegram:123 |
ID do remetente no Telegram 123 |
discord:456 |
ID do contato direto no Discord 456 |
slack:U123 |
ID do usuário no Slack U123 |
A chave canônica (alice acima) é apenas o nome compartilhado do grupo de identidade. Os comandos de
acoplamento usam os valores prefixados pelo canal para comprovar que o remetente de origem e o
contato de destino são a mesma pessoa.
Comandos
O OpenClaw gera um comando /dock-<channel> para cada Plugin de canal carregado
que oferece suporte a comandos nativos; portanto, a lista aumenta à medida que Plugins são adicionados. Os Plugins
incluídos que atualmente oferecem esse suporte são:
| Canal de destino | Comando | Alias |
|---|---|---|
| Discord | /dock-discord |
/dock_discord |
| Mattermost | /dock-mattermost |
/dock_mattermost |
| Slack | /dock-slack |
/dock_slack |
| Telegram | /dock-telegram |
/dock_telegram |
A forma com sublinhado também é o nome do comando nativo em interfaces como o Telegram, que expõem comandos de barra diretamente.
O que muda
O acoplamento atualiza os campos de entrega da sessão ativa:
| Campo da sessão | Exemplo depois de /dock_discord |
|---|---|
lastChannel |
discord |
lastTo |
456 |
lastAccountId |
a conta do canal de destino ou default |
Esses campos são persistidos no armazenamento de sessões e usados na entrega de respostas posteriores dessa sessão.
O que não muda
O acoplamento não:
- cria contas de canal
- conecta um novo bot do Discord, Telegram, Slack ou Mattermost
- concede acesso a um usuário
- ignora listas de permissões de canais ou políticas de mensagens diretas
- move o histórico da transcrição para outra sessão
- faz usuários não relacionados compartilharem uma sessão
Ele altera apenas a rota de entrega da sessão atual.
Solução de problemas
O comando informa que o remetente não está vinculado.
Adicione o remetente atual e o contato de destino ao mesmo grupo
session.identityLinks. Por exemplo, se o remetente 123 do Telegram precisar acoplar
ao contato 456 do Discord, inclua telegram:123 e discord:456.
O comando informa que o acoplamento está disponível apenas em conversas diretas.
Envie o comando de acoplamento em uma conversa direta com o OpenClaw, não em uma conversa em grupo.
O comando informa que não existe uma sessão ativa.
Faça o acoplamento a partir de uma sessão existente de conversa direta. O comando precisa de uma entrada de sessão ativa para poder persistir a nova rota.
As respostas ainda vão para o canal antigo.
Verifique se o comando respondeu com uma mensagem de êxito e confirme se o ID do contato de destino corresponde ao ID usado pelo canal. O acoplamento altera apenas a rota da sessão ativa; outra sessão ainda pode estar roteada para outro local.
Preciso voltar ao canal anterior.
Envie o comando correspondente ao canal original, como /dock_telegram ou
/dock-telegram, a partir de um remetente vinculado.
