Overview

This guide walks you through connecting OpenAI Codex to Microsoft Teams using OpenClaw. You'll learn how to configure authentication, set up the channel, and deploy your AI assistant.

OpenAI Codex Features

  • 128K context window
  • Image generation and understanding
  • Tool/function calling
  • Fine-tuning available

Microsoft Teams Capabilities

  • Direct messages
  • Group chats
  • Media support
  • Reactions
  • Thread support
  • Native commands

Step 1: Configure OpenAI Codex

Standard API key authentication

  1. Create an account at platform.openai.com
  2. Navigate to API Keys section
  3. Generate a new API key
  4. Set OPENAI_API_KEY environment variable

Environment variable: OPENAI_API_KEY

Step 2: Configure Microsoft Teams

  1. Register an app in Azure Portal
  2. Create a Bot Channel Registration
  3. Configure Teams channel in Azure
  4. Set app credentials in openclaw.json
  5. Deploy and add bot to Teams

Step 3: Combined Configuration

Add both configurations to your openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai-codex/gpt-5.2"
      }
    }
  },
  "models": {
    "providers": {
      "openai-codex": {
  "models": {
    "providers": {
      "openai-codex": {
        "apiKey": "${OPENAI_API_KEY}
    }
  },
  "channels": {
    "msteams": {
      "appId": "${MSTEAMS_APP_ID}",
      "appPassword": "${MSTEAMS_APP_PASSWORD}"
    }
  }
}
}

Step 4: Start the Gateway

# Start the gateway
openclaw gateway start

# Check status
openclaw status

# View logs
openclaw logs --follow

Access Control

Microsoft Teams supports the following access control policies:

DM Policies

Policy Description
allowlist Only senders in allowFrom list are processed
open All DMs are processed (requires allowFrom: ["*"])

Group Policies

Policy Description
allowlist Only groups in groupAllowFrom are processed
open All groups are processed

Deploy Options

Choose how to deploy your OpenAI Codex + Microsoft Teams setup:

Local Deployment

Run on your personal machine with local-only access

View Guide →

VPS Deployment

Always-on deployment on a Linux VPS

View Guide →

Cloud Deployment

Managed container deployment on Fly.io or similar

View Guide →

Docker Deployment

Containerized deployment with Docker

View Guide →

Frequently Asked Questions

How do I set up OpenAI Codex with Microsoft Teams?
Configure OpenAI Codex as your AI provider and enable Microsoft Teams as a channel in openclaw.json. The gateway routes Microsoft Teams messages to OpenAI Codex for processing automatically.
Is OpenAI Codex a good choice for Microsoft Teams bots?
OpenAI Codex works great with Microsoft Teams. Extensive ecosystem and tooling and Good performance across tasks make it well-suited for Enterprise AI assistant and Corporate automation.