📚 Документація
Кожна функція, кожне налаштування.
Усе, що вміє застосунок, і кожне його налаштування — написано для версії, яку ви використовуєте. Від рядка меню до реєстру навичок — це повний посібник.
На цій сторінці
Швидкий старт Застосунок у рядку меню Налаштування з поясненнями Вкладка «Модель» Вкладка «Telegram» Сторінки окремих ботів Вкладка «Застосунок» Навички & функції Реєстр навичок Оновлення Дані & конфіденційність Усунення неполадокШвидкий старт
- Встановіть. Завантажте .dmg і перетягніть Telebot AI у папку «Програми». Збірка ще не нотарізована, тому якщо macOS покаже попередження, клацніть застосунок правою кнопкою (Control-клік) і виберіть Відкрити — один раз.
- Створіть бота. Напишіть @BotFather у Telegram, виконайте /newbot і скопіюйте токен. Один токен на бота — можна запускати кількох.
- Додайте токен. Відкрийте Telebot AI з рядка меню, відкрийте «Налаштування» та вставте токен у поле Токен бота. Він зберігається одразу під час введення — кнопки «Зберегти» немає.
- Підключіть мозок. На вкладці Модель вкажіть 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 точка доступу. Локальним серверам ключ не потрібен. |
| Ключ 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 і перетягніть його поверх старого застосунку в папці «Програми». Налаштування, боти та спогади зберігаються поза застосунком, тому перенесуться без змін.
Дані & конфіденційність
- Де зберігаються дані: конфігурація, пам'ять чатів, нагадування, навички та журнали — усе залишається у вашій папці даних (за замовчуванням ~/.mlx-serve).
- Що залишає ваш Mac: сам API Telegram, вибраний вами сервер моделі, на який вказує бот, та анонімна статистика використання (запуски застосунку та дії в меню). Жодного вмісту чатів, токенів чи особистих даних.
Усунення неполадок
- «Apple cannot check it for malicious software» — це очікувано: клацніть застосунок у папці «Програми» правою кнопкою (Control-клік) → Відкрити → Відкрити ще раз. Один раз — і далі він працює нормально.
- Бот не відповідає. Відкрийте «Налаштування» → сторінку бота: чи правильний токен? Потім «За замовчуванням → Модель» → Тест провайдера. Далі перевірте журнал (рядок меню → «Журнали» або вкладка «Застосунок» → «Відкрити журнал»).
- Відповіді повільні або бот замовкає. Провайдери безкоштовного тарифу можуть зависати на хвилину і більше — збільште тайм-аут API та додайте резервні моделі, щоб бот перемикався, коли основний провайдер обмежує.
- Локальний сервер не відповідає. Переконайтеся, що сервер справді запущено (mlx-serve, Ollama…), перш ніж тестувати на вкладці «Модель».
- Оновлення дивно кажуть «актуальна версія». Перевірка за задумом тиха — якщо маніфест недоступний, вона повідомляє про актуальну версію.
- Щось інше? Надіслати відгук — кожне повідомлення потрапляє в Telegram розробника та отримує справжню відповідь.
Завантажити Telebot AI · Подобається? Пригости мене кавою ☕