Microsoft Teams (插件)

"进入此处者,放弃一切希望。"

更新时间:2026-01-21

状态:支持文本 + 私聊附件;频道/群组文件发送需要 sharePointSiteId + Graph 权限(参见在群聊中发送文件)。投票通过自适应卡片发送。

需要插件

Microsoft Teams 作为插件提供,不与核心安装捆绑。

破坏性变更 (2026.1.15): MS Teams 已移出核心。如果您使用它,必须安装插件。

说明:保持核心安装更轻量,让 MS Teams 依赖项独立更新。

通过 CLI 安装(npm 注册表):

bash

openclaw plugins install @openclaw/msteams

本地检出(从 git 仓库运行时):

bash

openclaw plugins install ./extensions/msteams

如果您在配置/入门时选择 Teams 并检测到 git 检出, OpenClaw 将自动提供本地安装路径。

详情:插件

快速设置(初学者)

安装 Microsoft Teams 插件。
创建一个 Azure Bot(App ID + 客户端密钥 + 租户 ID)。
使用这些凭据配置 OpenClaw。
通过公共 URL 或隧道公开 /api/messages(默认端口 3978)。
安装 Teams 应用包并启动网关。

最小配置:

json5

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

注意:默认情况下阻止群聊(channels.msteams.groupPolicy: "allowlist")。要允许群组回复,设置 channels.msteams.groupAllowFrom(或使用 groupPolicy: "open" 允许任何成员,需提及)。

目标

通过 Teams 私聊、群聊或频道与 OpenClaw 对话。
保持路由确定性:回复始终返回到消息到达的频道。
默认使用安全的频道行为(除非另有配置,否则需要提及)。

配置写入

默认情况下,Microsoft Teams 允许写入由 /config set|unset 触发的配置更新(需要 commands.config: true)。

禁用方法:

json5

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

访问控制(私聊 + 群组)

私聊访问

默认:channels.msteams.dmPolicy = "pairing"。未知发件人在批准前被忽略。
channels.msteams.allowFrom 接受 AAD 对象 ID、UPN 或显示名称。当凭据允许时,向导通过 Microsoft Graph 将名称解析为 ID。

群组访问

默认:channels.msteams.groupPolicy = "allowlist"(除非添加 groupAllowFrom,否则被阻止)。使用 channels.defaults.groupPolicy 在未设置时覆盖默认值。
channels.msteams.groupAllowFrom 控制哪些发件人可以在群聊/频道中触发(回退到 channels.msteams.allowFrom)。
设置 groupPolicy: "open" 允许任何成员(默认仍需提及)。
要 不允许频道,设置 channels.msteams.groupPolicy: "disabled"。

示例:

json5

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["user@org.com"],
    },
  },
}

Teams + 频道白名单

通过在 channels.msteams.teams 下列出团队和频道来限定群组/频道回复范围。
键可以是团队 ID 或名称;频道键可以是对话 ID 或名称。
当 groupPolicy="allowlist" 且存在团队白名单时,仅接受列出的团队/频道(需提及)。
配置向导接受 Team/Channel 条目并为您存储。
启动时,OpenClaw 将团队/频道和用户白名单名称解析为 ID(当 Graph 权限允许时) 并记录映射;未解析的条目保持原样。

示例:

json5

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

工作原理

安装 Microsoft Teams 插件。
创建一个 Azure Bot(App ID + 密钥 + 租户 ID)。
构建一个引用机器人并包含下面 RSC 权限的 Teams 应用包。
将 Teams 应用上传/安装到团队(或私聊的个人范围)。
在 ~/.openclaw/openclaw.json 中配置 msteams(或环境变量)并启动网关。
网关默认在 /api/messages 上监听 Bot Framework webhook 流量。

Azure Bot 设置(先决条件)

在配置 OpenClaw 之前,您需要创建 Azure Bot 资源。

步骤 1:创建 Azure Bot

转到创建 Azure Bot

填写基础选项卡:

字段	值
Bot 句柄	您的机器人名称,例如 `openclaw-msteams`(必须唯一)
订阅	选择您的 Azure 订阅
资源组	创建新的或使用现有的
定价层	免费用于开发/测试
应用类型	单租户(推荐 - 见下面说明)
创建类型	创建新的 Microsoft 应用 ID

弃用通知: 2025-07-31 之后弃用了创建新的多租户机器人。新机器人使用 单租户。

点击 审阅 + 创建 → 创建(等待约 1-2 分钟)

步骤 2:获取凭据

转到您的 Azure Bot 资源 → 配置
复制 Microsoft 应用 ID → 这是您的 appId
点击 管理密码 → 转到应用注册
在 证书和密钥 下 → 新客户端密钥 → 复制值 → 这是您的 appPassword
转到概述 → 复制 目录(租户)ID → 这是您的 tenantId

步骤 3:配置消息终结点

在 Azure Bot → 配置中
将 消息终结点 设置为您的 webhook URL:
- 生产环境:https://your-domain.com/api/messages
- 本地开发:使用隧道(见下面的本地开发)

步骤 4:启用 Teams 频道

在 Azure Bot → 频道中
点击 Microsoft Teams → 配置 → 保存
接受服务条款

本地开发(隧道)

Teams 无法访问 localhost。本地开发使用隧道:

选项 A:ngrok

bash

ngrok http 3978
# Copy the https URL, e.g., https://abc123.ngrok.io
# Set messaging endpoint to: https://abc123.ngrok.io/api/messages

选项 B:Tailscale Funnel

bash

tailscale funnel 3978
# Use your Tailscale funnel URL as the messaging endpoint

Teams 开发者门户(替代方案)

您可以使用 Teams 开发者门户代替手动创建清单 ZIP:

点击 + 新建应用
填写基本信息(名称、描述、开发者信息)
转到 应用功能 → 机器人
选择 手动输入机器人 ID 并粘贴您的 Azure Bot 应用 ID
勾选范围:个人、团队、群聊
点击分发 → 下载应用包
在 Teams 中:应用 → 管理您的应用 → 上传自定义应用 → 选择 ZIP

这通常比手动编辑 JSON 清单更容易。

测试机器人

选项 A:Azure Web 聊天(首先验证 webhook)

在 Azure 门户 → 您的 Azure Bot 资源 → 在 Web 聊天中测试
发送消息 - 您应该看到响应
这在 Teams 设置之前确认您的 webhook 终结点工作正常

选项 B:Teams(应用安装后)

安装 Teams 应用(旁加载或组织目录)
在 Teams 中找到机器人并发送私聊
检查网关日志以查看传入活动

设置(最小纯文本)

安装 Microsoft Teams 插件
- 从 npm:openclaw plugins install @openclaw/msteams
- 从本地检出:openclaw plugins install ./extensions/msteams
机器人注册
- 创建 Azure Bot(见上文)并记录:
  - 应用 ID
  - 客户端密钥(应用密码)
  - 租户 ID(单租户)
Teams 应用清单
- 包含带有 botId = <App ID> 的 bot 条目。
- 范围:personal、team、groupChat。
- supportsFiles: true(个人范围文件处理所需)。
- 添加 RSC 权限(下文)。
- 创建图标:outline.png(32x32)和 color.png(192x192)。
- 将所有三个文件压缩在一起:manifest.json、outline.png、color.png。

配置 OpenClaw

json

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

您也可以使用环境变量代替配置键:

MSTEAMS_APP_ID
MSTEAMS_APP_PASSWORD
MSTEAMS_TENANT_ID

机器人终结点
- 将 Azure Bot 消息终结点设置为:
  - https://<host>:3978/api/messages(或您选择的路径/端口)。
运行网关
- 当安装插件且 msteams 配置包含凭据时,Teams 频道自动启动。

历史上下文

channels.msteams.historyLimit 控制将多少最近的频道/群组消息包装到提示中。
回退到 messages.groupChat.historyLimit。设置 0 禁用(默认 50)。
私聊历史可以用 channels.msteams.dmHistoryLimit(用户轮次)限制。每用户覆盖:channels.msteams.dms["<user_id>"].historyLimit。

当前 Teams RSC 权限(清单)

这些是我们 Teams 应用清单中的 现有 resourceSpecific 权限。它们仅适用于安装应用的团队/聊天内。

对于频道(团队范围):

ChannelMessage.Read.Group(应用程序) - 无需 @提及即可接收所有频道消息
ChannelMessage.Send.Group(应用程序)
Member.Read.Group(应用程序)
Owner.Read.Group(应用程序)
ChannelSettings.Read.Group(应用程序)
TeamMember.Read.Group(应用程序)
TeamSettings.Read.Group(应用程序)

对于群聊:

ChatMessage.Read.Chat(应用程序) - 无需 @提及即可接收所有群聊消息

Teams 清单示例(已编辑)

包含必需字段的最小有效示例。替换 ID 和 URL。

json

{
  "$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 应用 ID。
webApplicationInfo.id 必须匹配 Azure Bot 应用 ID。
bots[].scopes 必须包含您计划使用的界面(personal、team、groupChat)。
bots[].supportsFiles: true 是个人范围文件处理所必需的。
authorization.permissions.resourceSpecific 如果您想要频道流量,必须包含频道读取/发送。

更新现有应用

要更新已安装的 Teams 应用(例如添加 RSC 权限):

使用新设置更新您的 manifest.json
增加 version 字段(例如 1.0.0 → 1.1.0)
重新压缩 带图标的清单(manifest.json、outline.png、color.png)
上传新 zip:
- 选项 A (Teams 管理中心): Teams 管理中心 → Teams 应用 → 管理应用 → 找到您的应用 → 上传新版本
- 选项 B (旁加载): 在 Teams 中 → 应用 → 管理您的应用 → 上传自定义应用
对于团队频道: 在每个团队中重新安装应用以使新权限生效
完全退出并重新启动 Teams(不只是关闭窗口)以清除缓存的应用元数据

功能:仅 RSC vs Graph

仅使用 Teams RSC(应用已安装,无 Graph API 权限)

工作:

读取频道消息文本内容。
发送频道消息文本内容。
接收 个人(私聊) 文件附件。

不工作:

频道/群组 图片或文件内容(有效负载仅包含 HTML 存根)。
下载存储在 SharePoint/OneDrive 中的附件。
读取消息历史(超出实时 webhook 事件)。

使用 Teams RSC + Microsoft Graph 应用程序权限

增加:

下载托管内容(粘贴到消息中的图像)。
下载存储在 SharePoint/OneDrive 中的文件附件。
通过 Graph 读取频道/聊天消息历史。

RSC vs Graph API

功能	RSC 权限	Graph API
实时消息	是(通过 webhook)	否(仅轮询)
历史消息	否	是(可查询历史)
设置复杂度	仅应用清单	需要管理员同意 + 令牌流
离线工作	否(必须运行)	是(随时查询)

结论: RSC 用于实时监听;Graph API 用于历史访问。要在离线时补上遗漏的消息,您需要带 ChannelMessage.Read.All 的 Graph API(需要管理员同意)。

启用 Graph 的媒体 + 历史(频道必需)

如果您需要频道中的图片/文件或想要获取 消息历史,必须启用 Microsoft Graph 权限并授予管理员同意。

在 Entra ID (Azure AD) 应用注册 中,添加 Microsoft Graph 应用程序权限:
- ChannelMessage.Read.All(频道附件 + 历史)
- Chat.Read.All 或 ChatMessage.Read.All(群聊)
为租户 授予管理员同意。
提升 Teams 应用 清单版本,重新上传,并 在 Teams 中重新安装应用。
完全退出并重新启动 Teams 以清除缓存的应用元数据。

已知限制

Webhook 超时

Teams 通过 HTTP webhook 传递消息。如果处理时间过长(例如 LLM 响应缓慢),您可能会看到:

网关超时
Teams 重试消息(导致重复)
丢失的回复

OpenClaw 通过快速返回并主动发送回复来处理这个问题,但非常慢的响应仍可能导致问题。

格式化

Teams markdown 比 Slack 或 Discord 更有限:

基本格式有效:粗体、斜体、code、链接
复杂的 markdown(表格、嵌套列表)可能无法正确渲染
支持自适应卡片用于投票和任意卡片发送(见下文)

配置

关键设置(有关共享频道模式,请参见 /gateway/configuration):

channels.msteams.enabled:启用/禁用频道。
channels.msteams.appId、channels.msteams.appPassword、channels.msteams.tenantId:机器人凭据。
channels.msteams.webhook.port(默认 3978)
channels.msteams.webhook.path(默认 /api/messages)
channels.msteams.dmPolicy:pairing | allowlist | open | disabled(默认:配对)
channels.msteams.allowFrom:私聊白名单(AAD 对象 ID、UPN 或显示名称)。当 Graph 访问可用时,向导在设置期间将名称解析为 ID。
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:默认每团队每发件人工具策略覆盖(支持 "*" 通配符)。
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:每频道每发件人工具策略覆盖(支持 "*" 通配符)。
channels.msteams.sharePointSiteId:群聊/频道中文件上传的 SharePoint 站点 ID(见在群聊中发送文件)。

路由和会话

会话键遵循标准代理格式(见/concepts/session):
- 私聊共享主会话(agent:<agentId>:<mainKey>)。
- 频道/群组消息使用对话 id:
  - agent:<agentId>:msteams:channel:<conversationId>
  - agent:<agentId>:msteams:group:<conversationId>

回复样式:线程 vs 帖子

Teams 最近在同一底层数据模型上引入了两种频道 UI 样式:

样式	描述	推荐 `replyStyle`
帖子(经典)	消息显示为卡片,下方有线程回复	`thread`(默认)
线程(类似 Slack)	消息线性流动,更像 Slack	`top-level`

问题: Teams API 不公开频道使用哪种 UI 样式。如果使用错误的 replyStyle:

thread 在线程样式频道中 → 回复显示嵌套尴尬
top-level 在帖子样式频道中 → 回复显示为单独的顶级帖子而不是线程内

解决方案: 根据频道设置配置每频道 replyStyle:

json

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

附件和图片

当前限制:

私聊: 图片和文件附件通过 Teams 机器人文件 API 工作。
频道/群组: 附件存储在 M365 存储(SharePoint/OneDrive)中。webhook 有效负载仅包含 HTML 存根,而非实际文件字节。需要 Graph API 权限 才能下载频道附件。

没有 Graph 权限,带图片的频道消息将仅作为文本接收(机器人无法访问图片内容)。默认情况下,OpenClaw 仅从 Microsoft/Teams 主机名下载媒体。使用 channels.msteams.mediaAllowHosts 覆盖(使用 ["*"] 允许任何主机)。 Authorization 标头仅附加到 channels.msteams.mediaAuthAllowHosts 中的主机(默认为 Graph + Bot Framework 主机)。保持此列表严格(避免多租户后缀)。

在群聊中发送文件

机器人可以使用 FileConsentCard 流程(内置)在私聊中发送文件。但是,在群聊/频道中发送文件 需要额外设置:

上下文	文件发送方式	所需设置
私聊	FileConsentCard → 用户接受 → 机器人上传	开箱即用
群聊/频道	上传到 SharePoint → 分享链接	需要 `sharePointSiteId` + Graph 权限
图片(任何上下文)	Base64 编码内联	开箱即用

为什么群聊需要 SharePoint

机器人没有个人 OneDrive 驱动器(/me/drive Graph API 端点对应用程序标识不起作用)。要在群聊/频道中发送文件,机器人上传到 SharePoint 站点 并创建共享链接。

设置

在 Entra ID (Azure AD) → 应用注册中添加 Graph API 权限:
- Sites.ReadWrite.All(应用程序) - 上传文件到 SharePoint
- Chat.Read.All(应用程序) - 可选,启用每用户共享链接
为租户 授予管理员同意。

获取您的 SharePoint 站点 ID:

bash

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

配置 OpenClaw:

json5

{
  channels: {
    msteams: {
      // ... other config ...
      sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
    },
  },
}

共享行为

权限	共享行为
仅 `Sites.ReadWrite.All`	组织范围共享链接(组织内任何人都可以访问)
`Sites.ReadWrite.All` + `Chat.Read.All`	每用户共享链接(仅聊天成员可以访问)

每用户共享更安全,因为只有聊天参与者可以访问文件。如果缺少 Chat.Read.All 权限,机器人回退到组织范围共享。

回退行为

场景	结果
群聊 + 文件 + 已配置 `sharePointSiteId`	上传到 SharePoint,发送共享链接
群聊 + 文件 + 无 `sharePointSiteId`	尝试 OneDrive 上传(可能失败),仅发送文本
个人聊天 + 文件	FileConsentCard 流程(无需 SharePoint 即可工作)
任何上下文 + 图片	Base64 编码内联(无需 SharePoint 即可工作)

文件存储位置

上传的文件存储在配置的 SharePoint 站点默认文档库的 /OpenClawShared/ 文件夹中。

投票(自适应卡片)

OpenClaw 将 Teams 投票作为自适应卡片发送(没有原生 Teams 投票 API)。

CLI:openclaw message poll --channel msteams --target conversation:<id> ...
投票由网关记录在 ~/.openclaw/msteams-polls.json 中。
网关必须保持在线才能记录投票。
投票尚未自动发布结果摘要(如需要,请检查存储文件)。

自适应卡片(任意)

使用 message 工具或 CLI 将任何自适应卡片 JSON 发送给 Teams 用户或对话。

card 参数接受自适应卡片 JSON 对象。当提供 card 时,消息文本是可选的。

代理工具:

json

{
  "action": "send",
  "channel": "msteams",
  "target": "user:<id>",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello!" }]
  }
}

CLI:

bash

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello!"}]}'

有关卡片架构和示例,请参见自适应卡片文档。有关目标格式详细信息,请参见下面的目标格式。

目标格式

MSTeams 目标使用前缀来区分用户和对话:

目标类型	格式	示例
用户(按 ID)	`user:<aad-object-id>`	`user:40a1a0ed-4ff2-4164-a219-55518990c197`
用户(按名称)	`user:<display-name>`	`user:John Smith`(需要 Graph API)
群组/频道	`conversation:<conversation-id>`	`conversation:19:abc123...@thread.tacv2`
群组/频道(原始)	`<conversation-id>`	`19:abc123...@thread.tacv2`(如果包含 `@thread`)

CLI 示例:

bash

# 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 an Adaptive Card to a conversation
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello"}]}'

代理工具示例:

json

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

json

{
  "action": "send",
  "channel": "msteams",
  "target": "conversation:19:abc...@thread.tacv2",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello" }]
  }
}

注意:没有 user: 前缀,名称默认为群组/团队解析。按显示名称定位人员时始终使用 user:。

主动消息

主动消息仅在用户交互之后才可能,因为我们在那时存储对话引用。
有关 dmPolicy 和白名单控制,请参见 /gateway/configuration。

团队和频道 ID(常见陷阱)

Teams URL 中的 groupId 查询参数不是用于配置的团队 ID。改为从 URL 路径中提取 ID:

团队 URL:

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

频道 URL:

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

用于配置:

团队 ID = /team/ 后的路径段(URL 解码,例如 19:Bk4j...@thread.tacv2)
频道 ID = /channel/ 后的路径段(URL 解码)
忽略 groupId 查询参数

私人频道

机器人在私人频道中的支持有限:

功能	标准频道	私人频道
机器人安装	是	有限
实时消息(webhook)	是	可能不工作
RSC 权限	是	可能行为不同
@提及	是	如果机器人可访问
Graph API 历史	是	是(有权限)

**如果私人频道不工作的

Microsoft Teams (插件) ​

需要插件 ​

快速设置(初学者) ​

目标 ​

配置写入 ​

访问控制(私聊 + 群组) ​

工作原理 ​

Azure Bot 设置(先决条件) ​

步骤 1:创建 Azure Bot ​

步骤 2:获取凭据 ​

步骤 3:配置消息终结点 ​

步骤 4:启用 Teams 频道 ​

本地开发(隧道) ​

Teams 开发者门户(替代方案) ​

测试机器人 ​

设置(最小纯文本) ​

历史上下文 ​

当前 Teams RSC 权限(清单) ​

Teams 清单示例(已编辑) ​

清单注意事项(必填字段) ​

更新现有应用 ​

功能:仅 RSC vs Graph ​

仅使用 Teams RSC(应用已安装,无 Graph API 权限) ​

使用 Teams RSC + Microsoft Graph 应用程序权限 ​

RSC vs Graph API ​

启用 Graph 的媒体 + 历史(频道必需) ​

已知限制 ​

Webhook 超时 ​

格式化 ​

配置 ​

路由和会话 ​

回复样式:线程 vs 帖子 ​

附件和图片 ​

在群聊中发送文件 ​

为什么群聊需要 SharePoint ​

设置 ​

共享行为 ​

回退行为 ​

文件存储位置 ​

投票(自适应卡片) ​

自适应卡片(任意) ​

目标格式 ​

主动消息 ​

团队和频道 ID(常见陷阱) ​

私人频道 ​

Microsoft Teams (插件)

需要插件

快速设置(初学者)

目标

配置写入

访问控制(私聊 + 群组)

工作原理

Azure Bot 设置(先决条件)

步骤 1:创建 Azure Bot

步骤 2:获取凭据

步骤 3:配置消息终结点

步骤 4:启用 Teams 频道

本地开发(隧道)

Teams 开发者门户(替代方案)

测试机器人

设置(最小纯文本)

历史上下文

当前 Teams RSC 权限(清单)

Teams 清单示例(已编辑)

清单注意事项(必填字段)

更新现有应用

功能:仅 RSC vs Graph

仅使用 Teams RSC(应用已安装,无 Graph API 权限)

使用 Teams RSC + Microsoft Graph 应用程序权限

RSC vs Graph API

启用 Graph 的媒体 + 历史(频道必需)

已知限制

Webhook 超时

格式化

配置

路由和会话

回复样式:线程 vs 帖子

附件和图片

在群聊中发送文件

为什么群聊需要 SharePoint

设置

共享行为

回退行为

文件存储位置

投票(自适应卡片)

自适应卡片(任意)

目标格式

主动消息

团队和频道 ID(常见陷阱)

私人频道