OpenClaw + Microsoft Teams

Prerequisites

• OpenClaw running (see our deployment guide)
• A Microsoft 365 account with Teams
• Admin access to Azure portal (for bot registration)

Step 1: Register a Bot in Azure

1. Go to the Azure Portal
2. Navigate to Azure Bot service
3. Click Create and choose a bot handle (e.g., "OpenClawBot")
4. Select your pricing tier (Free tier available)
5. Choose Multi Tenant for most use cases
6. Click Review + Create, then Create

Step 2: Get Your Bot Credentials

After creation, go to your bot resource:

1. Note the Microsoft App ID from the overview page
2. Go to Certificates and secrets → Manage password
3. Click New client secret and copy the Value (not the ID)

Step 3: Enable Teams Channel

1. In your bot resource, go to Channels
2. Click Microsoft Teams → Agree to terms
3. Click Apply

Configuration

Add the Teams channel to your OpenClaw config:

# In your openclaw config
channels:
  teams:
    enabled: true
    app_id: "YOUR_MICROSOFT_APP_ID"
    app_password: "YOUR_CLIENT_SECRET_VALUE"

Or via environment variables in your docker-compose.yml:

environment:
  - TEAMS_ENABLED=true
  - TEAMS_APP_ID=YOUR_MICROSOFT_APP_ID
  - TEAMS_APP_PASSWORD=YOUR_CLIENT_SECRET_VALUE

Step 4: Restart OpenClaw

docker compose restart openclaw

Verification

1. Open Microsoft Teams
2. Search for your bot by its handle
3. Send a message — OpenClaw should respond

Check logs for connection status:

docker compose logs -f openclaw | grep -i teams

Common Issues

Bot not found in Teams: It can take a few minutes for the bot to appear. Ensure the Teams channel is enabled in Azure.

Authentication errors: Double-check your App ID and Client Secret. Make sure you copied the secret Value, not the Secret ID.

Permission denied in channels: For team channels, the bot needs to be added as a team member. Use the "Add member" feature in Teams settings.