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   # перевірте, що ви ввійшли, і перегляньте відомості про свій клієнт

# Одноразове налаштування (стала URL-адреса між сеансами):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Кожен сеанс розробки:
devtunnel host my-openclaw-bot
# Ваша кінцева точка: https://<tunnel-id>.devtunnels.ms/api/messages

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

{
  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 має використовувати сталі ідентифікатори об’єктів AAD або статичні групи доступу відправників, як-от accessGroup:core-team.
• Не покладайтеся на зіставлення UPN/відображуваного імені для списків дозволених користувачів; вони можуть змінюватися. OpenClaw за замовчуванням вимикає пряме зіставлення імен; увімкніть його за допомогою channels.msteams.dangerouslyAllowNameMatching: true.
• Майстер може зіставляти імена з ідентифікаторами через Microsoft Graph, якщо це дозволяють облікові дані.

• За замовчуванням: channels.msteams.groupPolicy = "allowlist" (заблоковано, доки не додано groupAllowFrom). channels.defaults.groupPolicy може перевизначити спільне значення за замовчуванням, якщо channels.msteams.groupPolicy не задано.
• channels.msteams.groupAllowFrom визначає, які відправники або статичні групи доступу відправників можуть ініціювати дії в групових чатах/каналах (у разі відсутності використовується 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.
• Використовуйте як ключі сталі ідентифікатори розмов Teams із посилань Teams, а не змінювані відображувані імена (див. Ідентифікатори команди та каналу).
• Коли наявні groupPolicy="allowlist" і список дозволених команд, приймаються лише перелічені команди/канали (з обов’язковою згадкою).
• Майстер налаштування приймає записи Team/Channel і зберігає їх.
• Під час запуску OpenClaw зіставляє назви команд/каналів та імена зі списку дозволених користувачів з ідентифікаторами (якщо це дозволяють дозволи Graph) і записує зіставлення в журнал. Нерозпізнані імена зберігаються у введеному вигляді, але ігноруються під час маршрутизації, якщо не задано channels.msteams.dangerouslyAllowNameMatching: true.

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

​

Федеративна автентифікація (сертифікат і керована ідентичність)

​

Варіант 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

1. Под/віртуальна машина бота має керовану ідентичність (призначену системою або користувачем).
2. Облікові дані федеративної ідентичності пов’язують керовану ідентичність із реєстрацією застосунку Entra ID.
3. Під час виконання OpenClaw використовує @azure/identity для отримання токенів із кінцевої точки Azure IMDS.
4. Токен передається до SDK Teams для автентифікації бота.

• Інфраструктура Azure з увімкненою керованою ідентичністю (ідентичність робочого навантаження AKS, App Service, віртуальна машина).
• Облікові дані федеративної ідентичності створено в реєстрації застосунку Entra ID.
• Мережевий доступ до IMDS (169.254.169.254:80) із пода/віртуальної машини.

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

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id> (лише для призначеної користувачем)

​

Налаштування ідентичності робочого навантаження AKS

1. Увімкніть ідентичність робочого навантаження у своєму кластері 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. Додайте мітку до пода для впровадження ідентичності робочого навантаження:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. Дозвольте мережевий доступ до IMDS (169.254.169.254): якщо використовується NetworkPolicy, додайте правило вихідного трафіку для 169.254.169.254/32 на порту 80.

​

Порівняння типів автентифікації

​

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

# Одноразове налаштування:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Кожен сеанс розробки:
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 на наявність вхідної активності.

​

Змінні середовища

​

Дія отримання відомостей про учасника

• Дозволи RSC ChannelSettings.Read.Group і TeamMember.Read.Group (уже є в рекомендованому маніфесті).

​

Контекст історії

• channels.msteams.historyLimit визначає, скільки останніх повідомлень каналу/групи додається до запиту. Якщо значення не задано, використовується messages.groupChat.historyLimit, а потім типове значення 50. Задайте 0, щоб вимкнути.
• Отримана історія гілки фільтрується за списками дозволених відправників (allowFrom / groupAllowFrom), тому початкове наповнення контексту гілки містить лише повідомлення від дозволених відправників.
• Контекст цитованих вкладень (розібраний із HTML схеми Skype Reply у власних вкладеннях відповіді) передається без фільтрації; наразі фільтр списку дозволених відправників застосовується лише до початкового наповнення історією гілки.
• Історію приватних повідомлень можна обмежити за допомогою channels.msteams.dmHistoryLimit (репліки користувача). Перевизначення для окремих користувачів: channels.msteams.dms["<user_id>"].historyLimit.

​

Поточні дозволи RSC Teams (маніфест)

• 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: "Ваша організація",
    websiteUrl: "https://example.com",
    privacyUrl: "https://example.com/privacy",
    termsOfUseUrl: "https://example.com/terms",
  },
  description: { short: "OpenClaw у Teams", full: "OpenClaw у 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.
• webApplicationInfo.id має відповідати ідентифікатору застосунку Azure Bot.
• bots[].scopes має містити поверхні, які планується використовувати (personal, team, groupChat).
• bots[].supportsFiles: true потрібне для обробки файлів у персональній області.
• authorization.permissions.resourceSpecific має містити дозволи на читання/надсилання повідомлень каналів для трафіку каналів.

​

Оновлення наявного застосунку

# Завантажте, відредагуйте та повторно передайте маніфест
teams app manifest download <teamsAppId> manifest.json
# Відредагуйте manifest.json локально...
teams app manifest upload manifest.json <teamsAppId>
# Версія збільшується автоматично, якщо вміст змінився

​

Можливості: лише RSC чи Graph

​

З лише RSC Teams (застосунок установлено, дозволів Graph API немає)

• Читання текстового вмісту повідомлень каналу.
• Надсилання текстового вмісту повідомлень каналу.
• Отримання файлових вкладень у персональних повідомленнях (DM).

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

​

З RSC Teams + дозволами застосунку Microsoft Graph

• Завантаження розміщеного вмісту (зображень, вставлених у повідомлення).
• Завантаження файлових вкладень, що зберігаються в SharePoint/OneDrive.
• Читання історії повідомлень каналу/чату через Graph.

​

RSC і Graph API

​

Медіафайли та історія через Graph

1. Entra ID (Azure AD) App Registration → додайте Graph Application permissions:
   • ChannelMessage.Read.All для вкладень та історії каналів.
   • Chat.Read.All для вкладень та історії групових чатів.
   • Files.Read.All, коли байти вкладень потрібно завантажувати зі сховища SharePoint/OneDrive; для конфігурацій, що використовують лише історію, цей дозвіл не потрібен.
2. Надайте Grant admin consent для клієнта.
3. Збільште manifest version застосунку Teams, повторно завантажте його та перевстановіть застосунок у Teams.
4. Повністю закрийте та перезапустіть Teams, щоб очистити кешовані метадані застосунку.

​

Відновлення файлів каналів/груп (graphMediaFallback)

{
  channels: {
    msteams: {
      graphMediaFallback: true,
    },
  },
}

​

Відомі обмеження

​

Тайм-аути webhook

• Повторні спроби надсилання повідомлення з боку 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; для Китаю використовується попередньо налаштований профіль 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. Для Китаю підтримуються хости каналів 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: список дозволених для приватних повідомлень (рекомендовано ідентифікатори об’єктів AAD). Майстер перетворює імена на ідентифікатори під час налаштування, коли доступ до Graph наявний.
• channels.msteams.dangerouslyAllowNameMatching: аварійний перемикач для повторного ввімкнення зіставлення за змінюваними UPN/відображуваними іменами та прямої маршрутизації за назвами команд/каналів.
• channels.msteams.textChunkLimit: розмір фрагмента вихідного тексту в символах (типово 4000; жорстко обмежено значенням 4000 незалежно від вищого налаштованого значення).
• channels.msteams.streaming.chunkMode: length (типово) або newline для поділу за порожніми рядками (межами абзаців) перед поділом за довжиною.
• channels.msteams.mediaAllowHosts: список дозволених хостів вхідних вкладень (типово домени Microsoft/Teams: Graph, SharePoint/OneDrive, Teams CDN, Bot Framework, Azure Media Services).
• channels.msteams.mediaAuthAllowHosts: список дозволених хостів для додавання заголовків Authorization під час повторних спроб отримання медіафайлів (типово хости Graph + Bot Framework).
• channels.msteams.graphMediaFallback: увімкнути пошук повідомлень через Graph, коли HTML каналу/групи не містить маркерів файлів (типово false; див. Відновлення файлів каналу/групи).
• channels.msteams.mediaMaxMb: перевизначення обмеження розміру медіафайлів для окремого каналу в МБ. Якщо не задано, використовується agents.defaults.mediaMaxMb.
• 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: типові перевизначення політики інструментів для окремої команди й відправника (підтримується символ узагальнення "*").
• 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: перевизначення політики інструментів для окремого каналу й відправника (підтримується символ узагальнення "*").
• Ключі toolsBySender мають використовувати явні префікси: channel:, id:, e164:, username:, name: (застарілі ключі без префіксів і надалі зіставляються лише з id:).
• channels.msteams.authType: тип автентифікації — "secret" (типово) або "federated".
• channels.msteams.certificatePath: шлях до файлу сертифіката PEM (федеративна автентифікація + автентифікація за сертифікатом).
• channels.msteams.certificateThumbprint: відбиток сертифіката; приймається, але не є обов’язковим для автентифікації.
• channels.msteams.useManagedIdentity: увімкнути автентифікацію за допомогою керованої ідентичності (федеративний режим).
• channels.msteams.managedIdentityClientId: ідентифікатор клієнта для керованої ідентичності, призначеної користувачем.
• channels.msteams.sharePointSiteId: ідентифікатор сайту SharePoint для завантаження файлів у групових чатах/каналах (див. Надсилання файлів у групових чатах).
• channels.msteams.welcomeCard, channels.msteams.groupWelcomeCard, channels.msteams.promptStarters: вітальна Adaptive Card, що відображається під час першого контакту в приватному повідомленні/групі, та її кнопки із запропонованими запитами.
• channels.msteams.responsePrefix: текст, що додається на початку вихідних відповідей.
• channels.msteams.feedbackEnabled (типово true), channels.msteams.feedbackReflection (типово true), channels.msteams.feedbackReflectionCooldownMs: зворотний зв’язок «подобається/не подобається» щодо відповідей і подальша рефлексія у відповідь на негативний відгук.
• channels.msteams.sso, channels.msteams.delegatedAuth: підключення OAuth Bot Framework і делеговані області Graph для потоків на основі SSO; sso.enabled: true потребує sso.connectionName.

​

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

• Ключі сеансів відповідають стандартному формату агента (див. /concepts/session):
  • Приватні повідомлення спільно використовують основний сеанс (agent:<agentId>:<mainKey>).
  • Повідомлення каналів/груп використовують ідентифікатор розмови:
    • 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 (або title) перевизначає ім’я завантаженого файлу.

​

Надсилання файлів у групових чатах

​

Чому для групових чатів потрібен SharePoint

​

Налаштування

1. Додайте дозволи Graph API в Entra ID (Azure AD) → App Registration:
   • Sites.ReadWrite.All (Application) — завантаження файлів до SharePoint.
   • ChatMember.Read.All (Application) — дозвіл із найменшими привілеями в межах усього клієнта для надсилання файлів у групових чатах. Chat.Read.All також працює й уже охоплює це, коли ввімкнено історію групових чатів. Як альтернативу для окремого чату використовуйте дозвіл на згоду для конкретного ресурсу ChatMember.Read.Chat.
2. Надайте згоду адміністратора для клієнта.
3. Отримайте ідентифікатор сайту SharePoint:
   # Через Graph Explorer або curl із чинним токеном:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Приклад: для сайту за адресою "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Відповідь містить: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. Налаштуйте OpenClaw:
   {
     channels: {
       msteams: {
         // ... інша конфігурація ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Поведінка спільного доступу

​

Резервна поведінка

​

Розташування збережених файлів

​

Опитування (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> --poll-question "..." --poll-option "..." --poll-option "...".
• Голоси записуються 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: "Вітаємо",
    blocks: [{ type: "text", text: "Вітаємо!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Вітаємо","blocks":[{"type":"text","text":"Вітаємо!"}]}'

​

Формати цілей

# Надіслати користувачу за ідентифікатором
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Вітаємо"

# Надіслати користувачу за відображуваним ім’ям (запускає пошук через Graph API)
openclaw message send --channel msteams --target "user:John Smith" --message "Вітаємо"

# Надіслати до групового чату або каналу
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Вітаємо"

# Надіслати картку презентації до розмови
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Вітаємо","blocks":[{"type":"text","text":"Вітаємо"}]}'

{
  action: "send",
  channel: "msteams",
  target: "user:John Smith",
  message: "Вітаємо!",
}

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "Вітаємо",
    blocks: [{ type: "text", text: "Вітаємо" }],
  },
}

​

Проактивне надсилання повідомлень

• Проактивні повідомлення можна надсилати лише після взаємодії користувача, оскільки саме тоді OpenClaw зберігає посилання на розмову.
• Відомості про dmPolicy і обмеження списком дозволених значень див. у розділі /gateway/configuration.

​

Ідентифікатори команди й каналу (поширена пастка)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Ідентифікатор розмови команди (декодуйте з URL)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Ідентифікатор каналу (декодуйте з URL)

• Ключ команди = сегмент шляху після /team/ (декодований з URL, наприклад, 19:Bk4j...@thread.tacv2; у старіших клієнтах може відображатися @thread.skype, що також є чинним).
• Ключ каналу = сегмент шляху після /channel/ (декодований з URL).
• Ігноруйте параметр запиту groupId для маршрутизації OpenClaw. Це ідентифікатор групи Microsoft Entra, а не ідентифікатор розмови 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 і перевірте тіло відповіді, щоб побачити фактичну помилку.
• Не вдається завантаження неопублікованого застосунку: спробуйте “Upload an app to your org’s app catalog” замість “Upload a custom app”; це часто дає змогу обійти обмеження на завантаження неопублікованих застосунків.

​

Дозволи 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 для керування ботами

​

Пов’язані матеріали

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