Как подключить OpenClaw к Telegram: настройка AI-агента в мессенджере

OpenClaw подключается к Telegram через встроенный канал (channel plugin), который превращает любого Telegram-бота в полноценного AI-агента с памятью, навыками и автономной работой 24/7. Настройка занимает 10–15 минут и не требует написания кода.

Telegram — самый популярный мессенджер среди тех, кто работает с AI. Неудивительно, что именно через него удобнее всего управлять своим агентом: отправил сообщение — получил результат. OpenClaw делает это возможным «из коробки», без сторонних сервисов и сложных интеграций.

🤖 Что такое OpenClaw и зачем ему Telegram?

OpenClaw — это open-source CLI-фреймворк для создания AI-агентов. Он работает как оркестратор поверх LLM (Claude, GPT, Gemini, DeepSeek, локальные модели через Ollama) и предоставляет агентный runtime с циклом «мышление → действие → результат».

Ключевые возможности OpenClaw:

• 🧠 Постоянная память между сессиями (MEMORY.md, workspace)
• 🔧 Модульные навыки (Skills) — более 10 000 в каталоге ClawHub
• 📡 Мультиканальность — Discord, Telegram, WhatsApp, Slack
• 🤝 Мультиагентная оркестрация — агенты делегируют подзадачи друг другу
• 🖥️ Автономная работа на VPS или домашнем сервере

Telegram-канал позволяет общаться с агентом так же, как с обычным контактом: текстом, голосовыми, файлами. Агент при этом имеет доступ ко всем своим инструментам — поиску, файлам, API, браузеру.

📋 Что нужно для подключения OpenClaw к Telegram?

Перед началом убедитесь, что у вас есть:

🔧 Как настроить Telegram-бота для OpenClaw пошагово?

Шаг 1. Создайте бота в Telegram

Откройте @BotFather в Telegram и выполните команды:

1. 📌 Отправьте /newbot
2. 📌 Введите имя бота (например: «Мой AI Агент»)
3. 📌 Введите username (например: my_ai_agent_bot)
4. 📌 Скопируйте полученный BOT_TOKEN — он понадобится дальше

Дополнительно настройте бота:

• 🔹 /setdescription — описание при первом открытии
• 🔹 /setabouttext — текст в профиле бота
• 🔹 /setuserpic — аватарка

Шаг 2. Установите и инициализируйте OpenClaw

# Установка OpenClaw глобально
npm install -g openclaw

# Инициализация workspace
openclaw init

# Проверка установки
openclaw --version

После openclaw init создаётся директория ~/.openclaw/ с конфигурацией и workspace для файлов агента.

Шаг 3. Подключите Telegram-канал

Откройте конфигурацию OpenClaw (openclaw.json) и добавьте секцию Telegram:

{
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN_HERE",
      "allowedUsers": ["YOUR_TELEGRAM_ID"],
      "defaultModel": "anthropic/claude-sonnet-4-6"
    }
  }
}

Как узнать свой Telegram ID: отправьте любое сообщение боту @userinfobot — он вернёт ваш числовой ID.

Шаг 4. Настройте модель и API-ключ

# Для Anthropic Claude
export ANTHROPIC_API_KEY="sk-ant-..."

# Или через OpenRouter (доступ ко всем моделям)
export OPENROUTER_API_KEY="sk-or-v1-..."

OpenRouter удобен тем, что через один ключ даёт доступ к Claude, GPT, Gemini, DeepSeek и десяткам других моделей. Стоимость — от $0.10 за 1M токенов.

Шаг 5. Запустите агента

# Запуск gateway (фоновый процесс)
openclaw gateway start

# Проверка статуса
openclaw gateway status

После запуска напишите боту в Telegram — он должен ответить. Если используете VPS, настройте автозапуск через systemd:

# /etc/systemd/system/openclaw.service
[Unit]
Description=OpenClaw AI Agent
After=network.target

[Service]
Type=simple
User=your_user
ExecStart=/usr/bin/openclaw gateway start --foreground
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

💡 Какие возможности даёт OpenClaw через Telegram?

После подключения агент умеет гораздо больше, чем просто отвечать на вопросы:

⚠️ Частые ошибки при настройке и как их исправить

На этапе подключения часто встречаются одни и те же проблемы. Вот топ-5 с решениями:

1. Бот не отвечает на сообщения

• 🔍 Проверьте, запущен ли gateway: openclaw gateway status
• 🔍 Убедитесь, что ваш Telegram ID добавлен в allowedUsers
• 🔍 Проверьте логи: openclaw gateway logs

2. Ошибка «Invalid bot token»

• 🔍 Убедитесь, что скопировали токен полностью (без пробелов)
• 🔍 Проверьте, не отозван ли токен в @BotFather (/revoke → /newbot)

3. Ошибка «Model unavailable» или таймаут

• 🔍 Проверьте API-ключ: echo $ANTHROPIC_API_KEY
• 🔍 Попробуйте другую модель через OpenRouter
• 🔍 Для локальной работы: установите Ollama + модель (например, ollama pull llama3)

4. Агент теряет контекст между сообщениями

• 🔍 Убедитесь, что workspace инициализирован: ls ~/.openclaw/workspace/
• 🔍 Проверьте наличие MEMORY.md и SOUL.md в workspace

5. Бот работает, но медленно

• 🔍 Используйте более быструю модель (Claude Haiku или GPT-4o-mini)
• 🔍 Уменьшите контекст: сократите MEMORY.md
• 🔍 Проверьте сеть VPS: ping api.anthropic.com

🚀 Сценарии использования: что реально делают люди

Несколько примеров, как OpenClaw через Telegram решает задачи каждый день:

• 📧 Мониторинг почты — агент проверяет Gmail через IMAP, присылает в Telegram краткое саммари важных писем каждые 2 часа
• 📅 Управление расписанием — «Перенеси встречу с Петром на четверг 15:00» → агент обновляет Google Calendar
• 📝 Ведение заметок — отправляете мысль голосовым → агент транскрибирует и сохраняет в Obsidian
• 🔍 Исследования — «Сравни тарифы VPS для AI-агентов до $10/мес» → получаете таблицу с ценами
• 💻 Управление сервером — «Какая загрузка сервера?» → агент выполняет htop, присылает отчёт
• 🛒 Трекинг цен — агент по расписанию проверяет цену товара и уведомляет при снижении

🆚 OpenClaw vs альтернативы: что выбрать для Telegram?

OpenClaw выигрывает за счёт встроенной памяти и экосистемы навыков. Это не просто бот — это полноценный агент, который помнит контекст, проявляет инициативу и развивается вместе с вами.

📌 Мини-чеклист: OpenClaw + Telegram за 10 минут

1. ✅ Создать бота через @BotFather → получить токен
2. ✅ Установить OpenClaw: npm install -g openclaw
3. ✅ Запустить openclaw init
4. ✅ Добавить Telegram-канал в конфиг (botToken + allowedUsers)
5. ✅ Настроить API-ключ LLM (Anthropic / OpenRouter)
6. ✅ Запустить: openclaw gateway start
7. ✅ Написать боту → убедиться, что отвечает
8. ✅ Настроить SOUL.md — дать агенту характер

Подробнее о настройке SOUL.md — в нашей статье Как настроить SOUL.md и AGENTS.md.

Готовы попробовать? Подписывайтесь на наш Telegram-канал, где мы разбираем реальные кейсы работы с AI-агентами.

❓ Частые вопросы

Как подключить OpenClaw к Telegram?

Создайте бота через @BotFather, скопируйте токен, добавьте его в конфигурацию OpenClaw (channels.telegram.botToken) и запустите gateway командой openclaw gateway start. Весь процесс занимает 10–15 минут.

Можно ли использовать OpenClaw с Telegram бесплатно?

Сам OpenClaw бесплатный (лицензия MIT). Telegram API тоже бесплатный. Оплачивать нужно только LLM-модель — от $0.10 за 1M токенов через OpenRouter, или бесплатно с локальными моделями через Ollama.

Какую модель LLM лучше выбрать для Telegram-агента?

Для повседневного использования — Claude Sonnet 4 (баланс скорости и качества, ~$3 за 1M токенов). Для экономии — Claude Haiku или GPT-4o-mini ($0.10–0.25 за 1M). Для полной автономии — локальная модель через Ollama (LLaMA 3, Qwen).

OpenClaw работает только с Claude?

Нет. OpenClaw — модель-агностичный фреймворк. Он поддерживает Claude, GPT-4o, Gemini, DeepSeek, Qwen и любую модель, доступную через OpenRouter или Ollama. Модель можно менять прямо в конфиге.

Можно ли добавить несколько пользователей в одного Telegram-бота?

Да. В конфигурации allowedUsers укажите массив Telegram ID. Каждый пользователь получит отдельную сессию с агентом. Для групповых чатов — добавьте бота в группу и укажите chat ID.

Как настроить голосовые сообщения в OpenClaw?

OpenClaw автоматически обрабатывает голосовые через Whisper (транскрибация) и может отвечать голосом через TTS (ElevenLabs или встроенный). Достаточно отправить голосовое — агент поймёт и ответит текстом или аудио.

Что делать, если бот перестал отвечать?

Проверьте статус gateway: openclaw gateway status. Если процесс упал — перезапустите: openclaw gateway restart. Для надёжности настройте systemd-сервис с автоперезапуском (Restart=always).