Microsoft Teams

​

Встроенный плагин

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. Токен передаётся в Teams SDK для аутентификации бота.

• Инфраструктура 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: "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.
• 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 отсутствуют)

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

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

​

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

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

​

RSC и Graph API

​

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

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

​

Восстановление файлов каналов и групп (graphMediaFallback)

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

​

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

​

Тайм-ауты Webhook

• Teams повторно отправляет сообщение (создавая дубликаты).
• Ответы теряются.

​

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

• channels.msteams.cloud выбирает облачный профиль SDK Teams для аутентификации, проверки 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 для облаков USGov/DoD SDK; для Китая используются предустановка 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: приветственная адаптивная карточка, отображаемая при первом контакте в личных сообщениях/группе, и кнопки с предлагаемыми запросами.
• 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 в канале со стилем «Обсуждения» → ответы отображаются с неудобной вложенностью.
• top-level в канале со стилем «Публикации» → ответы отображаются как отдельные публикации верхнего уровня, а не внутри обсуждения.

{
  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 (приложение) — загрузка файлов в SharePoint.
   • ChatMember.Read.All (приложение) — разрешение с минимальными привилегиями в масштабе клиента для отправки файлов в групповых чатах. 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 состояния плагина OpenClaw в state/openclaw.sqlite.
• Существующие файлы msteams-polls.json импортируются командой openclaw doctor --fix, а не работающим плагином.
• Для записи голосов 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":"Привет!"}]}'

​

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

# Отправка пользователю по ID
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, откройте инструменты разработчика браузера (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 — CLI Teams для управления ботами

​

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

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