Enterprise Teams Connector
End-to-end Microsoft Teams enterprise deployment for OpenClaw agents. Eliminates 2-3 hours of manual Teams configuration.
Quick Start
# Generate complete Teams configuration
python3 scripts/teams-connector.py setup --org "Acme Corp" --bot-name "AcmeBot"
# Check current Teams config status
python3 scripts/teams-connector.py check
# Generate bot manifest for Teams admin upload
python3 scripts/teams-connector.py manifest --bot-name "AcmeBot" --app-id YOUR_APP_ID
# Configure channel routing rules
python3 scripts/teams-connector.py routing --config routing.json
# Generate welcome card template
python3 scripts/teams-connector.py welcome --bot-name "AcmeBot" --prompts "Summarize this doc,Draft an email,Check my calendar"
# Security policy audit
python3 scripts/teams-connector.py security --audit
Commands
`setup` — Full Enterprise Setup Wizard
Generates all configuration files needed for Teams deployment:
- Bot manifest (JSON for Teams Admin Center upload)
- Channel routing rules (map Teams channels to OpenClaw behaviors)
- Security policy (approved commands, data access scoping, DLP rules)
- Welcome card (Adaptive Card with prompt starters)
- Admin dashboard config
Parameters:
--org NAME— Organization name (required)--bot-name NAME— Bot display name (default: "OpenClaw Assistant")--app-id ID— Azure AD App Registration ID--tenant-id ID— Azure AD Tenant ID (for single-tenant deployment)--output-dir PATH— Output directory for generated files (default: ./teams-config/)
`check` — Configuration Status Check
Validates existing Teams configuration:
- Checks openclaw.json for Teams channel config
- Validates bot manifest structure
- Tests webhook URL connectivity
- Reports missing required fields
`manifest` — Bot Manifest Generator
Creates Teams app manifest (manifest.json) ready for admin upload:
- App metadata (name, description, icons)
- Bot registration details
- Permission scopes (minimal required)
- Valid scopes configuration
Parameters:
--bot-name NAME— Bot display name--app-id ID— Azure AD Application ID--bot-id ID— Bot Framework ID--description TEXT— App description--multi-tenant— Enable multi-tenant mode (default: single-tenant)
`routing` — Channel Routing Configuration
Maps Teams channels to OpenClaw agent behaviors:
- Define per-channel system prompts
- Set allowed/blocked commands per channel
- Configure response format (text/adaptive cards)
- Rate limiting per user/channel
`welcome` — Welcome Card Generator
Creates Adaptive Card JSON for new user onboarding:
- Customizable greeting message
- Prompt starter buttons (configurable)
- Quick-start guide sections
- Branding (logo, colors)
`security` — Security Policy Manager
Audits and configures security policies:
- Command allowlists (what the bot can do in Teams)
- Data access scoping (which files/APIs bot can access)
- DLP compliance (block sensitive data in responses)
- Audit logging configuration
- User permission levels (admin/member/guest)
Output Files
teams-config/
├── manifest.json — Teams app manifest for admin upload
├── routing-rules.json — Channel → behavior mapping
├── security-policy.json — Security and access controls
├── welcome-card.json — Adaptive Card for onboarding
├── admin-dashboard.json — Status dashboard config
└── setup-guide.md — Human-readable setup instructions
Integration Notes
- Requires OpenClaw 3.24+ with Teams SDK support
- Azure AD App Registration required (free with Microsoft 365)
- For Teams Admin Center upload: must be Global Admin or Teams Admin
- Bot Framework registration: https://dev.botframework.com
- See
references/teams-deployment-guide.mdfor detailed Azure AD setup steps