Как подключить 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 (установщик сам запустит мастер настройки)
curl -fsSL https://openclaw.ai/install.sh | bash

# Если мастер не запустился или вы его пропустили
openclaw onboard --install-daemon

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

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

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

Самый быстрый способ — команда, которая сама запишет токен в конфиг:

openclaw channels add --channel telegram --token <токен-бота>

Либо добавьте секцию Telegram в ~/.openclaw/openclaw.json вручную (формат JSON5):

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "YOUR_BOT_TOKEN_HERE",
      dmPolicy: "pairing",
      // чтобы разрешить только себя: dmPolicy: "allowlist", allowFrom: ["YOUR_TELEGRAM_ID"]
    }
  }
}

По умолчанию для Telegram действует режим pairing: напишите боту любое сообщение, он создаст запрос на сопряжение, а вы подтвердите его командами openclaw pairing list telegram и openclaw pairing approve telegram <КОД> (код действует 1 час). Модель по умолчанию задаётся отдельно, в ключе agents.defaults.model.primary в формате провайдер/модель, например anthropic/claude-opus-5.

Как узнать свой 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 как службы (если её поставил мастер с --install-daemon)
openclaw gateway start

# Или в текущем терминале
openclaw gateway run

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

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

openclaw gateway install
systemctl --user enable --now openclaw-gateway.service

# чтобы служба работала после выхода из SSH
sudo loginctl enable-linger $(whoami)

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

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

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

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

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

• 🔍 Проверьте, запущен ли gateway: openclaw gateway status
• 🔍 Убедитесь, что вы подтвердили запрос на сопряжение (openclaw pairing list telegram) или что ваш Telegram ID указан в allowFrom
• 🔍 Проверьте логи: openclaw logs --follow

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: curl -fsSL https://openclaw.ai/install.sh | bash
3. ✅ Пройти мастер openclaw onboard
4. ✅ Добавить Telegram-канал (openclaw channels add --channel telegram --token …) и подтвердить сопряжение
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-бота?

Да. В конфигурации канала в allowFrom укажите массив Telegram ID (или подтверждайте каждого пользователя через openclaw pairing approve). Для групповых чатов — добавьте бота в группу и укажите ID группы в channels.telegram.groups.

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

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

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

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