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

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

​

目标

• 通过 Teams 私信、群聊或渠道与 OpenClaw 交互。
• 保持路由确定性：回复始终返回到其来源渠道。
• 默认使用安全的渠道行为（除非另有配置，否则需要提及）。

​

配置写入

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

​

访问控制（私信 + 群组）

• 默认值：channels.msteams.dmPolicy = "pairing"。未知发送者会被忽略，直到被批准。
• channels.msteams.allowFrom 应使用稳定的 AAD 对象 ID，或使用静态发送者访问组，例如 accessGroup:core-team。
• 不要依赖 UPN/显示名称匹配来做允许列表；它们可能会变化。OpenClaw 默认禁用直接名称匹配；使用 channels.msteams.dangerouslyAllowNameMatching: true 选择启用。
• 当凭据允许时，向导可以通过 Microsoft Graph 将名称解析为 ID。

• 默认值：channels.msteams.groupPolicy = "allowlist"（除非添加 groupAllowFrom，否则阻止）。当 channels.msteams.groupPolicy 未设置时，channels.defaults.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 对话 ID 作为键，不要使用可变的显示名称（参见团队和渠道 ID）。
• 当 groupPolicy="allowlist" 且存在 teams 允许列表时，只接受列出的团队/渠道（受提及门控）。
• 配置向导接受 Team/Channel 条目并为你保存。
• 启动时，OpenClaw 会将团队/渠道和用户允许列表名称解析为 ID（当 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. Bot pod/VM 具有一个托管身份（系统分配或用户分配）。
2. 联合身份凭据将托管身份链接到 Entra ID 应用注册。
3. 运行时，OpenClaw 使用 @azure/identity 从 Azure IMDS 端点获取令牌。
4. 令牌会传递给 Teams SDK 用于 Bot 认证。

• 启用了托管身份的 Azure 基础设施（AKS 工作负载身份、App Service、VM）。
• 在 Entra ID 应用注册上创建的联合身份凭据。
• pod/VM 可以通过网络访问 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 集群上启用 workload identity。
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. 使用应用客户端 ID 标注 Kubernetes 服务账号：
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. 为 workload identity 注入标记 Pod：
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. 允许网络访问 IMDS（169.254.169.254）：如果使用 NetworkPolicy，请为端口 80 上的 169.254.169.254/32 添加一条出站规则。

​

凭证类型对比

​

本地开发（隧道）

# 一次性设置：
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"

​

测试 Bot

teams app doctor <teamsAppId>

1. 安装 Teams 应用（安装链接来自 teams app get <id> --install-link）。
2. 在 Teams 中找到 Bot 并发送一条私信。
3. 检查 Gateway 网关日志中的传入活动。

​

环境变量

​

成员信息操作

• Member.Read.Group RSC 权限（已包含在推荐清单中）。
• 对于跨团队查找：需要带管理员同意的 User.Read.All Graph Application 权限。

​

历史上下文

• channels.msteams.historyLimit 控制有多少最近的频道/群组消息会被包装进提示词。回退到 messages.groupChat.historyLimit，然后默认值为 50。设置为 0 可禁用。
• 获取的线程历史会按发送者允许列表（allowFrom / groupAllowFrom）过滤，因此线程上下文播种只包含来自允许发送者的消息。
• 引用附件上下文（从回复自身附件中的 Skype Reply-schema HTML 解析）会不经过过滤直接传递；目前只有线程历史播种会应用发送者允许列表过滤。
• 私信历史可以通过 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 必须包含频道流量的频道读取/发送权限。

​

更新现有应用

# 下载、编辑并重新上传清单
teams app manifest download <teamsAppId> manifest.json
# 在本地编辑 manifest.json...
teams app manifest upload manifest.json <teamsAppId>
# 如果内容发生变化，版本会自动递增

​

能力：仅 RSC 与 Graph 对比

​

仅使用 Teams RSC（已安装应用，无 Graph API 权限）

• 读取频道消息文本内容。
• 发送频道消息文本内容。
• 接收**个人（私信）**文件附件。

• 频道/群组图片或文件内容（载荷只包含 HTML 存根）。
• 下载存储在 SharePoint/OneDrive 中的附件。
• 读取实时 webhook 事件之外的消息历史。

​

使用 Teams RSC + Microsoft Graph Application 权限

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

​

RSC 与 Graph API

​

启用 Graph 的媒体 + 历史（频道必需）

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

​

已知限制

​

Webhook 超时

• Teams 重试消息（导致重复）。
• 回复丢失。

​

Teams 云和服务 URL 支持

• channels.msteams.cloud 选择 Teams SDK 云预设，用于身份验证、JWT 验证、令牌服务和 Graph 权限范围。
• channels.msteams.serviceUrl 选择 Bot Connector 端点边界，用于在主动发送、编辑、删除、卡片、投票、文件同意消息和排队的长时间运行回复之前验证已存储的会话引用。USGov 和 DoD SDK 云需要此项。对于 China/21Vianet，OpenClaw 使用 SDK China 预设，并且只接受 Azure China Bot Framework 渠道主机上的已存储/已配置服务 URL。

{
  "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：bot 凭据。
• channels.msteams.cloud：Teams SDK 云环境（Public、USGov、USGovDoD 或 China；默认 Public）。对于 USGov/DoD SDK 云，与 serviceUrl 一起设置；China 使用 SDK 预设和已存储的 Azure China Bot Framework 会话引用，并且由 Graph 支持的辅助功能会被禁用，直到 Azure China Graph 路由发布。
• channels.msteams.serviceUrl：SDK 主动操作的 Bot Connector 服务 URL 边界。公共云使用 SDK 默认值；GCC（https://smba.infra.gcc.teams.microsoft.com/teams）、GCC High 或 DoD 需要设置。China 在已存储会话引用来自由 21Vianet 运营的 Teams 时，接受 Azure China Bot Framework 渠道主机。
• channels.msteams.webhook.port（默认 3978）。
• channels.msteams.webhook.path（默认 /api/messages）。
• channels.msteams.dmPolicy：pairing | allowlist | open | disabled（默认 pairing）。
• channels.msteams.allowFrom：私信允许列表（推荐 AAD 对象 ID）。Graph 访问可用时，向导会在设置期间将名称解析为 ID。
• channels.msteams.dangerouslyAllowNameMatching：紧急开关，用于重新启用可变 UPN/显示名称匹配和直接团队/渠道名称路由。
• channels.msteams.textChunkLimit：出站文本分块大小，单位为字符（默认 4000，且无论配置了更高值，都会硬性上限为 4000）。
• channels.msteams.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.mediaMaxMb：每渠道媒体大小限制覆盖值，单位 MB。未设置时回退到 agents.defaults.mediaMaxMb。
• channels.msteams.requireMention：在渠道/群组中要求 @mention（默认 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：用户分配托管标识的客户端 ID。
• channels.msteams.sharePointSiteId：群聊/渠道中文件上传所用的 SharePoint 站点 ID（见在群聊中发送文件）。
• 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：用于 SSO 支持流程的 Bot Framework OAuth 连接和委托 Graph 权限范围；sso.enabled: true 要求 sso.connectionName。

​

路由和会话

• 会话键遵循标准智能体格式（见 /concepts/session）：
  • 直接消息共享主会话（agent:<agentId>:<mainKey>）。
  • 渠道/群组消息使用会话 id：
    • 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

​

线程上下文保留

​

附件和图像

• **私信：**图像和文件附件可通过 Teams bot 文件 API 工作。
• **渠道/群组：**附件位于 M365 存储（SharePoint/OneDrive）中。webhook 载荷只包含一个 HTML 占位片段，而不是实际文件字节。需要 Graph API 权限才能下载渠道附件。
• 对于显式的文件优先发送，请使用带有 media / filePath / path 的 action=upload-file；可选的 message 会成为随附文本/评论，filename（或 title）会覆盖上传名称。

​

在群聊中发送文件

​

为什么群聊需要 SharePoint

​

设置

1. 在 Entra ID (Azure AD) → App Registration 中添加 Graph API 权限：
   • Sites.ReadWrite.All（Application）- 将文件上传到 SharePoint。
   • Chat.Read.All（Application）- 可选，启用按用户分享链接。
2. 为租户授予管理员同意。
3. 获取你的 SharePoint 站点 ID：
   # 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> --poll-question "..." --poll-option "..." --poll-option "..."。
• 投票由 Gateway 网关记录在 state/openclaw.sqlite 下的 OpenClaw 插件状态 SQLite 中。
• 现有 msteams-polls.json 文件由 openclaw doctor --fix 导入，而不是由正在运行的插件导入。
• 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" }],
  },
}

​

主动消息

• 只有在用户已经交互之后，主动消息才可能发送，因为 OpenClaw 会在那时存储对话引用。
• 有关 dmPolicy 和 allowlist 门控，请参阅 /gateway/configuration。

​

团队和渠道 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 解码后）。
• 忽略用于 OpenClaw 路由的 groupId 查询参数。它是 Microsoft Entra 群组 ID，而不是传入 Teams 活动中使用的 Bot Framework 对话 ID。

​

私有渠道

1. 对机器人交互使用标准渠道。
2. 使用私信；用户始终可以直接给机器人发消息。
3. 使用 Graph API 进行历史访问（需要 ChannelMessage.Read.All）。

​

故障排查

​

常见问题

• 图片未在渠道中显示： 缺少 Graph 权限或管理员同意。重新安装 Teams 应用，并完全退出/重新打开 Teams。
• 渠道中没有响应： 默认需要提及；设置 channels.msteams.requireMention=false，或按团队/渠道配置。
• 版本不匹配（Teams 仍显示旧清单）： 移除并重新添加应用，然后完全退出 Teams 以刷新。
• Webhook 返回 401 Unauthorized： 手动测试时没有 Azure JWT 属于预期情况；这表示端点可访问，但认证失败。使用 Azure Web Chat 正确测试。

​

清单上传错误

• “图标文件不能为空”： 清单引用了 0 字节的图标文件。创建有效的 PNG 图标（outline.png 为 32x32，color.png 为 192x192）。
• “webApplicationInfo.Id 已被使用”： 该应用仍安装在另一个团队/聊天中。先找到并卸载它，或等待 5-10 分钟让变更传播。
• 上传时出现“出现问题”： 改用 https://admin.teams.microsoft.com 上传，打开浏览器 DevTools（F12）→ Network 标签页，并检查响应正文中的实际错误。
• 旁加载失败： 尝试使用“将应用上传到组织的应用目录”，而不是“上传自定义应用”；这通常可以绕过旁加载限制。

​

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

​

相关

• 渠道概览 - 所有支持的渠道
• 配对 - 私信认证和配对流程
• 群组 - 群聊行为和提及门控
• 频道路由 - 消息的会话路由
• 安全 - 访问模型和加固