Microsoft Teams

​

Встроенный plugin

openclaw plugins install @openclaw/msteams

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

​

Быстрая настройка

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"

• Создает приложение Entra ID (Azure AD)
• Генерирует клиентский секрет
• Собирает и загружает манифест приложения Teams (с иконками)
• Регистрирует бота (по умолчанию управляется Teams - подписка Azure не нужна)

{
  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>

​

Цели

• Общаться с OpenClaw через личные сообщения Teams, групповые чаты или каналы.
• Сохранять детерминированную маршрутизацию: ответы всегда возвращаются в тот канал, откуда пришли.
• По умолчанию использовать безопасное поведение канала (упоминания обязательны, если не настроено иначе).

​

Запись конфигурации

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

​

Контроль доступа (личные сообщения + группы)

• По умолчанию: channels.msteams.dmPolicy = "pairing". Неизвестные отправители игнорируются до одобрения.
• channels.msteams.allowFrom должен использовать стабильные object ID AAD или статические группы доступа отправителей, такие как accessGroup:core-team.
• Не полагайтесь на сопоставление UPN/отображаемого имени для allowlist - они могут измениться. OpenClaw по умолчанию отключает прямое сопоставление имен; включайте его явно через channels.msteams.dangerouslyAllowNameMatching: true.
• Мастер может разрешать имена в ID через Microsoft Graph, если учетные данные позволяют.

• По умолчанию: channels.msteams.groupPolicy = "allowlist" (заблокировано, если не добавить groupAllowFrom). Используйте channels.defaults.groupPolicy, чтобы переопределить значение по умолчанию, когда оно не задано.
• channels.msteams.groupAllowFrom управляет тем, какие отправители или статические группы доступа отправителей могут запускать действия в групповых чатах/каналах (с fallback к channels.msteams.allowFrom).
• Задайте groupPolicy: "open", чтобы разрешить любого участника (по умолчанию все еще требуется упоминание).
• Чтобы не разрешать никакие каналы, задайте channels.msteams.groupPolicy: "disabled".

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

• Ограничивайте ответы групп/каналов, перечисляя команды и каналы в channels.msteams.teams.
• Ключи должны использовать стабильные ID бесед Teams из ссылок Teams, а не изменяемые отображаемые имена.
• Когда groupPolicy="allowlist" и присутствует allowlist команд, принимаются только перечисленные команды/каналы (с обязательным упоминанием).
• Мастер настройки принимает записи Team/Channel и сохраняет их за вас.
• При запуске OpenClaw разрешает имена team/channel и пользовательские имена allowlist в ID (когда разрешения Graph позволяют) и логирует сопоставление; неразрешенные имена team/channel сохраняются как введены, но по умолчанию игнорируются при маршрутизации, если не включено channels.msteams.dangerouslyAllowNameMatching: true.

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

​

Федеративная аутентификация (сертификат плюс managed identity)

Добавлено в 2026.4.11

​

Вариант A: Аутентификация на основе сертификата

1. Сгенерируйте или получите сертификат (формат PEM с приватным ключом).
2. В Entra ID → App Registration → Certificates & secrets → Certificates → загрузите публичный сертификат.

{
  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

​

Вариант B: Azure Managed Identity

1. У pod/VM бота есть managed identity (назначенная системой или назначенная пользователем).
2. Federated identity credential связывает managed identity с регистрацией приложения Entra ID.
3. Во время выполнения OpenClaw использует @azure/identity, чтобы получать токены из Azure IMDS endpoint (169.254.169.254).
4. Токен передается в Teams SDK для аутентификации бота.

• Инфраструктура Azure с включенной managed identity (AKS workload identity, App Service, VM)
• Federated identity credential, созданный в регистрации приложения Entra ID
• Сетевой доступ к IMDS (169.254.169.254:80) из pod/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> (только для назначенного пользователем)

​

Настройка AKS Workload Identity

1. Включите Workload Identity в кластере AKS.
2. Создайте учетные данные федеративного удостоверения в регистрации приложения 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. Добавьте аннотацию к сервисной учетной записи Kubernetes с идентификатором клиента приложения:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. Добавьте метку к pod для внедрения Workload Identity:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. Убедитесь, что есть сетевой доступ к IMDS (169.254.169.254) - если используется NetworkPolicy, добавьте правило исходящего трафика, разрешающее трафик к 169.254.169.254/32 на порту 80.

​

Сравнение типов аутентификации

​

Локальная разработка (туннелирование)

# 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"

​

Тестирование бота

teams app doctor <teamsAppId>

1. Установите приложение Teams (используйте ссылку установки из teams app get <id> --install-link)
2. Найдите бота в Teams и отправьте личное сообщение
3. Проверьте журналы Gateway на наличие входящей активности

​

Переменные окружения

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (необязательно: "secret" или "federated")
• MSTEAMS_CERTIFICATE_PATH (федеративная аутентификация + сертификат)
• MSTEAMS_CERTIFICATE_THUMBPRINT (необязательно, не требуется для аутентификации)
• MSTEAMS_USE_MANAGED_IDENTITY (федеративная аутентификация + управляемое удостоверение)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (только MI, назначенное пользователем)

​

Действие сведений об участнике

• Разрешение RSC Member.Read.Group (уже включено в рекомендуемый манифест)
• Для поиска между командами: разрешение приложения Graph User.Read.All с согласием администратора

​

Контекст истории

• channels.msteams.historyLimit управляет тем, сколько недавних сообщений канала/группы добавляется в промпт.
• Используется резервное значение messages.groupChat.historyLimit. Установите 0, чтобы отключить (по умолчанию 50).
• Полученная история треда фильтруется по спискам разрешенных отправителей (allowFrom / groupAllowFrom), поэтому начальное заполнение контекста треда включает только сообщения от разрешенных отправителей.
• Контекст цитированных вложений (ReplyTo*, полученный из HTML ответа Teams) сейчас передается как получен.
• Иными словами, списки разрешений определяют, кто может запускать агента; на сегодня фильтруются только отдельные пути дополнительного контекста.
• Историю личных сообщений можно ограничить через channels.msteams.dmHistoryLimit (ходы пользователя). Переопределения для отдельных пользователей: channels.msteams.dms["<user_id>"].historyLimit.

​

Текущие разрешения Teams RSC (манифест)

• ChannelMessage.Read.Group (Application) - получать все сообщения канала без @упоминания
• 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) - получать все сообщения группового чата без @упоминания

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

​

Пример манифеста Teams (с редактированными данными)

{
  $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" },
      ],
    },
  },
}

​

Особенности манифеста (обязательные поля)

• bots[].botId должен совпадать с Azure Bot App ID.
• webApplicationInfo.id должен совпадать с Azure Bot App ID.
• bots[].scopes должен включать поверхности, которые вы планируете использовать (personal, team, groupChat).
• bots[].supportsFiles: true требуется для обработки файлов в личной области.
• authorization.permissions.resourceSpecific должен включать чтение/отправку канала, если нужен трафик канала.

​

Обновление существующего приложения

# 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

​

Возможности: только RSC или Graph

​

С только Teams RSC (приложение установлено, разрешений Graph API нет)

• Чтение текстового содержимого сообщений канала.
• Отправка текстового содержимого сообщений канала.
• Получение файловых вложений в личных сообщениях (DM).

• Содержимое изображений или файлов в каналах/группах (полезная нагрузка включает только HTML-заглушку).
• Скачивание вложений, хранящихся в SharePoint/OneDrive.
• Чтение истории сообщений (помимо события Webhook в реальном времени).

​

С Teams RSC + разрешениями приложения Microsoft Graph

• Скачивание размещенного содержимого (изображений, вставленных в сообщения).
• Скачивание файловых вложений, хранящихся в SharePoint/OneDrive.
• Чтение истории сообщений канала/чата через Graph.

​

RSC и Graph API

​

Медиа и история с поддержкой Graph (обязательно для каналов)

1. В регистрации приложения Entra ID (Azure AD) добавьте разрешения приложения Microsoft Graph:
   • ChannelMessage.Read.All (вложения канала + история)
   • Chat.Read.All или ChatMessage.Read.All (групповые чаты)
2. Предоставьте согласие администратора для тенанта.
3. Увеличьте версию манифеста приложения Teams, загрузите его заново и переустановите приложение в Teams.
4. Полностью завершите работу Teams и запустите его заново, чтобы очистить кэшированные метаданные приложения.

​

Известные ограничения

​

Тайм-ауты Webhook

• Тайм-ауты Gateway
• Повторную отправку сообщения Teams (вызывает дубликаты)
• Потерянные ответы

​

Поддержка облака Teams и URL службы

• channels.msteams.cloud выбирает облачный пресет Teams SDK для аутентификации, проверки JWT, служб токенов и области Graph.
• channels.msteams.serviceUrl выбирает границу конечной точки Bot Connector, используемую для проверки сохраненных ссылок на беседу перед проактивными отправками, редактированиями, удалениями, карточками, опросами, сообщениями согласия на файлы и поставленными в очередь долгими ответами. Она обязательна для облаков SDK USGov и DoD. Для China/21Vianet OpenClaw использует пресет SDK China и принимает сохраненные/настроенные URL служб только на хостах каналов 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"
    }
  }
}

​

Форматирование

• Базовое форматирование работает: жирный, курсив, code, ссылки
• Сложный markdown (таблицы, вложенные списки) может отображаться некорректно
• Adaptive Cards поддерживаются для опросов и семантических отправок представления (см. ниже)

​

Конфигурация

• channels.msteams.enabled: включить/отключить канал.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: учетные данные бота.
• channels.msteams.cloud: облачная среда Teams SDK (Public, USGov, USGovDoD или China; по умолчанию Public). Задавайте это вместе с serviceUrl для облаков SDK USGov/DoD; China использует пресет SDK и сохраненные ссылки на беседы Azure China Bot Framework, а вспомогательные функции на базе Graph отключены, пока не будет реализована маршрутизация Azure China Graph.
• channels.msteams.serviceUrl: граница URL службы Bot Connector для проактивных операций SDK. Общедоступное облако использует значение SDK по умолчанию; задайте это для GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High или DoD. China принимает хосты каналов Azure China Bot Framework, когда сохраненная ссылка на беседу приходит из Teams, управляемого 21Vianet.
• channels.msteams.webhook.port (по умолчанию 3978)
• channels.msteams.webhook.path (по умолчанию /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (по умолчанию: pairing)
• channels.msteams.allowFrom: список разрешений для личных сообщений (рекомендуются object ID AAD). Мастер во время настройки преобразует имена в ID, когда доступен Graph.
• channels.msteams.dangerouslyAllowNameMatching: аварийный переключатель для повторного включения сопоставления по изменяемому UPN/отображаемому имени и прямой маршрутизации по имени команды/канала.
• channels.msteams.textChunkLimit: размер фрагмента исходящего текста.
• channels.msteams.chunkMode: length (по умолчанию) или newline, чтобы разбивать по пустым строкам (границам абзацев) перед разбиением по длине.
• channels.msteams.mediaAllowHosts: список разрешенных хостов для входящих вложений (по умолчанию домены Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: список разрешенных хостов для добавления заголовков Authorization при повторных попытках загрузки медиа (по умолчанию хосты Graph + Bot Framework).
• channels.msteams.requireMention: требовать @упоминание в каналах/группах (по умолчанию true).
• channels.msteams.replyStyle: thread | top-level (см. Стиль ответа).
• channels.msteams.teams.<teamId>.replyStyle: переопределение для отдельной команды.
• channels.msteams.teams.<teamId>.requireMention: переопределение для отдельной команды.
• channels.msteams.teams.<teamId>.tools: переопределения политики инструментов по умолчанию для отдельной команды (allow/deny/alsoAllow), используемые, когда переопределение канала отсутствует.
• channels.msteams.teams.<teamId>.toolsBySender: переопределения политики инструментов по отправителю по умолчанию для отдельной команды (поддерживается wildcard "*").
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: переопределение для отдельного канала.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: переопределение для отдельного канала.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: переопределения политики инструментов для отдельного канала (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: переопределения политики инструментов по отправителю для отдельного канала (поддерживается wildcard "*").
• Ключи toolsBySender должны использовать явные префиксы: channel:, id:, e164:, username:, name: (устаревшие ключи без префикса по-прежнему сопоставляются только с id:).
• channels.msteams.actions.memberInfo: включить или отключить действие сведений об участнике на базе Graph (по умолчанию включено, когда доступны учетные данные Graph).
• channels.msteams.authType: тип аутентификации - "secret" (по умолчанию) или "federated".
• channels.msteams.certificatePath: путь к PEM-файлу сертификата (federated + certificate auth).
• channels.msteams.certificateThumbprint: отпечаток сертификата (необязательно, не требуется для аутентификации).
• channels.msteams.useManagedIdentity: включить аутентификацию managed identity (режим federated).
• channels.msteams.managedIdentityClientId: client ID для назначаемого пользователем managed identity.
• channels.msteams.sharePointSiteId: ID сайта SharePoint для загрузки файлов в групповых чатах/каналах (см. Отправка файлов в групповых чатах).

​

Маршрутизация и сеансы

• Ключи сеансов следуют стандартному формату агента (см. /concepts/session):
  • Личные сообщения используют общий основной сеанс (agent:<agentId>:<mainKey>).
  • Сообщения каналов/групп используют id беседы:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Стиль ответа: потоки или публикации

• thread в канале со стилем Threads → ответы выглядят неудачно вложенными
• top-level в канале со стилем Posts → ответы отображаются как отдельные публикации верхнего уровня, а не внутри потока

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

​

Приоритет разрешения

1. Для канала — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Для команды — channels.msteams.teams.<teamId>.replyStyle
3. Глобально — channels.msteams.replyStyle
4. Неявное значение по умолчанию — выводится из requireMention:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Сохранение контекста потока

​

Вложения и изображения

• Личные сообщения: изображения и файловые вложения работают через файловые API бота Teams.
• Каналы/группы: вложения находятся в хранилище M365 (SharePoint/OneDrive). Полезная нагрузка webhook содержит только HTML-заглушку, а не фактические байты файла. Для скачивания вложений канала требуются разрешения Graph API.
• Для явной отправки, где файл идет первым, используйте action=upload-file с media / filePath / path; необязательный message становится сопроводительным текстом/комментарием, а filename переопределяет имя загруженного файла.

​

Отправка файлов в групповые чаты

​

Почему для групповых чатов нужен SharePoint

​

Настройка

1. Добавьте разрешения Graph API в Entra ID (Azure AD) → регистрация приложения:
   • Sites.ReadWrite.All (Application) - загрузка файлов в SharePoint
   • Chat.Read.All (Application) - необязательно, включает ссылки общего доступа для отдельных пользователей
2. Предоставьте согласие администратора для арендатора.
3. Получите ID сайта 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. Настройте OpenClaw:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Поведение общего доступа

​

Резервное поведение

​

Расположение сохраненных файлов

​

Опросы (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Голоса записываются Gateway в SQLite состояния Plugin OpenClaw по пути state/openclaw.sqlite.
• Существующие файлы msteams-polls.json импортируются командой openclaw doctor --fix, а не работающим Plugin.
• Gateway должен оставаться онлайн, чтобы записывать голоса.
• Опросы пока не публикуют сводки результатов автоматически, и поддерживаемого CLI для результатов опросов пока нет.

​

Карточки представления

{
  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!"}]}'

​

Форматы целей

# 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" }],
  },
}

​

Проактивные сообщения

• Проактивные сообщения возможны только после взаимодействия пользователя, потому что в этот момент мы сохраняем ссылки на беседы.
• См. /gateway/configuration для dmPolicy и ограничения по списку разрешенных.

​

ID команды и канала (частая ошибка)

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)

• Ключ команды = сегмент пути после /team/ (после URL-декодирования, например 19:Bk4j...@thread.tacv2; в старых арендаторах может отображаться @thread.skype, это тоже допустимо)
• Ключ канала = сегмент пути после /channel/ (после URL-декодирования)
• Игнорируйте параметр запроса groupId для маршрутизации OpenClaw. Это ID группы Microsoft Entra, а не ID беседы Bot Framework, используемый во входящих активностях Teams.

​

Закрытые каналы

1. Используйте стандартные каналы для взаимодействий с ботом
2. Используйте личные сообщения - пользователи всегда могут написать боту напрямую
3. Используйте Graph API для доступа к истории (требуется ChannelMessage.Read.All)

​

Устранение неполадок

​

Распространенные проблемы

• Изображения не отображаются в каналах: отсутствуют разрешения Graph или согласие администратора. Переустановите приложение Teams и полностью закройте/откройте Teams заново.
• Нет ответов в канале: по умолчанию требуются упоминания; задайте channels.msteams.requireMention=false или настройте для конкретной команды/канала.
• Несоответствие версии (Teams все еще показывает старый манифест): удалите и заново добавьте приложение, затем полностью закройте Teams, чтобы обновить состояние.
• 401 Unauthorized от webhook: ожидаемо при ручном тестировании без Azure JWT - означает, что конечная точка доступна, но авторизация не прошла. Используйте Azure Web Chat для корректного тестирования.

​

Ошибки загрузки манифеста

• “Icon file cannot be empty”: манифест ссылается на файлы значков размером 0 байт. Создайте корректные PNG-значки (32x32 для outline.png, 192x192 для color.png).
• “webApplicationInfo.Id already in use”: приложение все еще установлено в другой команде/чате. Сначала найдите и удалите его или подождите 5-10 минут для распространения изменений.
• “Something went wrong” при загрузке: вместо этого загрузите через https://admin.teams.microsoft.com, откройте DevTools браузера (F12) → вкладку Network и проверьте тело ответа с фактической ошибкой.
• Сбой sideload: попробуйте “Upload an app to your org’s app catalog” вместо “Upload a custom app” - это часто обходит ограничения sideload.

​

Разрешения RSC не работают

1. Убедитесь, что webApplicationInfo.id точно совпадает с App ID вашего бота
2. Повторно загрузите приложение и переустановите его в команде/чате
3. Проверьте, не заблокировал ли администратор вашей организации разрешения RSC
4. Подтвердите, что используете правильную область: ChannelMessage.Read.Group для команд, ChatMessage.Read.Chat для групповых чатов

​

Ссылки

• Создание Azure Bot - руководство по настройке Azure Bot
• Портал разработчика Teams - создание и управление приложениями Teams
• Схема манифеста приложения Teams
• Получение сообщений каналов с RSC
• Справочник разрешений RSC
• Обработка файлов ботом Teams (для канала/группы требуется Graph)
• Проактивные сообщения
• @microsoft/teams.cli - Teams CLI для управления ботами

​

Связанные материалы

• Обзор каналов - все поддерживаемые каналы
• Сопряжение - аутентификация в DM и процесс сопряжения
• Группы - поведение групповых чатов и ограничение по упоминаниям
• Маршрутизация каналов - маршрутизация сеансов для сообщений
• Безопасность - модель доступа и усиление защиты