Overview

This guide shows you how to connect Anthropic to Telegram using OpenClaw. You'll configure the messaging channel, set up AI provider authentication, and deploy your assistant.

Telegram Capabilities

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

Anthropic Features

  • 200K context window
  • Image understanding
  • Tool/function calling
  • Streaming responses

Step 1: Configure Telegram

  1. Create a bot with @BotFather on Telegram
  2. Copy the bot token provided
  3. Set TELEGRAM_BOT_TOKEN environment variable
  4. Add telegram configuration to openclaw.json
  5. Start the gateway and message your bot

Step 2: Configure Anthropic

Standard API key authentication

  1. Create an account at console.anthropic.com
  2. Navigate to API Keys section
  3. Generate a new API key
  4. Set ANTHROPIC_API_KEY environment variable

Environment variable: ANTHROPIC_API_KEY

Step 3: Combined Configuration

Add both configurations to your openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-20250514"
      }
    }
  },
  "models": {
    "providers": {
      "anthropic": {
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "${ANTHROPIC_API_KEY}
    }
  },
  "channels": {
    "telegram": {
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing",
      "allowFrom": ["alice", "bob"],
      "historyLimit": 20,
      "reactionNotifications": "own"
    }
  }
}
}

Step 4: Start and Test

# Start the gateway
openclaw gateway start

# Check connection status
openclaw status

# View real-time logs
openclaw logs --follow

Access Control

Telegram supports the following access control policies:

DM Policies

Policy Description
allowlist Only senders in allowFrom list are processed
pairing Unknown senders receive a pairing code; admin must approve
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 Telegram + Anthropic setup: