Microsoft Teams 채널 설정

OpenClaw와 Microsoft Teams를 연결하여 Microsoft 365 환경용 AI 봇을 구축하는 방법을 안내합니다.

개요

Microsoft Teams는 Microsoft 365 생태계의 일부로, 기업 환경에서 널리 사용되는 협업 플랫폼입니다.

• Microsoft 365 통합 — Office, SharePoint, OneDrive와 연동
• Bot Framework — Microsoft 공식 Bot Framework 지원
• Rich Cards — Adaptive Cards, Hero Cards
• Teams Apps — Teams 앱 스토어 배포 가능
• Enterprise Security — Azure Active Directory 통합

플러그인 채널: 별도 설치 필요

1단계: Teams 플러그인 설치

openclaw plugin install @openclaw/channel-teams

2단계: Azure Bot 리소스 생성

1. Azure Portal 접속: https://portal.azure.com
2. Create a resource → Bot → Azure Bot
3. Bot handle: openclaw-bot (고유한 ID)
4. Pricing tier: Free (F0)
5. Type of App: Multi Tenant
6. Create

3단계: Microsoft App ID 등록

1. 생성된 Bot 리소스 선택
2. Configuration 블레이드
3. Microsoft App ID → Manage password
4. Client secret 생성 및 복사
5. App ID 복사

4단계: Teams 매니페스트 생성

Teams 앱 매니페스트 (manifest.json):

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.16",
  "version": "1.0.0",
  "id": "your-app-id",
  "packageName": "com.openclaw.teams",
  "developer": {
    "name": "OpenClaw",
    "websiteUrl": "https://openclaw.ai",
    "privacyUrl": "https://openclaw.ai/privacy",
    "termsOfUseUrl": "https://openclaw.ai/terms"
  },
  "name": {
    "short": "OpenClaw",
    "full": "OpenClaw AI Assistant"
  },
  "bots": [
    {
      "botId": "your-app-id",
      "scopes": ["personal", "team", "groupchat"],
      "supportsFiles": true,
      "isNotificationOnly": false
    }
  ]
}

5단계: OpenClaw 설정

{
  "channels": {
    "teams": {
      "enabled": true,
      "appId": "your-microsoft-app-id",
      "appPassword": "your-client-secret",
      "tenantId": "your-tenant-id",
      "dmPolicy": "allowlist",
      "allowFrom": ["user@email.com"],
      "teamPolicy": "allowlist"
    }
  }
}

환경 변수로 설정:

TEAMS_APP_ID=your-app-id
TEAMS_APP_PASSWORD=your-client-secret
TEAMS_TENANT_ID=your-tenant-id

6단계: Teams 앱 업로드

1. Teams 클라이언트 열기
2. Apps → Manage your apps → Upload an app
3. 매니페스트 파일(manifest.json) 업로드
4. Add

7단계: 게이트웨이 시작

openclaw gateway

고급 설정

Adaptive Cards

{
  "channels": {
    "teams": {
      "adaptiveCards": {
        "enabled": true,
        "version": "1.5"
      }
    }
  }
}

Azure AD 인증

{
  "channels": {
    "teams": {
      "authentication": {
        "enabled": true,
        "authority": "https://login.microsoftonline.com",
        "tenantId": "your-tenant-id"
      }
    }
  }
}

액세스 제어

DM 정책

channels.teams.dmPolicy 옵션:

• allowlist (기본값)
• open (allowFrom에 "*" 필요)
• disabled

허용목록 형식: 이메일 주소 또는 UPN (user@email.com)

팀 정책

channels.teams.teamPolicy 옵션:

• open
• allowlist (기본값)
• disabled

트러블슈팅

인증 실패

• App ID와 App Password 확인
• Tenant ID 확인
• Azure AD 권한 확인

Teams 앱 로드 실패

• 매니페스트 JSON 유효성 검증
• App ID가 올바른지 확인
• 아이콘 파일이 포함되었는지 확인

메시지가 수신되지 않음

• Webhook URL이 올바른지 확인
• OpenClaw 게이트웨이가 실행 중인지 확인
• Teams 앱이 설치되었는지 확인

참고:

• Microsoft Bot Framework
• Teams Developer Platform
• 공식 문서: Teams Channel