| OpenClaw running | Gateway must be accessible from the internet |
| HTTPS endpoint | Required by Microsoft (use ngrok for testing) |
Step 1: Register a Bot in Azure
- Go to the Azure Portal
- Navigate to Azure Active Directory → App registrations → New registration
- Set the name to "OpenClaw Bot"
- Choose Accounts in this organizational directory only
- Set the redirect URI to
https://your-domain.com/api/teams/callback
- Note the Application (client) ID and Directory (tenant) ID
- Under Certificates & secrets, create a new client secret
Step 2: Configure the Bot Channel
- In Azure Portal, go to Bot Services → Create
- Select Azure Bot
- Link it to your registered app
- Under Channels, add Microsoft Teams
- Set the messaging endpoint to
https://your-domain.com/api/teams/messages
Step 3: Configure OpenClaw
# Install the Teams skill
openclaw skill install teams-integration
# Configure with Azure credentials
openclaw skill setup teams-integration
# → Application ID: ****-****-****
# → Client Secret: ****
# → Tenant ID: ****-****-****
# → Bot name: OpenClaw Bot
# ~/.openclaw/skills/teams-integration/config.yaml
teams:
app_id: ${TEAMS_APP_ID}
client_secret: ${TEAMS_CLIENT_SECRET}
tenant_id: ${TEAMS_TENANT_ID}
bot:
name: OpenClaw Bot
description: AI assistant powered by OpenClaw
behavior:
trigger_mode: mention # mention, all, keyword
respond_in_thread: true
typing_indicator: true
max_response_length: 4000 # Teams message limit
permissions:
direct_messages: true
group_channels: true
private_channels: false
adaptive_cards:
enabled: true # Rich interactive cards
theme: default
Step 4: Create the Teams App Package
# Generate the Teams app manifest
openclaw teams manifest generate
# → Created manifest.json and icon files
# → Package: openclaw-teams-app.zip
# Upload to Teams Admin Center
# Teams Admin Center → Manage apps → Upload custom app
Using OpenClaw in Teams
Direct Messages
You: What meetings do I have today?
OpenClaw Bot: You have 3 meetings today:
📅 09:00 - Standup (15 min) - Teams
📅 11:00 - Product Review (1h) - Room 4B
📅 14:00 - 1:1 with Manager (30 min) - Teams
Channel Mentions
You: @OpenClaw Bot summarize the last 20 messages in this channel
OpenClaw Bot: Here's a summary of recent discussion:
• Team agreed to postpone the release to next Thursday
• Alice found a critical bug in the payment module (#PROJ-891)
• New design mockups are ready for review in Figma
Adaptive Cards
OpenClaw can send rich interactive cards in Teams:
# Enable specific card types
adaptive_cards:
templates:
- task_card # Interactive task management
- poll_card # Quick team polls
- approval_card # Approval workflows
- summary_card # Formatted summaries
Security Configuration
teams:
security:
allowed_users: [] # Empty = all org users
blocked_users:
- external-contractor@partner.com
data_retention:
log_conversations: false # Don't log Teams messages
compliance:
dlp_enabled: true # Data Loss Prevention
audit_logging: true
Advanced Features
| Feature | Configuration | Description |
| Meeting transcripts | meetings.transcribe: true | Summarize Teams meetings |
| File sharing | files.enabled: true | Analyze shared documents |
| Status updates | presence.sync: true | Sync with Teams presence |
| Proactive messages | proactive.enabled: true | Send scheduled messages |
Troubleshooting
| Problem | Solution |
| Bot not appearing in Teams | Verify app is approved in Teams Admin Center |
| "Unauthorized" errors | Check client secret expiry in Azure AD |
| Bot not responding | Verify messaging endpoint is reachable (HTTPS) |
| Messages truncated | Reduce max_response_length in config |