Microsoft-Teams-Konfiguration in OpenClaw

Der Teams-Kanal hat eine der längsten Schlüssellisten aller OpenClaw-Kanäle, weil er Behörden-Clouds, Graph-gestützten Verlauf, Overrides pro Team und Willkommensabläufe mit Adaptive Cards in einem einzigen Block abdecken muss. Hier ist die Liste so gruppiert wie in der Dokumentation: Umgebungsvariablen, Verlaufskontext und die Konfigurationsschlüssel selbst.

Umgebungsvariablen und Verlauf

• Nur die Auth-bezogenen Schlüssel können aus der Umgebung kommen: die App-ID, das App-Passwort, die Tenant-ID, der Auth-Typ als Secret oder Federated, Zertifikatspfad und Thumbprint für die Zertifikatsmethode sowie das Managed-Identity-Flag und die Client-ID für die Identitätsmethode; andere Schlüssel wie die Gruppenrichtlinie oder das Verlaufslimit gibt es nur in der Konfiguration.
• Das Verlaufslimit steuert, wie viele aktuelle Kanal- oder Gruppennachrichten in den Prompt eingebettet werden; es fällt auf das globale Verlaufslimit für Gruppenchats und dann auf 50 zurück, und 0 deaktiviert es.
• Der Graph-Thread-Kontext fügt neben dem aktuellen Kanalverlauf die Ausgangsnachricht und bis zu 50 der ältesten Antworten hinzu, schließt die auslösende Nachricht aus, hält den Verlauf vom Befehlstext des Absenders getrennt, damit im Verlauf zitierte Befehle nicht ausgeführt werden, und kürzt lange abgerufene Nachrichten innerhalb des Limits pro Nachricht auf Anfang und Ende.
• Thread-Kontext und Kontext aus zitierten Anhängen folgen dem Schlüssel für die Kontextsichtbarkeit, mit Fallback auf die Kanal-Standardwerte und dann auf all; allowlist filtert beides anhand der Absender-Zulassungslisten, allowlist-quote filtert den Thread-Verlauf, lässt zitierten Kontext aber zu; der DM-Verlauf wird in Benutzer-Turns begrenzt, mit einem Override pro Benutzer.

Stabile AAD-Objekt-IDs autorisieren auch Freigabeaktionen.

Clouds, Webhook, Zugriff, Limits

Das Enabled-Flag, die App-ID, das App-Passwort und die Tenant-ID sind die Grundlagen. Der Cloud-Schlüssel wählt die Umgebung des Teams-SDK, standardmäßig die öffentliche, oder US-Behörden, DoD oder China, bei den Behörden-Clouds zusammen mit der Service-URL gesetzt; China nutzt das SDK-Preset und gespeicherte Konversationsreferenzen für Azure China, wobei die Graph-gestützten Helfer deaktiviert bleiben, bis das Graph-Routing für Azure China verfügbar ist, und die Service-URL ist die Bot-Connector-Grenze für proaktive Operationen, für die öffentliche Cloud mit Standardwert und für GCC, GCC High oder DoD explizit gesetzt. Der Webhook-Port ist standardmäßig 3978 und der Pfad die Messages-Route. Die DM-Richtlinie akzeptiert pairing, allowlist, open oder disabled, mit pairing als Standard; die DM-Zulassungsliste bevorzugt AAD-Objekt-IDs, die auch Freigabeaktionen autorisieren, wobei der Einrichtungsassistent Namen in IDs auflöst, wenn Graph-Zugriff verfügbar ist; das Standardziel legt den ausgehenden Empfänger fest und kann ebenfalls Freigaben autorisieren, und der gefährliche Schlüssel für den Namensabgleich ist der Break-Glass-Schalter, der den Abgleich über veränderliche UPNs oder Anzeigenamen sowie das direkte Routing über Team- oder Kanalnamen wieder aktiviert. Das Text-Chunk-Limit liegt standardmäßig bei 4000 und ist dort fest gedeckelt, egal was Sie konfigurieren; der Newline-Chunk-Modus teilt vor der Länge an Leerzeilen, die Zulassungsliste für Medien-Hosts umfasst standardmäßig die Microsoft- und Teams-Domains, die Medien-Auth-Zulassungsliste entscheidet, wohin bei Wiederholungsversuchen Authorization-Header angehängt werden dürfen, der Graph-Medien-Fallback aktiviert Graph-Abfragen, wenn im HTML die Dateimarkierungen fehlen, und die Obergrenze für die Mediengröße fällt auf den Standardwert des Agenten zurück.

Overrides, Karten, Feedback, SSO

• Die Erwähnungspflicht steht standardmäßig auf true, und der Antwortstil wählt Thread oder oberste Ebene; beides lässt sich pro Team und pro Kanal in der Teams-Map überschreiben, deren Schlüssel Team-ID und Konversations-ID sind, zusammen mit Tool-Richtlinien pro Team und pro Kanal mit Erlauben, Verweigern und zusätzlichem Erlauben sowie Tool-Richtlinien pro Absender, deren Schlüssel die expliziten Präfixe channel, id, e164, username oder name oder die Wildcard tragen.
• Auth-Typ, Zertifikatspfad und Thumbprint, Managed-Identity-Flag und Client-ID spiegeln die Authentifizierungsseite, und die SharePoint-Site-ID benennt die Site, die für Datei-Uploads in Gruppenchats und Kanälen verwendet wird.
• Eine Willkommenskarte und eine Gruppen-Willkommenskarte mit Prompt-Startern zeigen beim ersten Kontakt per DM oder in der Gruppe eine Adaptive Card, das Antwortpräfix stellt ausgehenden Antworten Text voran, Daumen-hoch- und Daumen-runter-Feedback ist standardmäßig aktiv, mit einer Reflexion als Nachfassaktion bei negativem Feedback und deren Cooldown, und die Blöcke für SSO und delegierte Authentifizierung konfigurieren die OAuth-Verbindung des Bot Framework und delegierte Graph-Scopes, wobei das Aktivieren von SSO einen Verbindungsnamen erfordert.

Diese Schlüssel gehören zum Kanalbeitrag OpenClaw auf Microsoft Teams, die Federated-Methoden hinter den Auth-Schlüsseln erklärt der Beitrag zur Microsoft-Teams-Authentifizierung in OpenClaw.

IDs statt Namen

Drei Schlüssel der Liste teilen ein Prinzip: Objekt-IDs sind stabil, Namen nicht, daher sollten Zulassungslisten, Freigaben und Ziele die ID tragen, und der Schalter für den Namensabgleich existiert nur, um eine alte Installation während ihrer Migration am Leben zu halten. Die Berechtigungen, die die Graph-gestützten Helfer brauchen, behandelt der Beitrag zu Manifest und Berechtigungen für Microsoft Teams in OpenClaw, die kanalübergreifenden Regeln für Gruppenkonversationen, die diese Overrides verfeinern, der Beitrag zu Gruppenchats in OpenClaw.

Auf Diali

Microsoft Teams gehört derzeit nicht zu den Kanälen, die Diali anbindet: WhatsApp, Telegram, Discord, Slack, Mattermost, Matrix, SMS und Sprache. Der Assistent ist gehostetes OpenClaw auf Diali, und die Anleitung zum Verbinden Ihres ersten Kanals zeigt die Kanäle, die Sie in fünf Minuten verbinden können.

• Nur Auth-Schlüssel kommen aus der Umgebung; der Rest steht in der Konfiguration.
• Der Thread-Kontext bringt die Ausgangsnachricht und fünfzig Antworten, nie deren Befehle.
• 4000 Zeichen pro Chunk, fest gedeckelt.