ClawdBotAI LogoClawdBotAI
Home平台集成MS Teams

Microsoft Teams 集成

将 ClawdBot 连接到 Microsoft Teams

概述

Microsoft Teams 是企业最常用的协作平台之一。 通过集成 ClawdBot，你的团队可以在 Teams 中直接使用 AI 助手， 提升工作效率。

企业集成

与 Microsoft 365 深度集成

Azure AD

企业级身份认证

团队协作

频道、群组、私聊支持

前提条件

  • Microsoft 365 账户 - 工作或学校账户
  • Azure 订阅 - 用于注册 Bot
  • Teams 管理员权限 - 或请求管理员批准
  • 可公网访问的服务器 - 用于接收消息

Azure 配置

步骤 1: 创建 Azure Bot 资源

  1. 登录 Azure Portal
  2. 搜索并创建 "Azure Bot"
  3. 填写信息：
    • Bot handle: clawdbot
    • Pricing tier: F0 (免费)

步骤 2: 获取凭据

  1. 进入 Bot 资源 → Configuration
  2. 记录 Microsoft App ID
  3. 点击 "Manage" 创建 Client Secret

注册 Bot

配置 Messaging Endpoint

https://your-server.com/api/teams/messages

启用 Teams 频道

  1. 在 Azure Bot 中点击 Channels
  2. 选择 Microsoft Teams
  3. 接受服务条款并保存

ClawdBot 配置

# ~/.clawdbot/config.yaml

channels:
  msteams:
    enabled: true
    app_id: "your-microsoft-app-id"
    app_secret: "your-client-secret"
    tenant_id: "your-tenant-id"  # 可选，多租户留空

    # Webhook 端点
    endpoint: "/api/teams/messages"

环境变量

export CLAWDBOT_TEAMS_APP_ID="your-app-id"
export CLAWDBOT_TEAMS_APP_SECRET="your-secret"
clawdbot gateway

部署到 Teams

创建 App 包

# 生成 Teams App 包
clawdbot teams create-package

# 会生成 clawdbot-teams.zip

上传到 Teams

  1. 打开 Teams → Apps → Upload a custom app
  2. 上传生成的 zip 文件
  3. 为组织或个人安装

管理员批准

如果组织限制自定义应用，需要 Teams 管理员在管理中心批准。

故障排查

Bot 不响应

  • 确认 Messaging Endpoint 可公网访问
  • 检查 App ID 和 Secret 是否正确
  • 验证 Teams 频道已启用

认证错误

  • 检查 tenant_id 配置
  • 确认 Secret 未过期
  • 验证 Azure AD 权限
# 诊断
clawdbot doctor --check msteams
clawdbot logs --channel msteams
MattermostGoogle Chat