Configuração do Microsoft Teams no OpenClaw

O canal do Teams tem uma das listas de chaves mais longas entre os canais do OpenClaw, porque precisa cobrir nuvens governamentais, histórico baseado no Graph, substituições por equipe e fluxos de boas-vindas com Adaptive Cards em um único bloco. Aqui está a lista do jeito que a documentação a agrupa: variáveis de ambiente, contexto de histórico e as próprias chaves de configuração.

Variáveis de ambiente e histórico

• Só as chaves ligadas à autenticação podem vir do ambiente: o ID do app, a senha do app, o ID do locatário, o tipo de autenticação como secret ou federated, o caminho e a impressão digital do certificado para o método por certificado, e a flag de identidade gerenciada e o ID do cliente para o método por identidade; outras chaves, como a política de grupo ou o limite de histórico, ficam só na configuração.
• O limite de histórico controla quantas mensagens recentes do canal ou do grupo são incluídas no prompt, recorrendo ao limite global de histórico de chats em grupo e depois a 50, sendo que zero o desativa.
• O contexto de thread do Graph adiciona a mensagem pai e até as 50 respostas mais antigas junto com o histórico recente do canal, exclui a mensagem que disparou a resposta, mantém o histórico separado do texto de comando do remetente para que comandos citados no histórico não sejam executados, e reduz mensagens longas recuperadas ao início e ao fim delas dentro do limite por mensagem.
• O contexto de thread e de anexos citados segue a chave de visibilidade do contexto, recorrendo aos padrões do canal e depois a all, com allowlist filtrando ambos pelas listas de permissões de remetentes e allowlist-quote filtrando o histórico da thread, mas permitindo o contexto citado; o histórico de mensagens diretas é limitado em turnos do usuário, com uma substituição por usuário.

IDs de objeto estáveis do AAD também autorizam ações de aprovação.

Nuvens, webhook, acesso, limites

A flag de ativação, o ID do app, a senha do app e o ID do locatário são o básico. A chave de nuvem seleciona o ambiente do SDK do Teams: pública por padrão, ou governo dos EUA, DoD ou China, definida junto com a URL de serviço para as nuvens governamentais; a China usa o preset do SDK e referências de conversa do Azure China armazenadas, com os helpers baseados no Graph desativados até que o roteamento do Graph no Azure China seja lançado, e a URL de serviço é a fronteira do Bot Connector para operações proativas, com valor padrão para a nuvem pública e definida explicitamente para GCC, GCC High ou DoD. A porta do webhook é 3978 por padrão e o caminho é a rota de mensagens. A política de mensagens diretas aceita pairing, allowlist, open ou disabled, com pairing como padrão; a lista de permissões de mensagens diretas prefere IDs de objeto do AAD, que também autorizam ações de aprovação, e o wizard de configuração resolve nomes em IDs quando há acesso ao Graph; o destino padrão define o destino de saída e também pode autorizar aprovações; e a chave perigosa de correspondência por nome é o interruptor de emergência que reativa a correspondência por UPN ou nome de exibição mutáveis e o roteamento direto por nome de equipe ou de canal. O limite de fragmento de texto é 4000 por padrão e tem esse teto fixo, seja qual for a configuração; o modo de fragmentação por quebra de linha divide nas linhas em branco antes de considerar o tamanho; a lista de permissões de hosts de mídia tem como padrão os domínios da Microsoft e do Teams; a lista de permissões de autenticação de mídia decide onde cabeçalhos Authorization podem ser anexados nas novas tentativas; o fallback de mídia pelo Graph ativa consultas ao Graph quando o HTML omite os marcadores de arquivo; e o limite de tamanho de mídia recorre ao padrão do agente.

Substituições, cartões, feedback, SSO

• A exigência de menção é true por padrão e o estilo de resposta escolhe thread ou top-level, ambos substituíveis por equipe e por canal no mapa teams, indexado por ID da equipe e ID da conversa, junto com políticas de ferramentas por equipe e por canal com allow, deny e also-allow, e políticas de ferramentas por remetente indexadas com os prefixos explícitos channel, id, e164, username ou name e o curinga.
• O tipo de autenticação, o caminho e a impressão digital do certificado, a flag de identidade gerenciada e o ID do cliente espelham a página de autenticação, e o ID do site do SharePoint indica o site usado para uploads de arquivos em chats em grupo e canais.
• Um cartão de boas-vindas e um cartão de boas-vindas em grupo com sugestões de prompt mostram um Adaptive Card no primeiro contato por mensagem direta ou em grupo, o prefixo de resposta adiciona texto antes das respostas enviadas, o feedback de polegar para cima e para baixo vem ativado por padrão, com um acompanhamento de reflexão sobre feedback negativo e o respectivo cooldown, e os blocos de SSO e de autenticação delegada configuram a conexão OAuth do Bot Framework e os escopos delegados do Graph, sendo que ativar o SSO exige um nome de conexão.

O OpenClaw no Microsoft Teams é o post do canal ao qual essas chaves pertencem, e a autenticação do Microsoft Teams no OpenClaw, os métodos federados por trás das chaves de autenticação.

IDs, não nomes

Três chaves da lista compartilham um princípio: IDs de objeto são estáveis e nomes não são, então listas de permissões, aprovações e destinos devem levar o ID, e o interruptor de correspondência por nome existe só para manter uma instalação antiga funcionando enquanto ela é migrada. O manifesto e as permissões do Microsoft Teams no OpenClaw cobre as permissões de que os helpers baseados no Graph precisam, e os chats em grupo no OpenClaw, as regras entre canais para conversas em grupo que essas substituições refinam.

Na Diali

O Microsoft Teams não está entre os canais que a Diali conecta hoje: WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS e voz. O OpenClaw hospedado na Diali é o assistente, e conecte seu primeiro canal em cinco minutos mostra os canais que você pode conectar em cinco minutos.

• Só as chaves de autenticação vêm do ambiente; o resto é configuração.
• O contexto de thread traz a mensagem pai e cinquenta respostas, nunca os comandos delas.
• 4000 caracteres por fragmento, com teto fixo.