OAuth

OAuth integration for channel authentication.

Overview

Some channels require OAuth for authentication:

• Discord
• Slack
• Google (Gmail, Calendar)

OAuth Flow

1. User initiates setup
2. Redirect to provider login
3. User authorizes
4. Callback with token
5. Token stored securely

Supported Providers

Provider	Channels/Features
Discord	Bot + User access
Slack	Workspace access
Google	Gmail, Calendar

Configuration

{
  oauth: {
    callbackUrl: "http://localhost:3000/oauth/callback",
    discord: {
      clientId: "...",
      clientSecret: "..."
    },
    slack: {
      clientId: "...",
      clientSecret: "..."
    }
  }
}

Setting Up OAuth

# Discord OAuth
openclaw channels setup discord --oauth

# Slack OAuth
openclaw channels setup slack --oauth

Token Management

Tokens are stored securely and refreshed automatically when possible.

# View OAuth status
openclaw channels status --oauth

# Re-authenticate
openclaw channels reauth discord

Security

• Tokens encrypted at rest
• Refresh tokens used when available
• Scope limited to necessary permissions

See Also

• Gateway Authentication
• Discord Setup
• Slack Setup