Руководство пользователя

Подключения

Руководство

На странице Подключения вы связываете Krabli с тремя внешними сервисами: ботом, AI-ключом OpenRouter и Telegram-аккаунтом. Порядок не важен, но для начала работы нужен хотя бы бот.


Два типа доступа к Telegram

Krabli использует два принципиально разных вида Telegram-аккаунтов, и важно понять оба ещё до того, как вы что-либо подключаете.

Боты — это специальные аккаунты автоматизации в Telegram. Вы создаёте бота в BotFather и передаёте Krabli его токен. Бот может действовать только в тех каналах, где его явно назначили администратором: публиковать и редактировать сообщения. Он не может самостоятельно вступать в каналы, создавать каналы или действовать за пределами тех, в которых он администратор. Krabli использует вашего бота для доставки предложений в Backstage и публикации одобренных постов в главный канал.

Пользовательские аккаунты (иногда называемые «юзерботами») — это обычные Telegram-аккаунты, которыми управляет сервис. В отличие от ботов, они могут вступать в публичные каналы как участники, читать все посты, создавать и настраивать каналы — всё то, что вы сами делаете в Telegram каждый день. Чтение каналов-источников требует именно такого аккаунта — бот с этим не справится.

Для пользовательских операций Krabli использует один из двух вариантов: собственные управляемые аккаунты Krabli (по умолчанию — ничего делать не нужно) или ваш собственный привязанный аккаунт. Это самый важный выбор на странице Подключения, и он касается права собственности: при использовании аккаунтов Krabli эти аккаунты принадлежат Krabli; при использовании собственного аккаунта владелец — вы. Подробное сравнение — в разделе Кто читает ваши каналы-источники ниже.


Ваш бот

Для чего нужен бот

Ваш Telegram-бот — это лицо Krabli в ваших каналах. Он отправляет предложения в Backstage, публикует одобренные посты в главном канале и выполняет все действия с сообщениями от имени Krabli. Бот создаёте вы — Krabli им управляет.

Способ А — Подключить токен из BotFather

  1. Создайте бота через @BotFather в Telegram.
    (Не знакомы с BotFather? Смотрите официальное руководство Telegram.)
  2. Скопируйте токен, который выдал BotFather (вид: 123456789:ABCdef...).
  3. Вставьте его в поле Токен бота на странице Подключения и нажмите Подключить.

Как Krabli использует это
Токен позволяет Krabli отправлять и редактировать сообщения в любом канале, где ваш бот добавлен администратором.
Риск: Любой, у кого есть ваш токен, может писать от имени вашего бота.
Защита: Krabli шифрует токен в момент отправки. Он хранится в защищённом хранилище и никогда не отображается в исходном виде — даже команда Krabli не имеет к нему доступа. На странице видны только последние четыре символа.
Ваш контроль: Токен можно заменить или удалить в любое время. Вы также можете отозвать его напрямую в BotFather — это немедленно отключит бота от Krabli.

Способ Б — Создать бота автоматически

Нажмите Создать бота за меня. Управляющий бот Krabli откроет окно авторизации Telegram. Подтвердите — и Telegram создаст бота для вашего рабочего пространства.

Как Krabli использует это
Управляющий бот запрашивает токен через официальный API Telegram — стандартная схема для всех Telegram-сервисов. Вы видите, что именно авторизуете, до любых действий.
Риск: До удаления бота через BotFather Krabli может обновить его токен — так устроены управляемые боты.
Защита: Telegram обязательно показывает экран подтверждения. Вы можете удалить бота через BotFather в любое время — все токены будут аннулированы.
Ваш контроль: Переключиться на самостоятельно управляемый токен (Способ А) можно в любой момент на странице Подключения.

Статус бота

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

Замена бота

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


AI-ключ

Для чего нужен AI-ключ

Режимы Filter и Editor используют AI-модели для обработки постов. AI предоставляется через OpenRouter — платформу, открывающую доступ к разным моделям. Вы платите OpenRouter напрямую по опубликованным тарифам; Krabli не взимает наценку.

Для режима Relay AI-ключ не нужен.

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

  1. Войдите в OpenRouter, создайте API-ключ и установите месячный лимит расходов.
    (Подробности — в документации OpenRouter.)
  2. Вставьте ключ в поле Ключ OpenRouter на странице Подключения и нажмите Сохранить.

Как Krabli использует это
Krabli отправляет текст постов в AI-модели через ваш ключ. Расходы появляются в вашем аккаунте OpenRouter.
Риск: Украденный ключ может расходовать ваш баланс OpenRouter до установленного лимита.
Защита: Ключ шифруется немедленно и хранится в защищённом хранилище. Он не отображается в открытом виде ни для кого, включая команду Krabli.
Ваш контроль: Установите лимит расходов в личном кабинете OpenRouter. Замените или удалите ключ на странице Подключения в любое время — агенты, которым нужен AI, встанут на паузу.

Что происходит без ключа

Агенты в режиме Relay продолжают работать в обычном режиме. Агенты в режиме Filter и Editor встают на паузу со статусом «ожидает AI-ключ» и автоматически возобновляют работу, когда ключ будет добавлен.


Привязанный Telegram-аккаунт

Для чего нужна привязка

Привязанный аккаунт позволяет Krabli:

  • Вступать в каналы-источники как участник, читать их посты и пропускать их через конвейер ваших агентов — чтобы до Backstage доходило только лучшее
  • Автоматически создавать и настраивать ваши каналы Backstage, главный и dropped (кнопка «Настроить за меня» на странице Назначения)
  • Создавать зонтичные каналы для дополнительных языков

Без привязанного аккаунта Krabli может читать только полностью публичные каналы, а каналы нужно настраивать вручную.

Настоятельно рекомендуем создать отдельный Telegram-аккаунт специально для Krabli — вместо привязки личного.

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

Второй аккаунт в Telegram бесплатен. Нужен только номер телефона — можно использовать виртуальный.

  1. На странице Подключения нажмите Привязать Telegram-аккаунт.
  2. Прочитайте соглашение и поставьте галочку подтверждения.
  3. На странице появится QR-код.
  4. На том аккаунте Telegram, который хотите привязать, перейдите в Настройки → Устройства → Привязать устройство и отсканируйте QR-код.
  5. Если на аккаунте включён пароль двухэтапной проверки, введите его, когда страница попросит.

Как Krabli использует это
Krabli сохраняет сессию вашего аккаунта — такую же, как на любом из ваших устройств. Сессия используется для создания и настройки каналов вашего рабочего пространства, а при включении режима собственного чтения — также для чтения каналов-источников.
Риск: Telegram-сессия открывает полный доступ к аккаунту — технически такой же, как у владельца: сообщения, контакты, участие в каналах, всё. Krabli использует её только для управления каналами и чтения источников, но сама сессия не ограничена по правам.
Защита: Сессия хранится в зашифрованном хранилище Krabli и никогда не записывается на диск. Вы можете видеть её в Telegram в разделе Настройки → Устройства (отображается имя приложения Krabli, последний IP и дата активности).
Ваш контроль: Завершите сессию в любой момент через Telegram Настройки → Устройства — эффект мгновенный. Или нажмите Отвязать на странице Подключения — результат тот же.

Как отвязать аккаунт

Нажмите Отвязать на странице Подключения. Krabli немедленно прекращает использовать сессию. Функции, требующие привязки (автонастройка каналов, зонтичные каналы), будут недоступны до повторной привязки.


Кто читает ваши каналы-источники

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

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

Переключиться на свой аккаунт

На странице Подключения найдите Кто читает мои каналы? и переключитесь с Аккаунты Krabli на Мой аккаунт.

Для переключения необходим привязанный и работающий Telegram-аккаунт. Перед изменением Krabli покажет соглашение и предложит подтвердить:

  • Krabli будет вступать в каналы-источники через ваш аккаунт
  • Ограничения Telegram будут применяться к вашему аккаунту

После подтверждения все каналы, на которые подписано ваше рабочее пространство, переходят в очередь вашего аккаунта. Новые каналы вступают с тем же темпом (не более 4 в час, 12 в день). Страница Источники показывает состояние каналов с точки зрения вашего аккаунта и отмечает, когда каналы присоединяются от вашего имени.

Как Krabli использует это
После переключения Krabli открывает вашу Telegram-сессию в памяти для вступления и чтения каналов-источников. Сессия никогда не записывается на диск; ваш аккаунт не добавляется ни в один из ваших выходных каналов.
Риск: Ваш Telegram-аккаунт вступает в отслеживаемые каналы-источники. Ограничения Telegram применяются к вашему аккаунту. Быстрое вступление в большое количество каналов может привести к временной блокировке.
Защита: Krabli использует тот же осторожный темп, что и для собственных аккаунтов — не более 4 в час и 12 в день. При срабатывании ограничения вступление приостанавливается и возобновляется автоматически.
Ваш контроль: Вернитесь на аккаунты Krabli в любой момент на странице Подключения. Ваши каналы немедленно передаются обратно в очередь Krabli.

Если ваш аккаунт перестал работать

Если сессия отозвана или возникла проблема, пока Krabli использует её для чтения каналов, чтение источников прекращается, а аккаунт помечается как Требует внимания на странице Подключения. Повторная привязка аккаунта или возврат на аккаунты Krabli автоматически возобновит чтение.


Как Krabli защищает ваши данные

Все три учётные данные — токен бота, AI-ключ и сессия Telegram — обрабатываются одинаково:

  1. Вы вводите → шифруется немедленно. Веб-приложение Krabli шифрует данные до их отправки на сервер. Сервер никогда не видит их в открытом виде.
  2. Хранится в защищённом хранилище. Krabli использует шифрование AES-256-GCM (стандарт индустрии) с ключом, доступным только серверному процессу, отвечающему за подключения. Никакой другой сервис и ни один сотрудник Krabli не могут прочитать ваши данные.
  3. Никогда не отображается повторно. После сохранения учётные данные можно только заменить или удалить — не прочитать. Приложение показывает лишь последние четыре символа токена.
  4. Удалить можно в любой момент. Удаление через Krabli не отзывает доступ у провайдера — но вы можете сделать это самостоятельно: через BotFather, в настройках OpenRouter или в разделе активных устройств Telegram.