Microsoft Teams

​

Dołączony Plugin

openclaw plugins install @openclaw/msteams

openclaw plugins install ./path/to/local/msteams-plugin

​

Szybka konfiguracja

npm install -g @microsoft/teams.cli@preview
teams login
teams status   # verify you're logged in and see your tenant info

# One-time setup (persistent URL across sessions):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot
# Your endpoint: https://<tunnel-id>.devtunnels.ms/api/messages

teams app create \
  --name "OpenClaw" \
  --endpoint "https://<your-tunnel-url>/api/messages"

• Tworzy aplikację Entra ID (Azure AD)
• Generuje sekret klienta
• Buduje i przesyła manifest aplikacji Teams (z ikonami)
• Rejestruje bota (domyślnie zarządzanego przez Teams - subskrypcja Azure nie jest wymagana)

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<CLIENT_ID>",
      appPassword: "<CLIENT_SECRET>",
      tenantId: "<TENANT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

teams app get <teamsAppId> --install-link

teams app doctor <teamsAppId>

​

Cele

• Rozmawiaj z OpenClaw przez DM, czaty grupowe albo kanały Teams.
• Utrzymuj deterministyczny routing: odpowiedzi zawsze wracają do kanału, z którego przyszły.
• Domyślnie używaj bezpiecznego zachowania kanałów (wzmianki wymagane, chyba że skonfigurowano inaczej).

​

Zapisy konfiguracji

{
  channels: { msteams: { configWrites: false } },
}

​

Kontrola dostępu (DM + grupy)

• Domyślnie: channels.msteams.dmPolicy = "pairing". Nieznani nadawcy są ignorowani do czasu zatwierdzenia.
• channels.msteams.allowFrom powinno używać stabilnych identyfikatorów obiektów AAD albo statycznych grup dostępu nadawców, takich jak accessGroup:core-team.
• Nie polegaj na dopasowywaniu UPN/nazwy wyświetlanej w allowlistach - mogą się zmieniać. OpenClaw domyślnie wyłącza bezpośrednie dopasowywanie nazw; włącz je jawnie za pomocą channels.msteams.dangerouslyAllowNameMatching: true.
• Kreator może rozwiązywać nazwy na identyfikatory przez Microsoft Graph, gdy poświadczenia na to pozwalają.

• Domyślnie: channels.msteams.groupPolicy = "allowlist" (blokowane, chyba że dodasz groupAllowFrom). Użyj channels.defaults.groupPolicy, aby nadpisać wartość domyślną, gdy nie jest ustawiona.
• channels.msteams.groupAllowFrom kontroluje, którzy nadawcy albo statyczne grupy dostępu nadawców mogą wyzwalać w czatach grupowych/kanałach (cofa się do channels.msteams.allowFrom).
• Ustaw groupPolicy: "open", aby zezwolić dowolnemu członkowi (domyślnie nadal z bramkowaniem przez wzmiankę).
• Aby nie zezwalać na żadne kanały, ustaw channels.msteams.groupPolicy: "disabled".

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["00000000-0000-0000-0000-000000000000", "accessGroup:core-team"],
    },
  },
}

• Ograniczaj odpowiedzi grup/kanałów przez listowanie zespołów i kanałów pod channels.msteams.teams.
• Klucze powinny używać stabilnych identyfikatorów konwersacji Teams z linków Teams, a nie zmiennych nazw wyświetlanych.
• Gdy groupPolicy="allowlist" i istnieje allowlista zespołów, akceptowane są tylko wymienione zespoły/kanały (z bramkowaniem przez wzmiankę).
• Kreator konfiguracji akceptuje wpisy Team/Channel i zapisuje je za Ciebie.
• Przy starcie OpenClaw rozwiązuje nazwy zespołów/kanałów i allowlisty użytkowników na identyfikatory (gdy pozwalają na to uprawnienia Graph) i loguje mapowanie; nierozwiązane nazwy zespołów/kanałów są zachowywane tak, jak je wpisano, ale domyślnie ignorowane dla routingu, chyba że włączono channels.msteams.dangerouslyAllowNameMatching: true.

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      teams: {
        "My Team": {
          channels: {
            General: { requireMention: true },
          },
        },
      },
    },
  },
}

​

Uwierzytelnianie federacyjne (certyfikat plus tożsamość zarządzana)

Dodano w 2026.4.11

​

Opcja A: Uwierzytelnianie oparte na certyfikacie

1. Wygeneruj albo uzyskaj certyfikat (format PEM z kluczem prywatnym).
2. W Entra ID → App Registration → Certificates & secrets → Certificates → prześlij certyfikat publiczny.

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      certificatePath: "/path/to/cert.pem",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_CERTIFICATE_PATH=/path/to/cert.pem

​

Opcja B: Azure Managed Identity

1. Pod/VM bota ma tożsamość zarządzaną (przypisaną systemowo albo przypisaną przez użytkownika).
2. Poświadczenie tożsamości federacyjnej łączy tożsamość zarządzaną z rejestracją aplikacji Entra ID.
3. W czasie działania OpenClaw używa @azure/identity, aby uzyskać tokeny z punktu końcowego Azure IMDS (169.254.169.254).
4. Token jest przekazywany do Teams SDK na potrzeby uwierzytelniania bota.

• Infrastruktura Azure z włączoną tożsamością zarządzaną (AKS workload identity, App Service, VM)
• Poświadczenie tożsamości federacyjnej utworzone w rejestracji aplikacji Entra ID
• Dostęp sieciowy do IMDS (169.254.169.254:80) z poda/VM

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      managedIdentityClientId: "<MI_CLIENT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id> (tylko dla przypisanej przez użytkownika)

​

Konfiguracja AKS Workload Identity

1. Włącz tożsamość obciążenia w swoim klastrze AKS.
2. Utwórz poświadczenie tożsamości federacyjnej w rejestracji aplikacji Entra ID:
   az ad app federated-credential create --id <APP_OBJECT_ID> --parameters '{
     "name": "my-bot-workload-identity",
     "issuer": "<AKS_OIDC_ISSUER_URL>",
     "subject": "system:serviceaccount:<NAMESPACE>:<SERVICE_ACCOUNT>",
     "audiences": ["api://AzureADTokenExchange"]
   }'
   
3. Dodaj adnotację do konta usługi Kubernetes z identyfikatorem klienta aplikacji:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. Oznacz pod etykietą na potrzeby wstrzyknięcia tożsamości obciążenia:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. Zapewnij dostęp sieciowy do IMDS (169.254.169.254) - jeśli używasz NetworkPolicy, dodaj regułę ruchu wychodzącego zezwalającą na ruch do 169.254.169.254/32 na porcie 80.

​

Porównanie typów uwierzytelniania

​

Rozwój lokalny (tunelowanie)

# One-time setup:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot

teams app update <teamsAppId> --endpoint "https://<new-url>/api/messages"

​

Testowanie bota

teams app doctor <teamsAppId>

1. Zainstaluj aplikację Teams (użyj linku instalacyjnego z teams app get <id> --install-link)
2. Znajdź bota w Teams i wyślij wiadomość DM
3. Sprawdź logi Gateway pod kątem przychodzącej aktywności

​

Zmienne środowiskowe

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (opcjonalnie: "secret" lub "federated")
• MSTEAMS_CERTIFICATE_PATH (federacyjne + certyfikat)
• MSTEAMS_CERTIFICATE_THUMBPRINT (opcjonalne, niewymagane do uwierzytelniania)
• MSTEAMS_USE_MANAGED_IDENTITY (federacyjne + tożsamość zarządzana)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (tylko MI przypisana przez użytkownika)

​

Akcja informacji o członku

• Uprawnienie RSC Member.Read.Group (już w zalecanym manifeście)
• Dla wyszukiwań między zespołami: uprawnienie aplikacyjne Graph User.Read.All ze zgodą administratora

​

Kontekst historii

• channels.msteams.historyLimit kontroluje, ile ostatnich wiadomości kanału/grupy jest dołączanych do promptu.
• Używa wartości zastępczej z messages.groupChat.historyLimit. Ustaw 0, aby wyłączyć (domyślnie 50).
• Pobrana historia wątku jest filtrowana przez listy dozwolonych nadawców (allowFrom / groupAllowFrom), więc inicjowanie kontekstu wątku obejmuje tylko wiadomości od dozwolonych nadawców.
• Kontekst cytowanego załącznika (ReplyTo* wyprowadzony z HTML odpowiedzi Teams) jest obecnie przekazywany w otrzymanej postaci.
• Innymi słowy, listy dozwolonych nadawców kontrolują, kto może uruchomić agenta; dziś filtrowane są tylko określone ścieżki kontekstu uzupełniającego.
• Historię DM można ograniczyć za pomocą channels.msteams.dmHistoryLimit (tury użytkownika). Nadpisania dla poszczególnych użytkowników: channels.msteams.dms["<user_id>"].historyLimit.

​

Bieżące uprawnienia RSC Teams (manifest)

• ChannelMessage.Read.Group (Application) - odbieranie wszystkich wiadomości kanału bez @wzmianki
• ChannelMessage.Send.Group (Application)
• Member.Read.Group (Application)
• Owner.Read.Group (Application)
• ChannelSettings.Read.Group (Application)
• TeamMember.Read.Group (Application)
• TeamSettings.Read.Group (Application)

• ChatMessage.Read.Chat (Application) - odbieranie wszystkich wiadomości czatu grupowego bez @wzmianki

teams app rsc add <teamsAppId> ChannelMessage.Read.Group --type Application

​

Przykładowy manifest Teams (zredagowany)

{
  $schema: "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json",
  manifestVersion: "1.23",
  version: "1.0.0",
  id: "00000000-0000-0000-0000-000000000000",
  name: { short: "OpenClaw" },
  developer: {
    name: "Your Org",
    websiteUrl: "https://example.com",
    privacyUrl: "https://example.com/privacy",
    termsOfUseUrl: "https://example.com/terms",
  },
  description: { short: "OpenClaw in Teams", full: "OpenClaw in Teams" },
  icons: { outline: "outline.png", color: "color.png" },
  accentColor: "#5B6DEF",
  bots: [
    {
      botId: "11111111-1111-1111-1111-111111111111",
      scopes: ["personal", "team", "groupChat"],
      isNotificationOnly: false,
      supportsCalling: false,
      supportsVideo: false,
      supportsFiles: true,
    },
  ],
  webApplicationInfo: {
    id: "11111111-1111-1111-1111-111111111111",
  },
  authorization: {
    permissions: {
      resourceSpecific: [
        { name: "ChannelMessage.Read.Group", type: "Application" },
        { name: "ChannelMessage.Send.Group", type: "Application" },
        { name: "Member.Read.Group", type: "Application" },
        { name: "Owner.Read.Group", type: "Application" },
        { name: "ChannelSettings.Read.Group", type: "Application" },
        { name: "TeamMember.Read.Group", type: "Application" },
        { name: "TeamSettings.Read.Group", type: "Application" },
        { name: "ChatMessage.Read.Chat", type: "Application" },
      ],
    },
  },
}

​

Zastrzeżenia dotyczące manifestu (pola obowiązkowe)

• bots[].botId musi odpowiadać identyfikatorowi Azure Bot App ID.
• webApplicationInfo.id musi odpowiadać identyfikatorowi Azure Bot App ID.
• bots[].scopes musi obejmować powierzchnie, których planujesz używać (personal, team, groupChat).
• bots[].supportsFiles: true jest wymagane do obsługi plików w zakresie osobistym.
• authorization.permissions.resourceSpecific musi obejmować odczyt/wysyłanie kanału, jeśli chcesz obsługiwać ruch kanałowy.

​

Aktualizowanie istniejącej aplikacji

# Download, edit, and re-upload the manifest
teams app manifest download <teamsAppId> manifest.json
# Edit manifest.json locally...
teams app manifest upload manifest.json <teamsAppId>
# Version is auto-bumped if content changed

​

Możliwości: tylko RSC vs Graph

​

Z samym Teams RSC (aplikacja zainstalowana, bez uprawnień Graph API)

• Odczyt treści tekstowej wiadomości kanału.
• Wysyłanie treści tekstowej wiadomości kanału.
• Odbieranie załączników plików w osobistych (DM).

• Obrazy lub zawartość plików w kanale/grupie (ładunek zawiera tylko atrapę HTML).
• Pobieranie załączników przechowywanych w SharePoint/OneDrive.
• Odczytywanie historii wiadomości (poza zdarzeniem Webhook na żywo).

​

Z Teams RSC + uprawnieniami aplikacyjnymi Microsoft Graph

• Pobieranie hostowanej zawartości (obrazów wklejonych do wiadomości).
• Pobieranie załączników plików przechowywanych w SharePoint/OneDrive.
• Odczytywanie historii wiadomości kanału/czatu przez Graph.

​

RSC vs Graph API

​

Multimedia + historia z włączonym Graph (wymagane dla kanałów)

1. W Rejestracji aplikacji Entra ID (Azure AD) dodaj uprawnienia aplikacyjne Microsoft Graph:
   • ChannelMessage.Read.All (załączniki kanału + historia)
   • Chat.Read.All lub ChatMessage.Read.All (czaty grupowe)
2. Udziel zgody administratora dla dzierżawy.
3. Podbij wersję manifestu aplikacji Teams, prześlij ponownie i zainstaluj aplikację ponownie w Teams.
4. Całkowicie zamknij i uruchom ponownie Teams, aby wyczyścić zbuforowane metadane aplikacji.

​

Znane ograniczenia

​

Limity czasu Webhook

• Limity czasu Gateway
• Ponowne wysyłanie wiadomości przez Teams (powodujące duplikaty)
• Porzucone odpowiedzi

​

Obsługa chmury Teams i adresu URL usługi

• channels.msteams.cloud wybiera preset chmury Teams SDK dla uwierzytelniania, walidacji JWT, usług tokenów i zakresu Graph.
• channels.msteams.serviceUrl wybiera granicę punktu końcowego Bot Connector używaną do walidowania przechowywanych odwołań do konwersacji przed proaktywnym wysyłaniem, edycjami, usuwaniem, kartami, ankietami, komunikatami zgody na pliki i kolejkowanymi długotrwałymi odpowiedziami. Jest wymagane dla chmur SDK USGov i DoD. Dla China/21Vianet OpenClaw używa presetu SDK China i akceptuje przechowywane/skonfigurowane adresy URL usług tylko na hostach kanału Azure China Bot Framework.

{
  "channels": {
    "msteams": {
      "serviceUrl": "https://smba.infra.gcc.teams.microsoft.com/teams"
    }
  }
}

{
  "channels": {
    "msteams": {
      "cloud": "USGov",
      "serviceUrl": "https://smba.infra.gov.teams.microsoft.us/teams"
    }
  }
}

​

Formatowanie

• Podstawowe formatowanie działa: pogrubienie, kursywa, code, linki
• Złożony markdown (tabele, zagnieżdżone listy) może nie renderować się poprawnie
• Adaptive Cards są obsługiwane dla ankiet i semantycznych wysyłek prezentacyjnych (zobacz poniżej)

​

Konfiguracja

• channels.msteams.enabled: włącz/wyłącz kanał.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: poświadczenia bota.
• channels.msteams.cloud: środowisko chmury Teams SDK (Public, USGov, USGovDoD lub China; domyślnie Public). Ustaw to z serviceUrl dla chmur SDK USGov/DoD; China używa presetu SDK i przechowywanych odwołań do konwersacji Azure China Bot Framework, z pomocnikami opartymi na Graph wyłączonymi do czasu wdrożenia routingu Azure China Graph.
• channels.msteams.serviceUrl: granica adresu URL usługi Bot Connector dla proaktywnych operacji SDK. Chmura publiczna używa domyślnej wartości SDK; ustaw to dla GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High lub DoD. China akceptuje hosty kanału Azure China Bot Framework, gdy przechowywane odwołanie do konwersacji pochodzi z Teams obsługiwanego przez 21Vianet.
• channels.msteams.webhook.port (domyślnie 3978)
• channels.msteams.webhook.path (domyślnie /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (domyślnie: pairing)
• channels.msteams.allowFrom: lista dozwolonych DM (zalecane identyfikatory obiektów AAD). Kreator rozwiązuje nazwy na identyfikatory podczas konfiguracji, gdy dostęp do Graph jest dostępny.
• channels.msteams.dangerouslyAllowNameMatching: przełącznik awaryjny ponownie włączający dopasowywanie zmiennych UPN/nazw wyświetlanych i bezpośrednie routowanie nazw zespołów/kanałów.
• channels.msteams.textChunkLimit: rozmiar fragmentu tekstu wychodzącego.
• channels.msteams.chunkMode: length (domyślnie) lub newline, aby dzielić po pustych liniach (granicach akapitów) przed dzieleniem według długości.
• channels.msteams.mediaAllowHosts: lista dozwolonych hostów załączników przychodzących (domyślnie domeny Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: lista dozwolonych hostów do dołączania nagłówków Authorization przy ponowieniach mediów (domyślnie hosty Graph + Bot Framework).
• channels.msteams.requireMention: wymagaj @wzmianki w kanałach/grupach (domyślnie true).
• channels.msteams.replyStyle: thread | top-level (zobacz Styl odpowiedzi).
• channels.msteams.teams.<teamId>.replyStyle: nadpisanie dla zespołu.
• channels.msteams.teams.<teamId>.requireMention: nadpisanie dla zespołu.
• channels.msteams.teams.<teamId>.tools: domyślne nadpisania zasad narzędzi dla zespołu (allow/deny/alsoAllow) używane, gdy brakuje nadpisania kanału.
• channels.msteams.teams.<teamId>.toolsBySender: domyślne nadpisania zasad narzędzi dla zespołu i nadawcy (obsługiwany symbol wieloznaczny "*").
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: nadpisanie dla kanału.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: nadpisanie dla kanału.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: nadpisania zasad narzędzi dla kanału (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: nadpisania zasad narzędzi dla kanału i nadawcy (obsługiwany symbol wieloznaczny "*").
• Klucze toolsBySender powinny używać jawnych prefiksów: channel:, id:, e164:, username:, name: (starsze klucze bez prefiksu nadal mapują się tylko na id:).
• channels.msteams.actions.memberInfo: włącz lub wyłącz akcję informacji o członku opartą na Graph (domyślnie: włączona, gdy poświadczenia Graph są dostępne).
• channels.msteams.authType: typ uwierzytelniania - "secret" (domyślnie) lub "federated".
• channels.msteams.certificatePath: ścieżka do pliku certyfikatu PEM (federated + uwierzytelnianie certyfikatem).
• channels.msteams.certificateThumbprint: odcisk palca certyfikatu (opcjonalny, niewymagany do uwierzytelniania).
• channels.msteams.useManagedIdentity: włącz uwierzytelnianie managed identity (tryb federated).
• channels.msteams.managedIdentityClientId: identyfikator klienta dla managed identity przypisanej przez użytkownika.
• channels.msteams.sharePointSiteId: identyfikator witryny SharePoint do przesyłania plików w czatach grupowych/kanałach (zobacz Wysyłanie plików w czatach grupowych).

​

Routing i sesje

• Klucze sesji używają standardowego formatu agenta (zobacz /concepts/session):
  • Wiadomości bezpośrednie współdzielą główną sesję (agent:<agentId>:<mainKey>).
  • Wiadomości kanału/grupy używają identyfikatora konwersacji:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Styl odpowiedzi: wątki a posty

• thread w kanale w stylu Wątków → odpowiedzi pojawiają się niezgrabnie zagnieżdżone
• top-level w kanale w stylu Postów → odpowiedzi pojawiają się jako osobne posty najwyższego poziomu zamiast w wątku

{
  channels: {
    msteams: {
      replyStyle: "thread",
      teams: {
        "19:abc...@thread.tacv2": {
          channels: {
            "19:xyz...@thread.tacv2": {
              replyStyle: "top-level",
            },
          },
        },
      },
    },
  },
}

​

Kolejność rozstrzygania

1. Dla kanału — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Dla zespołu — channels.msteams.teams.<teamId>.replyStyle
3. Globalne — channels.msteams.replyStyle
4. Niejawna wartość domyślna — wyprowadzana z requireMention:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Zachowanie kontekstu wątku

​

Załączniki i obrazy

• DM: Obrazy i załączniki plików działają przez interfejsy API plików bota Teams.
• Kanały/grupy: Załączniki znajdują się w magazynie M365 (SharePoint/OneDrive). Ładunek webhook zawiera tylko zaślepkę HTML, a nie rzeczywiste bajty pliku. Uprawnienia Graph API są wymagane do pobierania załączników kanału.
• W przypadku jawnych wysyłek z plikiem jako pierwszym elementem użyj action=upload-file z media / filePath / path; opcjonalne message staje się towarzyszącym tekstem/komentarzem, a filename nadpisuje przesyłaną nazwę.

​

Wysyłanie plików w czatach grupowych

​

Dlaczego czaty grupowe wymagają SharePoint

​

Konfiguracja

1. Dodaj uprawnienia Graph API w Entra ID (Azure AD) → Rejestracja aplikacji:
   • Sites.ReadWrite.All (Application) - przesyłanie plików do SharePoint
   • Chat.Read.All (Application) - opcjonalne, włącza linki udostępniania dla poszczególnych użytkowników
2. Udziel zgody administratora dla dzierżawy.
3. Uzyskaj identyfikator witryny SharePoint:
   # Via Graph Explorer or curl with a valid token:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Example: for a site at "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Response includes: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. Skonfiguruj OpenClaw:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Zachowanie udostępniania

​

Zachowanie awaryjne

​

Lokalizacja przechowywania plików

​

Ankiety (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Głosy są rejestrowane przez gateway w stanie pluginu OpenClaw SQLite pod state/openclaw.sqlite.
• Istniejące pliki msteams-polls.json są importowane przez openclaw doctor --fix, a nie przez działający plugin.
• Gateway musi pozostać online, aby rejestrować głosy.
• Ankiety nie publikują jeszcze automatycznie podsumowań wyników i nie ma jeszcze obsługiwanego CLI wyników ankiet.

​

Karty prezentacji

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello!"}]}'

​

Formaty celów

# Send to a user by ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Send to a user by display name (triggers Graph API lookup)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Send to a group chat or channel
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# Send a presentation card to a conversation
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "Hello!",
}

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello" }],
  },
}

​

Wiadomości proaktywne

• Wiadomości proaktywne są możliwe tylko po interakcji użytkownika, ponieważ w tym momencie zapisujemy odwołania do konwersacji.
• Zobacz /gateway/configuration, aby uzyskać informacje o dmPolicy i bramkowaniu przez listę dozwolonych.

​

Identyfikatory zespołu i kanału (częsta pułapka)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Team conversation ID (URL-decode this)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Channel ID (URL-decode this)

• Klucz zespołu = segment ścieżki po /team/ (po dekodowaniu URL, np. 19:Bk4j...@thread.tacv2; starsze dzierżawy mogą pokazywać @thread.skype, co także jest prawidłowe)
• Klucz kanału = segment ścieżki po /channel/ (po dekodowaniu URL)
• Ignoruj parametr zapytania groupId dla routingu OpenClaw. Jest to identyfikator grupy Microsoft Entra, a nie identyfikator konwersacji Bot Framework używany w przychodzących aktywnościach Teams.

​

Kanały prywatne

1. Użyj kanałów standardowych do interakcji z botem
2. Użyj DM - użytkownicy zawsze mogą wysłać wiadomość bezpośrednio do bota
3. Użyj Graph API do dostępu historycznego (wymaga ChannelMessage.Read.All)

​

Rozwiązywanie problemów

​

Typowe problemy

• Obrazy nie wyświetlają się w kanałach: Brakuje uprawnień Graph lub zgody administratora. Zainstaluj ponownie aplikację Teams i całkowicie zamknij/otwórz ponownie Teams.
• Brak odpowiedzi w kanale: wzmianki są domyślnie wymagane; ustaw channels.msteams.requireMention=false albo skonfiguruj dla zespołu/kanału.
• Niezgodność wersji (Teams nadal pokazuje stary manifest): usuń i ponownie dodaj aplikację oraz całkowicie zamknij Teams, aby odświeżyć.
• 401 Unauthorized z webhook: Oczekiwane przy ręcznym testowaniu bez Azure JWT - oznacza, że punkt końcowy jest osiągalny, ale uwierzytelnianie się nie powiodło. Użyj Azure Web Chat, aby przetestować poprawnie.

​

Błędy przesyłania manifestu

• “Icon file cannot be empty”: Manifest odwołuje się do plików ikon o rozmiarze 0 bajtów. Utwórz prawidłowe ikony PNG (32x32 dla outline.png, 192x192 dla color.png).
• “webApplicationInfo.Id already in use”: Aplikacja jest nadal zainstalowana w innym zespole/czacie. Najpierw ją znajdź i odinstaluj albo poczekaj 5-10 minut na propagację.
• “Something went wrong” podczas przesyłania: Zamiast tego prześlij przez https://admin.teams.microsoft.com, otwórz DevTools przeglądarki (F12) → karta Network i sprawdź treść odpowiedzi, aby zobaczyć właściwy błąd.
• Sideload nie działa: Spróbuj “Upload an app to your org’s app catalog” zamiast “Upload a custom app” - często omija to ograniczenia sideload.

​

Uprawnienia RSC nie działają

1. Sprawdź, czy webApplicationInfo.id dokładnie odpowiada identyfikatorowi App ID Twojego bota
2. Prześlij aplikację ponownie i zainstaluj ją ponownie w zespole/czacie
3. Sprawdź, czy administrator Twojej organizacji zablokował uprawnienia RSC
4. Potwierdź, że używasz właściwego zakresu: ChannelMessage.Read.Group dla zespołów, ChatMessage.Read.Chat dla czatów grupowych

​

Odnośniki

• Utwórz Azure Bot - przewodnik konfiguracji Azure Bot
• Teams Developer Portal - tworzenie aplikacji Teams i zarządzanie nimi
• Schemat manifestu aplikacji Teams
• Odbieranie wiadomości z kanałów za pomocą RSC
• Dokumentacja uprawnień RSC
• Obsługa plików przez bota Teams (kanał/grupa wymaga Graph)
• Wiadomości proaktywne
• @microsoft/teams.cli - Teams CLI do zarządzania botami

​

Powiązane

• Przegląd kanałów - wszystkie obsługiwane kanały
• Parowanie - uwierzytelnianie przez DM i proces parowania
• Grupy - zachowanie czatu grupowego i bramkowanie wzmianek
• Routing kanałów - routing sesji dla wiadomości
• Bezpieczeństwo - model dostępu i utwardzanie