🦞
Channel Integration

Connect OpenClaw to Microsoft Teams

Integrate OpenClaw with Microsoft Teams using the Bot Framework for enterprise-grade AI assistance.

🏢 Why Use Microsoft Teams?
  • Microsoft 365 Integration — Seamless with Office, SharePoint, OneDrive
  • Enterprise Security — Microsoft's enterprise-grade compliance
  • Bot Framework — Industry-standard bot development platform
  • Adaptive Cards — Rich, interactive message cards
  • Meeting Integration — Join meetings and assist during calls

Setup Steps

1

Register a Bot in Azure

Create a Bot resource in the Azure Portal:

  • • Go to Azure Portal
  • • Create a new "Azure Bot" resource
  • • Choose "Multi Tenant" for app type
  • • Note the Microsoft App ID and create a client secret
2

Configure Messaging Endpoint

Set up the endpoint where Teams will send messages:

  • • In the Azure Bot resource, go to Configuration
  • • Set the messaging endpoint to your OpenClaw webhook URL
  • • Example: https://your-server.com/webhook/teams
3

Enable Teams Channel

Connect the bot to Microsoft Teams:

  • • In Azure Bot, go to Channels
  • • Click on Microsoft Teams
  • • Accept the terms and enable the channel
  • • Configure messaging and calling features as needed
4

Configure OpenClaw

Add the Teams configuration to your openclaw.json:

{
  "channels": {
    "teams": {
      "enabled": true,
      "appId": "YOUR_MICROSOFT_APP_ID",
      "appPassword": "YOUR_CLIENT_SECRET",
      "tenantId": "YOUR_TENANT_ID",
      "allowFrom": ["user@yourdomain.com"]
    }
  }
}
5

Create Teams App Package

Package and install the bot in Teams:

  • • Create a Teams app manifest (manifest.json)
  • • Include bot icons (color and outline)
  • • Zip the manifest and icons
  • • Upload to Teams Admin Center or sideload directly
6

Restart and Test

Restart OpenClaw and start chatting:

openclaw restart

Find your bot in Teams and send a message to verify the connection.

Advanced Configuration
{
  "channels": {
    "teams": {
      "enabled": true,
      "appId": "YOUR_MICROSOFT_APP_ID",
      "appPassword": "YOUR_CLIENT_SECRET",
      "tenantId": "YOUR_TENANT_ID",
      "allowFrom": ["user1@domain.com", "user2@domain.com"],
      "allowTeams": ["TEAM_ID_1", "TEAM_ID_2"],
      "respondToMentions": true,
      "respondToDMs": true,
      "useAdaptiveCards": true,
      "webhookUrl": "https://your-server.com/webhook/teams"
    }
  }
}
  • appId — Microsoft App ID from Azure
  • tenantId — Your Azure AD tenant ID
  • allowTeams — Restrict to specific Teams
  • useAdaptiveCards — Enable rich Adaptive Cards
Features
  • Bot Framework Integration — Industry-standard bot platform
  • Adaptive Cards — Interactive, rich message cards
  • Channel & DM Support — Works in team channels and 1:1 chats
  • File Attachments — Share files via OneDrive integration
  • Message Extensions — Extend Teams with custom actions
⚠️ Troubleshooting

Bot not responding in Teams?

Verify the messaging endpoint is correct and publicly accessible.

Authentication failed?

Check that the App ID and Client Secret match in Azure and openclaw.json.

Can't install the app?

Ensure your Teams admin has enabled sideloading or approved the app.

For more detailed configuration options and advanced features, visit the official documentation:

docs.openclaw.ai/channels/teams →

Microsoft Teams Connected!

Add more channels or enhance your bot with custom skills.