📚 Документация
Каждая функция, каждая настройка.
Всё, что делает приложение, и все его настройки — для той версии, что у вас установлена. От строки меню до реестра навыков — вся инструкция целиком.
На этой странице
Быстрый старт Приложение в строке меню Настройки с пояснениями Вкладка «Модель» Вкладка «Telegram» Страницы ботов Вкладка «Приложение» Навыки и функции Реестр навыков Обновления Данные и конфиденциальность Устранение неполадокБыстрый старт
- Установка. Скачайте .dmg и перетащите Telebot AI в Applications. Сборка пока не нотаризована, поэтому если macOS покажет предупреждение, щёлкните по приложению правой кнопкой (Control-click) и выберите Открыть — один раз.
- Создайте бота. Напишите @BotFather в Telegram, выполните /newbot и скопируйте токен. Один токен на бота — можно запускать несколько.
- Добавьте токен. Откройте Telebot AI из строки меню, откройте настройки и вставьте токен в поле Token бота. Он сохраняется в момент ввода — кнопки «Сохранить» нет.
- Подключите мозг. На вкладке Модель укажите URL сервера (http://localhost:11234 для mlx-serve, http://localhost:11434 для Ollama) и название модели или используйте любой совместимый с OpenAI облачный API. Нажмите Проверить, чтобы проверить подключение.
- Запустите бота. Вернитесь в строку меню и выберите Запустить бота. Напишите боту в Telegram — с этого момента он отвечает.
Впервые с локальными моделями? Читать гайд — в нём рассказывается про mlx-serve, Ollama и LM Studio и сколько RAM нужно каждой модели.
Приложение в строке меню
Telebot AI живёт в вашей строке меню (значок ⌘). Меню даёт вам:
- Запустить / Остановить / Перезапустить — для каждого бота и для всех сразу. Боты работают как LaunchAgents: всегда включены и не мешают.
- Открыть настройки — окно настроек.
- Журналы — следите за журналом бота, чтобы видеть, что он делает, или отладить проблему.
- Выйти — останавливает всё (и отключает LaunchAgents, пока вы не запустите снова).
Настройки с пояснениями
В окне настроек есть боковая панель с двумя видами страниц:
- По умолчанию — Модель, Telegram, Приложение, Навыки и функции, Реестр навыков, О приложении, Обновления. Значения, которые наследуют все боты.
- Боты — по странице на бота. Каждое поле показывает, что этот бот использует на самом деле: значение переопределяет умолчание, пустое поле наследует его (об этом говорит пояснение под каждой строкой). Поэтому здесь нет флажков «Использовать глобально» — пустое поле и есть «использовать глобально».
Всё сохраняется автоматически по мере ввода или переключения. Настройки хранятся в ~/.mlx-serve/config.json.
По умолчанию → Модель
| Настройка | Что делает |
|---|---|
| URL сервера | Совместимый с OpenAI endpoint. Локальным серверам ключ не нужен. |
| Ключ API | Пусто для локальных серверов (mlx-serve, Ollama, LM Studio). Кнопка-глаз показывает или скрывает его. |
| Название модели | Какая модель на этом сервере, напр. deepseek-v4-flash-free. |
| Проверить | Проверяет подключение с текущими значениями — полезно перед сохранением. |
| Резервные модели | Пробуются по порядку, когда основной провайдер недоступен или ограничивает. У каждой — свой псевдоним, URL, ключ и модель, плюс «Проверить», изменение порядка и удаление. «Добавить» недоступно, пока не заполнена последняя строка. |
По умолчанию → Telegram
| Настройка | Что делает |
|---|---|
| Разрешённые ID чатов | ID пользователей/групп через запятую, которым разрешено общаться с ботом. Пусто = все. |
| Время ежедневного брифинга | Когда бот отправляет ежедневный брифинг — выпадающие списки часы/минуты в 24-часовом формате (напр. 08:00). |
| Промпт брифинга | Что должен охватывать брифинг — напр. «погода, мои напоминания на сегодня и все ценовые оповещения». |
| Макс. токенов ответа | Потолок безопасности для ответов; длинные ответы разбиваются на несколько сообщений. |
| Контекст на чат | Сколько последних сообщений бот хранит по каждому чату для контекста. |
| Воспоминаний на пользователя | Долговременные воспоминания, извлекаемые на пользователя за каждое сообщение, на которое отвечает бот. |
| Размер базы памяти (на пользователя) | Максимум хранимых воспоминаний на пользователя; сверх лимита удаляются самые старые. |
| Токены отчётов исследований | Бюджет для отчётов /research и /insiders. |
| Тайм-аут API (с) | Секунды до отказа от медленного провайдера — очереди бесплатного тарифа могут зависать на минуту и дольше. |
| Файл Soul | Персона, с которой работают боты. Файлы .md в этой папке (soul*.md, *persona*.md) появляются в меню Soul каждого бота. |
| Слова-триггеры бота | Слова через запятую, заставляющие бота отвечать в группах (кроме @упоминания, ответа или команды) — напр. «momo, jarvis, hey bot». |
| Слова-триггеры видеоклипов/аудиоклипов | Слова, заставляющие бота брать прикреплённое видео или аудио как клип — напр. «clip this, save this». |
Страницы ботов
У каждого бота в боковой панели своя страница. Пустые поля наследуют значения по умолчанию; пояснение под каждой строкой сообщает, что именно наследуется.
| Настройка | Что делает |
|---|---|
| Токен | Токен бота от @BotFather (кнопка-глаз, чтобы показать). При изменении переименовывается запись бота в боковой панели. |
| Псевдоним | Используется в статусе, журналах и боковой панели — напр. «Trading». |
| Разрешённые ID чатов / Слова-триггеры / Слова для клипов | Переопределения соответствующих значений по умолчанию для этого бота. |
| URL сервера, Ключ API, Модель | Выпадающий список предлагает провайдеров, настроенных в разделе «По умолчанию → Модель», плюс любое своё значение. Для каждого бота можно добавить собственные резервные модели. |
| Время ежедневного брифинга / Промпт брифинга | Брифинг для каждого бота с кнопкой «Использовать глобально», которая сбрасывает переопределение. |
| Режим | Исследователь, Ассистент, Программист, Шеф-повар или Нет — пусто означает режим по умолчанию. |
| Файл Soul | Переопределение персоны этого бота, выбранное из файлов soul/persona, найденных на диске. |
| Навыки | Открывает лист навыков бота: отключайте навыки для этого бота поверх значений по умолчанию или сбрасывайте к умолчанию. |
По умолчанию → Приложение
| Настройка | Что делает |
|---|---|
| Показывать в Dock | Показывать ли приложение строки меню также в Dock. |
| Запускать при входе | Запускать Telebot AI при входе в систему. |
| Папка данных | Где хранятся конфигурация, память, напоминания и журналы (по умолчанию ~/.mlx-serve). |
| Открыть журнал / Открыть папку данных | Переход прямо к файлу журнала или папке данных в Finder. |
| Экспорт настроек | Сохранить всю конфигурацию (включая ключи API) в файл — для резервных копий или переноса на другой Mac. |
| Импорт настроек | Загрузить файл конфигурации и применить его сразу. |
Навыки и функции
Способности бота — это управляемые моделью навыки: простые инструкции, которым модель следует с помощью своих инструментов. Поэтому можно описывать, что нужно, обычным языком, а не заучивать команды. У каждой группы есть главный переключатель; отдельные навыки можно включать и выключать.
| Группа | Навыки | Попробуйте сказать |
|---|---|---|
| Исследования | stock-research, stocks-crypto, insider-trading, currency | «исследуй TSLA», «цена BTC», «инсайдерские сделки по AAPL», «сколько 50 USD в CAD?» |
| Ежедневное | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | «/briefing», «сделай сводку этого чата», «напомни мне в 17:00», «отметь сегодняшнюю привычку», «еженедельный обзор», «/pomodoro 25», «запиши обед за 25» |
| Медиа | media, voice, translation, feeds | «проанализируй это видео», «прочитай это вслух», «переведи это на китайский», «что нового в моих лентах?» |
| Инструменты | memory | «о чём мы говорили вчера?» |
| Из реестра | Навыки, которые вы устанавливаете из реестра | — |
Реестр навыков
Вкладка реестра позволяет устанавливать готовые навыки из публичного каталога anthropics/skills — работа с PDF и документами, таблицы, презентации, тестирование веб-приложений, сборка MCP-серверов, арт и многое другое. Загрузите каталог, выберите навык — и он появится во вкладке «Навыки и функции», как и любой другой.
Обновления
Вкладка «Обновления» сверяет манифест сайта с вашей установленной версией и показывает последний релиз со ссылкой на скачивание. Проверки тихие — офлайн или недоступность манифеста просто означает «актуальная версия». Чтобы обновиться: скачайте новый .dmg и перетащите его поверх старого приложения в Applications. Настройки, боты и воспоминания хранятся вне приложения, поэтому переносятся без изменений.
Данные и конфиденциальность
- Где всё хранится: конфигурация, память чатов, напоминания, навыки и журналы — всё остаётся в вашей папке данных (по умолчанию ~/.mlx-serve).
- Что покидает ваш Mac: сам API Telegram, сервер модели, на который вы направили бота, и анонимная статистика использования (запуски приложения и действия в меню). Никакого содержимого чатов, токенов и личных данных.
Устранение неполадок
- «Apple не может проверить приложение на наличие вредоносного ПО» — ожидаемо: щёлкните правой кнопкой (Control-click) по приложению в Applications → Открыть → снова Открыть. Один раз — и дальше оно работает как обычно.
- Бот не отвечает. Откройте настройки → страницу бота: токен верный? Затем «По умолчанию → Модель» → Проверить провайдера. Потом загляните в журнал (строка меню → «Журналы» или вкладка «Приложение» → «Открыть журнал»).
- Ответы медленные или бот замолкает. Провайдеры бесплатного тарифа могут зависать на минуту и дольше — увеличьте тайм-аут API и добавьте резервные модели, чтобы бот переключался, когда основной ограничивает.
- Локальный сервер не отвечает. Убедитесь, что сервер действительно запущен (mlx-serve, Ollama…), прежде чем проверять его на вкладке «Модель».
- Обновления странно пишут «актуальная версия». Проверка тихая по замыслу — если манифест недоступен, сообщается, что всё актуально.
- Что-то ещё? Отправить отзыв — каждое сообщение попадает в Telegram разработчика и получает настоящий ответ.
Скачать Telebot AI · Нравится? Угостите меня кофе ☕