Microsoft Teams

概述

Microsoft Teams 是微软的企业协作平台，广泛应用于企业办公场景。OpenClaw 支持通过 Azure Bot Framework 接入 Teams，让 AI 助手直接在 Teams 中与你对话。

前置要求

一个 Microsoft 365 账号（企业版或开发者版）
一个 Azure 账号
OpenClaw 已安装并运行

配置步骤

第一步：创建 Azure Bot 资源

登录 Azure Portal
搜索并选择「Azure Bot」服务
点击「创建」
填写基本信息：
- Bot handle：给你的 Bot 起一个唯一名称
- 订阅：选择你的 Azure 订阅
- 资源组：创建或选择现有资源组
- 定价层：选择 F0（免费）即可
- Microsoft App ID：选择「创建新的 Microsoft App ID」

第二步：获取凭据

创建完成后，进入 Bot 资源页面：

在「配置」页面找到 Microsoft App ID
点击「管理密码」→ 新建客户端密码
记录 App ID 和 Client Secret

重要

Client Secret 只在创建时显示一次，请务必立即保存。

第三步：配置 OpenClaw

bash

# 安装 Teams 插件
openclaw plugins install @openclaw/msteams

# 配置凭据
openclaw config set channels.msteams.appId "<你的 App ID>"
openclaw config set channels.msteams.appSecret "<你的 Client Secret>"

# 重启网关
openclaw gateway restart

或在 openclaw.json 中配置：

json

{
  "channels": {
    "msteams": {
      "appId": "<你的 App ID>",
      "appSecret": "<你的 Client Secret>"
    }
  }
}

第四步：配置消息端点

在 Azure Bot 配置页面：

找到「消息传递终结点」设置
设置 URL 为：https://<你的服务器域名>/api/channels/msteams/webhook
保存配置

需要公网地址

Teams 需要通过公网访问你的 OpenClaw 实例。可以使用：

云服务器部署 + Nginx 反向代理
Tailscale Funnel
ngrok（仅用于测试）

第五步：添加到 Teams

在 Azure Bot 页面，进入「频道」设置
添加 Microsoft Teams 频道
在 Teams 中搜索你的 Bot 名称
开始对话

功能支持

功能	支持状态
文本消息	✅
图片发送/接收	✅
文件上传	✅
自适应卡片	⚠️ 部分支持
群聊 @提及	✅
频道消息	✅
私聊	✅
流式输出	❌ 不支持

企业管理员注意

如果你所在组织限制了第三方应用：

需要 IT 管理员在 Teams 管理中心批准该 Bot
或将 Bot 部署为组织内部应用
部分组织可能需要安全审查流程

故障排查

问题	原因	解决方案
Bot 不回复	消息端点不可达	检查公网可访问性和 URL 配置
401 错误	凭据错误	检查 App ID 和 Secret 是否正确
找不到 Bot	未添加 Teams 频道	在 Azure 中添加 Teams 频道
消息延迟	网络或 API 限制	检查服务器网络，考虑部署到 Azure 同区域

Microsoft Teams ​

概述 ​

前置要求 ​

配置步骤 ​

第一步：创建 Azure Bot 资源 ​

第二步：获取凭据 ​

第三步：配置 OpenClaw ​

第四步：配置消息端点 ​

第五步：添加到 Teams ​

功能支持 ​

企业管理员注意 ​

故障排查 ​