Microsoft Teams 设置

初次设置通道？查看我们的''通道设置教程''，这是一个实用的分步教程。本页面是全面的参考，涵盖所有 Microsoft Teams 功能和配置选项。

Microsoft Teams 是面向企业的协作平台。OpenClaw 使用 Microsoft Bot Framework 与 Teams 集成，提供聊天、频道和企业级功能。

设置 Microsoft Teams 需要在 Azure Portal 中创建机器人：

• 在 Azure Portal 中创建 Teams 应用
• 配置 Bot Framework
• 获取机器人凭据
• 在 OpenClaw 中配置
• 部署到 Teams

步骤 1：Azure Portal 设置

• 转到 Azure Portal
• 创建新的 "Azure Bot" 资源
• 根据您的需求选择 "Multi Tenant" 或 "Single Tenant"
• 配置 Microsoft App ID 和密码
• 设置消息传递端点（您的 OpenClaw Gateway URL）

步骤 2：Bot Framework 配置

• 在 Azure Bot 资源中，转到 "Channels"
• 添加 Microsoft Teams 频道
• 配置 Teams 特定设置
• 复制 Microsoft App ID 和密码

步骤 3：Teams 应用清单

使用您的机器人详细信息创建 Teams 应用清单。此清单定义了您的机器人在 Teams 中的功能和外观。

在您的 OpenClaw 配置文件中配置 Microsoft Teams：

Microsoft Teams 配置

{
  "msteams": {
    "appId": "your-microsoft-app-id",
    "appPassword": "your-microsoft-app-password",
    "allowFrom": ["[email protected]", "[email protected]"]
  }
}

环境变量

您也可以使用环境变量：

export MSTEAMS_APP_ID="your-microsoft-app-id"
export MSTEAMS_APP_PASSWORD="your-microsoft-app-password"

用户允许列表

控制谁可以与您的机器人交互：

{
  "msteams": {
    "appId": "your-microsoft-app-id",
    "appPassword": "your-microsoft-app-password",
    "allowFrom": [
      "[email protected]",
      "[email protected]"
    ]
  }
}

群组访问控制

配置群组聊天访问：

{
  "msteams": {
    "appId": "your-microsoft-app-id",
    "appPassword": "your-microsoft-app-password",
    "groupAllowFrom": ["[email protected]"],
    "groupPolicy": "open"
  }
}

群组策略：

• "open" - 机器人响应所有群组消息
• "allowlist" - 仅响应 groupAllowFrom 中列出的群组

OpenClaw 支持各种 Teams 功能：

• 一对一聊天 - 与用户的直接对话
• 团队频道 - 参与团队频道
• 群组聊天 - 多用户对话
• 提及 - 在频道中被提及时响应
• 文件共享 - 发送和接收文件
• 富卡片 - 交互式消息卡片

部署到 Teams

• 打包您的 Teams 应用清单
• 上传到 Teams（通过 App Studio 或直接上传）
• 安装到您的组织或特定团队
• 测试机器人功能

消息传递端点

您的 OpenClaw Gateway 必须可以从互联网访问，以便 Teams 发送消息。配置：

• Gateway 的公共 URL
• HTTPS 端点（Teams 要求）
• 有效的 SSL 证书

• 1
  保护凭据切勿共享您的 App ID 和密码。
• 2
  使用允许列表始终配置 allowFrom 以控制访问。
• 3
  需要 HTTPSTeams 要求消息传递端点使用 HTTPS。
• 4
  定期更新保持您的 Teams 应用和 OpenClaw 更新。
• 5
  审计日志监控机器人交互以确保安全。

机器人无响应

如果机器人没有响应：

• 验证 App ID 和密码是否正确
• 检查消息传递端点是否可访问
• 确保 HTTPS 已正确配置
• 检查 Gateway 是否正在运行并接收请求
• 查看 Azure Bot 日志

身份验证问题

如果身份验证失败：

• 验证 App ID 与 Azure Bot 资源匹配
• 检查 App Password 是否正确
• 确保机器人已在 Teams 中注册
• 如果使用 SSO，请检查 OAuth 配置

群组访问问题

如果群组功能不起作用：

• 检查 groupPolicy 配置
• 验证 groupAllowFrom 包含正确的团队 ID
• 确保机器人已添加到团队/频道
• 检查 Teams 中的机器人权限