OpenClaw в Telegram: установка и первая задача для бизнеса

OpenClaw — помощник, которого можно запустить на своём компьютере или сервере и подключить к Telegram. Вы пишете задачу в чат, языковая модель разбирается с запросом, а доступные инструменты позволяют агенту выполнять действия. Набор этих действий зависит от подключения и настроек: сам Telegram не выдаёт доступ к файлам, почте или клиентской базе.

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

Тема уже вышла за пределы экспериментов разработчиков: 16 октября 2026 года команда OpenClaw опубликовала историю консультанта PJ, который помогает небольшим компаниям внедрять помощника. Это пример применения, а не обещание такой же экономии в любом бизнесе.

Что OpenClaw даст небольшой команде

Полезная отправная точка — повторяющаяся работа с разными входными данными. Например, из сообщения клиента нужно выделить задачу, найти пробелы в брифе и подготовить вопросы. Или из нескольких заметок собрать список решений и следующих шагов.

Сначала опишите результат без названия технологии: «менеджер получает черновик с вопросами и проверяет его». Так легче понять, получился ли полезный инструмент. Формулировка «хочу ИИ-сотрудника, который делает всё» не даёт ни критериев готовности, ни границ доступа.

Telegram здесь служит привычным входом в помощника. Чтобы тот действительно работал с документами или сервисами, потребуется настроить соответствующие инструменты, права и источник данных. Само появление бота в контактах не означает, что он уже знает расписание школы, цены компании и историю её клиентов. Эти сведения нужно подключать осознанно и поддерживать в актуальном состоянии.

Если работа всегда состоит из одинаковых шагов, отдельный агент может быть лишним. Создать счёт в определённый день, проверить статус и отправить заданное уведомление можно обычной программой. В моём кейсе ассистента оплаты описана именно конкретная задача бизнеса. Приписывать этому решению OpenClaw не нужно: выбирают сначала процесс, потом инструмент.

Что нужно для установки

Есть три отдельные составляющие: компьютер с OpenClaw, доступ к языковой модели и Telegram-бот. Компьютер должен оставаться включённым, пока нужен помощник. На спящем ноутбуке не стоит рассчитывать на круглосуточную работу.

В текущем руководстве первого запуска указаны Node. js 24.16+ или 26.1+, рекомендована линейка Node 26. Требования быстро меняются, поэтому перед установкой сверяйте их с документацией, особенно если уже используете Node для других проектов.

Для обращения к модели нужен подходящий способ авторизации. OpenClaw поддерживает API-ключи и некоторые сценарии входа через аккаунт провайдера; доступность зависит от самого провайдера. Для постоянного Gateway документация называет API-ключ предсказуемым вариантом. Условия подписки на чат не следует автоматически считать условиями API — это разные способы подключения.

Установить OpenClaw и проверить Gateway

Ниже путь для терминала macOS или Linux. Для Windows на странице установки есть отдельные варианты; команды из разных инструкций не нужно смешивать.

Официальный установщик:

curl -fsSL https://openclaw.ai/install.sh | bash

Он запускает мастер настройки. Выберите подходящую модель и способ входа. Если настройка подхватила существующий доступ автоматически, проверьте, какой именно провайдер выбран: от него будут зависеть ограничения и расходы.

В нынешнем Quick start Gateway остаётся работать в открытом терминале. Для фоновой службы остановите этот запуск через Ctrl+C и установите службу:

openclaw gateway install

Затем проверьте статус и откройте интерфейс:

openclaw gateway status
openclaw dashboard

Порядок описан в quickstart OpenClaw. Сначала добейтесь обычного ответа модели в веб-интерфейсе. Если он не работает, подключение Telegram только добавит ещё один слой диагностики.

Подключить Telegram-бота

Создать отдельного бота

Откройте в Telegram официальный аккаунт @BotFather, отправьте /newbot и пройдите создание бота. Сохраните полученный токен локально: он нужен OpenClaw для подключения. Для эксперимента удобнее отдельный бот, который не обслуживает клиентов в другой системе.

По инструкции Telegram setup токен можно добавить в конфигурацию ~/.openclaw/openclaw.json. В существующем файле объедините настройки, сохранив параметры модели и остальные разделы. Пример фрагмента, а не замена всего файла:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "PASTE_YOUR_BOT_TOKEN_LOCALLY",
      "dmPolicy": "pairing"
    }
  }
}

Вместо заполнителя вставьте свой токен только на компьютере, где работает Gateway. Команда openclaw channels login telegram для этого сценария не используется.

Подтвердить личный чат

Проверьте, что канал настроен:

openclaw channels status --probe

Напишите сообщение своему боту. При политике pairing появится запрос на сопряжение. На компьютере с OpenClaw выполните:

openclaw pairing list telegram
openclaw pairing approve telegram YOUR_PAIRING_CODE

Замените YOUR_PAIRING_CODE кодом собственного запроса. Подтверждение относится к доступу этого пользователя в личном чате. Оно не означает автоматическое разрешение команд из всех групп.

Для постоянного бота одного владельца документация рекомендует allowlist с числовым Telegram ID. Получить свой ID можно из ответа на запрос сопряжения. Не путайте его с ID группы и не заменяйте именем @username.

Первая задача с ограниченными инструментами

Для проверки транспорта не нужны shell, рабочие файлы и отправка сообщений другим людям. Если используете обычное подключение API-модели, начните с ограниченного профиля инструментов OpenClaw. В существующую конфигурацию можно добавить:

{
  "tools": {
    "profile": "minimal",
    "deny": ["gateway"]
  }
}

В текущей политике инструментов minimal оставляет небольшой служебный набор; дополнительный запрет gateway убирает и инструмент обновления Gateway. Это настройка инструментов OpenClaw. Если подключаете отдельный coding runtime со своим набором действий, отдельно проверяйте его правила доступа.

Теперь отправьте в Telegram учебный бриф:

Учебная заявка: небольшой онлайн-школе нужен бот,
который отвечает на вопросы о расписании.
Программы занятий и базы учеников у тебя нет.

Подготовь:
1. Краткое описание задачи.
2. Пять вопросов перед оценкой разработки.
3. Черновик ответа клиенту до 800 знаков.

Не придумывай стоимость, сроки и функции.
Ничего не отправляй другим людям и не меняй настройки.

Оцените результат: агент отделил известное от неизвестного, не придумал цену, спросил про источник расписания и предложил текст, который менеджер действительно может проверить? Если нет, до подключения дополнительных сервисов поправьте само задание.

Следующий тест — такой же бриф с неполными или противоречивыми данными. Хороший результат здесь — уточняющий вопрос, а не уверенно выдуманное решение. После нескольких проверок станет понятнее, какую часть работы стоит автоматизировать.

Какие доступы выдавать дальше

Привязка Telegram, разрешения инструментов и доступ к рабочим сервисам — разные настройки. Сначала решите, от чьего имени работает помощник и какой конкретный результат ему разрешено записывать или отправлять.

Для первой рабочей версии полезен простой список:

  • Один владелец или известный список пользователей бота.
  • Отдельная тестовая папка с копиями документов вместо всей домашней директории.
  • Только нужные инструменты: чтение справки не требует удаления файлов или произвольных команд.
  • Отдельный этап проверки перед сообщением клиенту, изменением заказа или другой внешней операцией.

Права задаются конфигурацией. Фраза «ничего не удаляй» в запросе не заменяет ограничение инструмента. В справке по разрешениям отдельно разбираются файловый доступ, выполнение команд и сообщения между чатами.

Песочница тоже не включается от самого факта установки: документация sandboxing описывает её как отдельный механизм, который по умолчанию выключен. Перед расширением доступа нужно настроить именно тот режим, который соответствует выбранному сценарию.

Из чего складываются расходы

Считать нужно весь процесс, а не стоимость одного короткого ответа. На бюджет влияют выбранная модель, объём контекста, число повторных обращений, дополнительные сервисы и размещение Gateway.

Статья расходовЧто проверить
Языковая модельСпособ оплаты, лимиты аккаунта, входные и выходные токены
Поиск и другие инструментыСобственные условия и квоты подключённых сервисов
Компьютер или серверПостоянная работа, хранение данных и резервные копии
ПоддержкаОбновления, разбор ошибок и изменение подключений

В описании токенов и стоимости показано, что контекст состоит не только из последней фразы: в запрос могут входить инструкции, история и результаты инструментов. Поэтому два сообщения одинаковой длины не обязательно стоят одинаково.

Начните с небольшого числа учебных задач и посмотрите реальное потребление. Команда /status показывает состояние сеанса, /usage tokens включает информацию о токенах в ответах. Денежные оценки зависят от способа авторизации; сверяйте их с кабинетом провайдера, как объясняет справка Usage tracking. Фиксированную цену «помощника на месяц» без сценария и измерений назвать нельзя.

Если бот молчит

Проверяйте цепочку по порядку: Gateway запущен, модель отвечает в dashboard, Telegram-канал готов, ваш запрос сопряжения подтверждён. Сообщение в группе добавляет отдельные правила доступа и упоминаний, поэтому первый тест удобнее проводить в личном чате.

Для журнала событий используется:

openclaw logs --follow

В таблице диагностики каналов разобраны ошибки токена, доступа и сетевого соединения. Если Telegram не получает ответ, не надо первым действием переустанавливать OpenClaw: сначала найдите, на каком участке остановилась обработка.

Когда контрольный сценарий работает, можно проектировать следующую версию: откуда брать данные, кто подтверждает действия и где хранится результат. Подобную работу с клиентскими диалогами я описал в кейсе Telegram Agent. Если хотите разобрать свою задачу, напишите мне в Telegram: начнём с процесса и критериев готовности.

Если удобнее сначала собрать вводные, используйте форму заявки: опишите текущую работу, желаемый результат и системы, с которыми понадобится связать помощника.