Microsoft Teams

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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ądzany przez Teams - subskrypcja Azure nie jest potrzebna)

{
  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 lub kanały Teams.
• Zachowaj deterministyczny routing: odpowiedzi zawsze wracają do kanału, z którego przyszły.
• Domyślnie stosuj bezpieczne zachowanie kanału (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 allowlist - mogą się zmienić. 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 pozwalają na to dane uwierzytelniające.

• Domyślnie: channels.msteams.groupPolicy = "allowlist" (zablokowane, 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 lub statyczne grupy dostępu nadawców mogą wyzwalać w czatach grupowych/kanałach (z fallbackiem do channels.msteams.allowFrom).
• Ustaw groupPolicy: "open", aby zezwolić dowolnemu członkowi (domyślnie nadal z bramkowaniem przez wzmiankę).
• Aby nie zezwolić na żadne kanały, ustaw channels.msteams.groupPolicy: "disabled".

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

• Ogranicz odpowiedzi grup/kanałów przez wypisanie zespołów i kanałów w 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 allowlist zespołów, akceptowane są tylko wypisane zespoły/kanały (z bramkowaniem przez wzmiankę).
• Kreator konfiguracji przyjmuje wpisy Team/Channel i zapisuje je za Ciebie.
• Podczas uruchamiania OpenClaw rozwiązuje nazwy zespołu/kanału i użytkowników z allowlist na identyfikatory (gdy pozwalają na to uprawnienia Graph) i zapisuje mapowanie w logach; nierozwiązane nazwy zespołu/kanału są zachowywane tak, jak wpisano, ale domyślnie ignorowane na potrzeby 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 lub 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ą przez system 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 wykonywania OpenClaw używa @azure/identity do pozyskiwania tokenów z endpointu 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 Workload Identity 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 poda etykietą na potrzeby wstrzyknięcia Workload Identity:
   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

​

Programowanie lokalne (tunelowanie)

# Jednorazowa konfiguracja:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Każda sesja deweloperska:
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ść prywatną
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 (federacyjnie + certyfikat)
• MSTEAMS_CERTIFICATE_THUMBPRINT (opcjonalne, niewymagane do uwierzytelniania)
• MSTEAMS_USE_MANAGED_IDENTITY (federacyjnie + 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 aplikacji Graph User.Read.All ze zgodą administratora

​

Kontekst historii

• channels.msteams.historyLimit kontroluje, ile ostatnich wiadomości kanału/grupy jest opakowywanych w prompt.
• Wartość zastępcza to messages.groupChat.historyLimit. Ustaw 0, aby wyłączyć (domyślnie 50).
• Pobrana historia wątku jest filtrowana według list 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 wyzwolić agenta; obecnie filtrowane są tylko określone ścieżki kontekstu uzupełniającego.
• Historię wiadomości prywatnych 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 (ocenzurowany)

{
  $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 wymagane)

• bots[].botId musi odpowiadać Azure Bot App ID.
• webApplicationInfo.id musi odpowiadać 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 zawierać odczyt/wysyłanie kanału, jeśli chcesz obsługiwać ruch w kanale.

​

Aktualizowanie istniejącej aplikacji

# Pobierz, edytuj i ponownie prześlij manifest
teams app manifest download <teamsAppId> manifest.json
# Edytuj manifest.json lokalnie...
teams app manifest upload manifest.json <teamsAppId>
# Wersja jest automatycznie podbijana, jeśli treść się zmieniła

​

Możliwości: tylko RSC kontra Graph

​

Z użyciem tylko Teams RSC (aplikacja zainstalowana, bez uprawnień Graph API)

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

• Zawartość obrazów lub plików w kanale/grupie (ładunek zawiera tylko szkielet HTML).
• Pobieranie załączników przechowywanych w SharePoint/OneDrive.
• Odczyt historii wiadomości (poza zdarzeniem Webhook na żywo).

​

Z użyciem Teams RSC + uprawnienia aplikacji Microsoft Graph

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

​

RSC kontra Graph API

​

Media i historia z obsługą Graph (wymagane dla kanałów)

1. W rejestracji aplikacji Entra ID (Azure AD) dodaj uprawnienia aplikacji 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 ponownie zainstaluj aplikację w Teams.
4. Całkowicie zamknij i ponownie uruchom Teams, aby wyczyścić buforowane metadane aplikacji.

​

Znane ograniczenia

​

Limity czasu Webhook

• Limity czasu Gateway
• Ponawianie wiadomości przez Teams (powodujące duplikaty)
• Porzucone odpowiedzi

​

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 wysyłek prezentacji semantycznej (zobacz niżej)

​

Konfiguracja

• channels.msteams.enabled: włącz/wyłącz kanał.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: dane uwierzytelniające bota.
• 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 oraz bezpośrednie trasowanie nazw zespołów/kanałów.
• channels.msteams.textChunkLimit: rozmiar fragmentu tekstu wychodzącego.
• channels.msteams.chunkMode: length (domyślnie) albo newline, aby dzielić po pustych wierszach (granicach akapitów) przed dzieleniem według długości.
• channels.msteams.mediaAllowHosts: lista dozwolonych hostów dla przychodzących załączników (domyślnie domeny Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: lista dozwolonych hostów do dołączania nagłówków Authorization przy ponownych próbach pobierania multimedió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ą 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 dane uwierzytelniające Graph są dostępne).
• channels.msteams.authType: typ uwierzytelniania - "secret" (domyślnie) albo "federated".
• channels.msteams.certificatePath: ścieżka do pliku certyfikatu PEM (uwierzytelnianie federacyjne + certyfikatem).
• channels.msteams.certificateThumbprint: odcisk certyfikatu (opcjonalny, niewymagany do uwierzytelniania).
• channels.msteams.useManagedIdentity: włącz uwierzytelnianie tożsamością zarządzaną (tryb federacyjny).
• channels.msteams.managedIdentityClientId: identyfikator klienta dla tożsamości zarządzanej 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).

​

Trasowanie i sesje

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

​

Styl odpowiedzi: wątki kontra wpisy

• thread w kanale w stylu Wątków → odpowiedzi wyglądają niezgrabnie jako zagnieżdżone
• top-level w kanale w stylu Wpisów → odpowiedzi pojawiają się jako oddzielne wpisy 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. Globalnie — channels.msteams.replyStyle
4. Domyślne niejawne — wyprowadzone z requireMention:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Zachowanie kontekstu wątku

​

Załączniki i obrazy

• DM-y: Obrazy i załączniki plikowe 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 zaczynających się od pliku 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 użytkowników
2. Udziel zgody administratora dla dzierżawy.
3. Pobierz 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 przechowywanych plików

​

Ankiety (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Głosy są rejestrowane przez Gateway w ~/.openclaw/msteams-polls.json.
• Gateway musi pozostać online, aby rejestrować głosy.
• Ankiety nie publikują jeszcze automatycznie podsumowań wyników (w razie potrzeby sprawdź plik magazynu).

​

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łów i kanałów (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 zdekodowaniu URL, np. 19:Bk4j...@thread.tacv2; starsze dzierżawy mogą pokazywać @thread.skype, co też jest prawidłowe)
• Klucz kanału = segment ścieżki po /channel/ (po zdekodowaniu URL)
• Ignoruj parametr zapytania groupId przy 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żywaj kanałów standardowych do interakcji z botem
2. Używaj DM - użytkownicy zawsze mogą wysyłać wiadomości bezpośrednio do bota
3. Używaj 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 albo zgody administratora. Zainstaluj ponownie aplikację Teams i całkowicie zamknij oraz ponownie otwórz Teams.
• Brak odpowiedzi w kanale: wzmianki są domyślnie wymagane; ustaw channels.msteams.requireMention=false albo skonfiguruj to dla zespołu/kanału.
• Niezgodność wersji (Teams nadal pokazuje stary manifest): usuń i ponownie dodaj aplikację, a następnie całkowicie zamknij Teams, aby odświeżyć.
• 401 Unauthorized z Webhook: oczekiwane podczas ręcznego testowania 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 odczekaj 5-10 minut na propagację.
• “Something went wrong” podczas przesyłania: zamiast tego prześlij przez https://admin.teams.microsoft.com, otwórz narzędzia deweloperskie przeglądarki (F12) → karta Network i sprawdź treść odpowiedzi pod kątem rzeczywistego błędu.
• Niepowodzenie sideloadingu: spróbuj opcji “Upload an app to your org’s app catalog” zamiast “Upload a custom app” - często omija to ograniczenia sideloadingu.

​

Uprawnienia RSC nie działają

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

​

Odwołania

• Tworzenie Azure Bot - przewodnik konfiguracji Azure Bot
• Teams Developer Portal - tworzenie aplikacji Teams i zarządzanie nimi
• Schemat manifestu aplikacji Teams
• Odbieranie wiadomości kanału za pomocą RSC
• Odwołanie do 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 DM i przepływ parowania
• Grupy - zachowanie czatu grupowego i bramkowanie wzmianek
• Routing kanałów - routing sesji dla wiadomości
• Bezpieczeństwo - model dostępu i utwardzanie