Microsoft Teams - 企业办公平台接入

Microsoft Teams 是全球广泛使用的企业协作平台。OpenClaw 通过 Azure Bot Service（Azure 机器人服务）实现集成，需安装官方插件。

前置要求

• Microsoft 365 / Azure 订阅及 Teams 管理员权限
• OpenClaw Gateway（网关）已安装并运行

安装插件

openclaw plugins install @openclaw/msteams
openclaw plugins list

配置步骤

第一步：注册 Azure Bot

1. 登录 Azure Portal，搜索 Azure Bot 服务
2. 点击 Create，选择 Single Tenant（单租户），填写名称和资源组
3. 创建完成后获取三个凭证：
   • App ID（应用程序 ID）：Bot Configuration 页面查看
   • App Password（应用密码）：Manage Password > Certificates & secrets > New client secret
   • Tenant ID（租户 ID）：Azure Active Directory > Overview

安全提示

App Password 只在创建时显示一次，请立即记录。丢失需重新创建。

第二步：启用 Teams Channel 并配置端点

1. 在 Azure Bot Channels 页面点击 Microsoft Teams 图标，同意条款并保存
2. 在 Configuration 页面设置 Messaging endpoint：

   https://your-domain.com/api/channels/msteams/messages

第三步：添加 RSC Permissions（资源特定权限）

在 Teams App Manifest（应用清单）中添加：

{
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        { "name": "ChannelMessage.Read.Group", "type": "Application" },
        { "name": "ChatMessage.Read.Chat", "type": "Application" }
      ]
    }
  }
}

第四步：配置 OpenClaw

{
  channels: {
    msteams: {
      enabled: true,
      appId: "YOUR_APP_ID",
      appPassword: "YOUR_APP_PASSWORD",
      tenantId: "YOUR_TENANT_ID"
    }
  }
}

第五步：重启 Gateway

openclaw gateway restart

1-on-1 和群组聊天

1-on-1 Chat：在 Teams 中搜索 Bot 发起对话，获取 Pairing Code（配对码）后批准：

openclaw pairing approve msteams <code>

Group Chat（群组聊天）：在群聊中 @提及 Bot 触发响应：

{
  channels: {
    msteams: {
      groupRequireMention: true
    }
  }
}

Adaptive Cards（自适应卡片）

支持发送 Rich Message（富消息），展示按钮、表格、图片等结构化内容：

{
  channels: {
    msteams: {
      useAdaptiveCards: true,
      cardStyle: "default"       // default | compact | detailed
    }
  }
}

Teams App Manifest

创建 manifest.json 及两个图标（32x32 和 192x192），打包为 ZIP 上传到 Teams Admin Center（管理中心）。

常见问题

Bot 在 Teams 中无法找到

确认 Teams App 已上传到 Admin Center 并被管理员审批。

消息发送失败

1. 检查 Messaging Endpoint 是否公网可访问
2. 确认 App Password 未过期
3. 查看 Gateway 日志中的错误详情

🇨🇳 中国用户须知

Teams 在中国大陆可通过 Office 365 中国版（由世纪互联运营）使用。

中国版特殊配置：

{
  channels: {
    msteams: {
      azureEndpoint: "https://login.partner.microsoftonline.cn",
      botFrameworkEndpoint: "https://smba.trafficmanager.cn"
    }
  }
}

注意事项：

• 世纪互联版（21Vianet）与国际版独立，账号数据不互通
• Azure 资源需在中国区 portal.azure.cn 创建
• Bot Framework（机器人框架）Service URL 在中国区不同，请使用上述端点
• 国内国际用户混合时，建议分别部署两套 Bot