Настройка OpenClaw для Telegram

Примечание: OpenClaw ранее назывался MoltBot и Clawdbot. Все команды взаимозаменяемы (openclaw, moltbot, clawdbot). Telegram — самый популярный канал для OpenClaw. Простая настройка, мощные возможности, работает везде.

Что получим

• ✅ Личный AI-ассистент в Telegram
• ✅ Голосовые сообщения → текстовые ответы
• ✅ Работа в группах (опционально)
• ✅ Inline-кнопки и rich formatting
• ✅ Отправка файлов и изображений

---

Шаг 1: Создаём бота в BotFather

Открываем @BotFather

1. В Telegram ищем @BotFather (официальный бот с синей галочкой)
2. Нажимаем Start

Создаём нового бота

/newbot

BotFather спросит:

1. Имя бота — как он будет отображаться (например: “My AI Assistant”)
2. Username — должен заканчиваться на bot (например: my_ai_assistant_bot)

Получаем токен

После создания BotFather выдаст токен:

Done! Congratulations on your new bot. 
...
Use this token to access the HTTP API:
7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ Храни токен в безопасности! Любой с этим токеном может управлять ботом.

---

Шаг 2: Настраиваем бота

Описание и аватар

/setdescription

Выбираем бота → вводим описание:

“Персональный AI-ассистент на базе Claude. Помогаю с задачами, отвечаю на вопросы, автоматизирую рутину.”

/setuserpic

Загружаем аватарку (квадратное изображение).

Отключаем Privacy Mode (для групп)

Если хочешь использовать бота в группах:

/setprivacy

Выбираем бота → Disable

Это позволит боту читать все сообщения в группе, не только команды.

---

Шаг 3: Конфигурация OpenClaw

Добавляем токен в конфиг

nano ~/.openclaw/openclaw.yaml

channels:
  telegram:
    enabled: true
    token: "7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    
    # Режим получения сообщений
    polling: true  # Рекомендуется (не требует открытых портов)
    
    # Или webhook (требует HTTPS и открытый порт)
    # webhook:
    #   url: "https://your-domain.com/webhook/telegram"
    #   port: 8443

Polling vs Webhook

Параметр	Polling	Webhook
Открытые порты	Не нужны	Нужен HTTPS
Задержка	~1 сек	Мгновенно
Надёжность	Высокая	Зависит от сервера
Настройка	Простая	Сложнее

Рекомендация: Используй polling, если нет особых требований к скорости.

---

Шаг 4: Запускаем и тестируем

Перезапускаем OpenClaw

sudo systemctl restart moltbot

Или если запущен вручную:

openclaw gateway

Проверяем логи

journalctl -u moltbot -f

Должно появиться:

[telegram] Connected as @my_ai_assistant_bot
[telegram] Polling started

Первое сообщение

Открываем бота в Telegram, нажимаем Start и пишем:

Привет! Расскажи о себе.

---

Шаг 5: DM Pairing (одобрение пользователей)

По умолчанию OpenClaw требует одобрения новых пользователей.

Как это работает

1. Новый пользователь пишет боту
2. OpenClaw уведомляет тебя (owner) о новом запросе
3. Ты одобряешь или отклоняешь

Настройка

gateway:
  dmPairing:
    enabled: true
    approvalMode: "manual"  # manual | auto | allowlist
    
    # Для allowlist режима
    allowedUsers:
      - "123456789"  # Telegram user ID
      - "987654321"

Режимы

• manual — одобряешь каждого вручную
• auto — все автоматически одобрены
• allowlist — только указанные user IDs

---

Продвинутые настройки

Голосовые сообщения

OpenClaw автоматически транскрибирует голосовые сообщения через Whisper:

agent:
  transcription:
    enabled: true
    provider: "openai"  # или "local" для whisper.cpp

Ответы голосом (TTS)

agent:
  tts:
    enabled: true
    provider: "elevenlabs"  # или "openai"
    voice: "nova"

Реакции на сообщения

channels:
  telegram:
    reactions:
      enabled: true
      mode: "minimal"  # minimal | expressive

Rate Limiting

Защита от спама:

channels:
  telegram:
    rateLimit:
      messagesPerMinute: 20
      tokensPerMinute: 50000

---

Работа в группах

Добавляем бота в группу

1. Открываем группу → Add Members
2. Ищем username бота
3. Добавляем

Настройка поведения

channels:
  telegram:
    groups:
      enabled: true
      # Отвечать только когда упомянут
      mentionOnly: true
      # Или на все сообщения
      # mentionOnly: false
      
      # Префикс для команд
      commandPrefix: "/"

Как обращаться к боту

• @my_ai_assistant_bot напомни завтра в 10 о встрече
• /ask Какая погода в Москве?
• Reply на сообщение бота

---

Troubleshooting

Бот не отвечает

1. Проверь логи: journalctl -u moltbot -f
2. Проверь токен: правильно ли скопирован?
3. Проверь что бот запущен: systemctl status moltbot

”Unauthorized” ошибка

Токен невалидный или отозван. Создай нового бота в BotFather.

Сообщения приходят с задержкой

• Проверь интернет-соединение сервера
• Попробуй webhook вместо polling
• Проверь нагрузку на сервер

Бот не видит сообщения в группе

• Отключи Privacy Mode: /setprivacy → Disable
• Убедись что бот добавлен как member (не admin обязательно)

---

Полезные команды BotFather

/mybots          — список твоих ботов
/setcommands     — настроить меню команд
/setdescription  — описание бота
/setabouttext    — текст в профиле
/setuserpic      — аватарка
/deletebot       — удалить бота

---

Итог

Теперь у тебя работающий AI-ассистент в Telegram:

• Личные сообщения ✓
• Голосовые сообщения ✓
• Группы (опционально) ✓
• Безопасный доступ через DM Pairing ✓

Следующий шаг: Настройка WhatsApp или Создание скиллов.