Configurazione di Microsoft Teams in OpenClaw

Il canale Teams ha uno degli elenchi di chiavi più lunghi tra tutti i canali di OpenClaw, perché deve coprire in un unico blocco i cloud governativi, la cronologia basata su Graph, gli override per team e i flussi di benvenuto con Adaptive Card. Ecco l’elenco come lo raggruppa la documentazione: variabili d’ambiente, contesto della cronologia e le chiavi di configurazione vere e proprie.

Variabili d’ambiente e cronologia

• Solo le chiavi legate all’autenticazione possono venire dall’ambiente: l’ID dell’app, la password dell’app, l’ID del tenant, il tipo di autenticazione (secret o federated), il percorso e l’impronta digitale del certificato per il metodo con certificato, e il flag dell’identità gestita e il client ID per il metodo con identità; le altre chiavi, come la policy dei gruppi o il limite di cronologia, esistono solo nella configurazione.
• Il limite di cronologia controlla quanti messaggi recenti del canale o del gruppo vengono inclusi nel prompt; se manca si usa il limite globale di cronologia delle chat di gruppo e poi 50, mentre zero lo disattiva.
• Il contesto dei thread tramite Graph aggiunge il messaggio padre e fino alle 50 risposte più vecchie accanto alla cronologia recente del canale, esclude il messaggio che ha attivato la risposta, tiene la cronologia separata dal testo del comando del mittente, così che i comandi citati nella cronologia non vengano eseguiti, e accorcia i messaggi lunghi recuperati mantenendone l’inizio e la fine entro il limite per messaggio.
• Il contesto dei thread e degli allegati citati segue la chiave di visibilità del contesto, che ricade sui valori predefiniti del canale e poi su all: allowlist filtra entrambi in base alle allowlist dei mittenti, mentre allowlist-quote filtra la cronologia del thread ma consente il contesto citato; la cronologia dei messaggi diretti è limitata in turni dell’utente, con un override per utente.

Gli ID oggetto AAD stabili autorizzano anche le azioni di approvazione.

Cloud, webhook, accesso, limiti

Il flag enabled, l’ID dell’app, la password dell’app e l’ID del tenant sono le basi. La chiave del cloud seleziona l’ambiente del Teams SDK: pubblico per impostazione predefinita, oppure US government, DoD o Cina, da impostare insieme all’URL del servizio per i cloud governativi; la Cina usa il preset dell’SDK e i riferimenti di conversazione Azure China memorizzati, con gli helper basati su Graph disattivati finché non arriverà il routing Graph per Azure China, e l’URL del servizio è il confine del Bot Connector per le operazioni proattive, predefinito per il cloud pubblico e da impostare esplicitamente per GCC, GCC High o DoD. La porta del webhook è 3978 per impostazione predefinita e il percorso è la route dei messaggi. La policy dei messaggi diretti accetta pairing, allowlist, open o disabled, con pairing come valore predefinito; l’allowlist dei messaggi diretti privilegia gli ID oggetto AAD, che autorizzano anche le azioni di approvazione, e la procedura guidata di configurazione risolve i nomi in ID quando l’accesso a Graph è disponibile; la destinazione predefinita imposta la destinazione in uscita e può anch’essa autorizzare le approvazioni, e la chiave pericolosa di corrispondenza dei nomi è l’interruttore di emergenza che riattiva la corrispondenza su UPN o nomi visualizzati modificabili e l’instradamento diretto per nome di team o di canale. Il limite dei blocchi di testo è 4000 per impostazione predefinita ed è un tetto rigido, qualunque valore tu configuri; la modalità di suddivisione newline divide sulle righe vuote prima che sulla lunghezza, l’allowlist degli host multimediali include per impostazione predefinita i domini Microsoft e Teams, l’allowlist di autenticazione multimediale decide dove possono essere aggiunti gli header Authorization nei nuovi tentativi, il fallback multimediale di Graph attiva le ricerche su Graph quando l’HTML omette i marcatori dei file, e il limite di dimensione dei media ricade sul valore predefinito dell’agente.

Override, schede, feedback, SSO

• L’obbligo di menzione è true per impostazione predefinita e lo stile di risposta sceglie tra thread e top-level, entrambi sovrascrivibili per team e per canale nella mappa teams, indicizzata per ID del team e ID della conversazione, insieme alle policy degli strumenti per team e per canale con allow, deny e also-allow e alle policy degli strumenti per mittente, indicizzate con i prefissi espliciti channel, id, e164, username o name e con il carattere jolly.
• Il tipo di autenticazione, il percorso e l’impronta digitale del certificato, il flag dell’identità gestita e il client ID rispecchiano la pagina sull’autenticazione, e l’ID del sito SharePoint indica il sito usato per i caricamenti di file nelle chat di gruppo e nei canali.
• Una scheda di benvenuto e una scheda di benvenuto per i gruppi con prompt iniziali mostrano una Adaptive Card al primo contatto in un messaggio diretto o in un gruppo, il prefisso delle risposte antepone un testo alle risposte in uscita, il feedback con pollice su e pollice giù è attivo per impostazione predefinita, con un follow-up di riflessione sul feedback negativo e il relativo tempo di attesa, e i blocchi SSO e delegated-auth configurano la connessione OAuth del Bot Framework e gli scope Graph delegati; per attivare l’SSO serve un nome di connessione.

OpenClaw su Microsoft Teams è l’articolo sul canale a cui appartengono queste chiavi, e l’autenticazione di Microsoft Teams in OpenClaw spiega i metodi federati dietro le chiavi di autenticazione.

ID, non nomi

Tre chiavi dell’elenco condividono un principio: gli ID oggetto sono stabili e i nomi no, quindi allowlist, approvazioni e destinazioni dovrebbero riportare l’ID, e l’interruttore di corrispondenza dei nomi esiste solo per tenere in vita una vecchia installazione durante la migrazione. La guida al manifest e alle autorizzazioni di Microsoft Teams in OpenClaw descrive le autorizzazioni di cui hanno bisogno gli helper basati su Graph, e l’articolo sulle chat di gruppo in OpenClaw le regole comuni a tutti i canali per le conversazioni di gruppo, che questi override affinano.

Su Diali

Microsoft Teams non è tra i canali che Diali collega oggi: WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS e voce. OpenClaw ospitato su Diali è l’assistente, e la guida per collegare il tuo primo canale in cinque minuti mostra i canali che puoi collegare in cinque minuti.

• Solo le chiavi di autenticazione vengono dall’ambiente; il resto è configurazione.
• Il contesto dei thread porta il messaggio padre e cinquanta risposte, mai i loro comandi.
• 4000 caratteri per blocco, con un tetto rigido.