📚 Dokumentacja
Każda funkcja, każde ustawienie.
Wszystko, co robi aplikacja, i każde jej ustawienie — napisane dla wersji, którą masz. Od paska menu po rejestr umiejętności — to cała instrukcja.
Na tej stronie
Szybki start Aplikacja w pasku menu Ustawienia wyjaśnione Zakładka Model Zakładka Telegram Strony poszczególnych botów Zakładka Aplikacja Umiejętności & funkcje Rejestr umiejętności Aktualizacje Dane & prywatność Rozwiązywanie problemówSzybki start
- Instalacja. Pobierz .dmg i przeciągnij Telebot AI do Aplikacji. Build nie jest jeszcze notarializowany, więc jeśli macOS pokaże ostrzeżenie, kliknij aplikację prawym przyciskiem (Control-klik) i wybierz Otwórz — raz.
- Utwórz bota. Napisz do @BotFather na Telegramie, wpisz /newbot i skopiuj token. Jeden token na bota — możesz uruchomić kilka.
- Dodaj token. Otwórz Telebot AI z paska menu, otwórz Ustawienia i wklej token w pole Token bota. Zapisuje się w chwili wpisania — nie ma przycisku Zapisz.
- Podłącz mózg. W zakładce Model ustaw URL serwera (http://localhost:11234 dla mlx-serve, http://localhost:11434 dla Ollama) i nazwę modelu albo użyj dowolnego zgodnego z OpenAI API w chmurze. Kliknij Test, aby sprawdzić połączenie.
- Uruchom bota. Wróć do paska menu i wybierz Uruchom bota. Napisz do swojego bota na Telegramie — od tej chwili odpowiada.
Nowy w lokalnych modelach? Przeczytaj poradnik — omawia mlx-serve, Ollama i LM Studio oraz ile RAM-u potrzebuje każdy model.
Aplikacja w pasku menu
Telebot AI mieszka w Twoim pasku menu (ikona ⌘). Menu daje Ci:
- Uruchom / Zatrzymaj / Uruchom ponownie — dla każdego bota i wszystkich naraz. Boty działają jako LaunchAgenty: zawsze włączone, nie wchodzą w drogę.
- Otwórz ustawienia — okno ustawień.
- Logi — podejrzyj log bota, aby zobaczyć, co robi, albo zdebugować problem.
- Zakończ — zatrzymuje wszystko (i wyłącza LaunchAgenty, dopóki nie uruchomisz ponownie).
Ustawienia wyjaśnione
Okno ustawień ma pasek boczny z dwoma rodzajami stron:
- Domyślne — Model, Telegram, Aplikacja, Umiejętności & funkcje, Rejestr umiejętności, O aplikacji, Aktualizacje. Wartości dziedziczone przez każdy bot.
- Boty — jedna strona na bota. Każde pole pokazuje, czego ten bot faktycznie używa: wartość nadpisuje domyślne, puste pole je dziedziczy (wyjaśnia to opis pod każdym wierszem). Dlatego nie ma pól wyboru „Użyj globalnych” — puste pole to jest „użyj globalnych”.
Wszystko zapisuje się automatycznie podczas pisania i przełączania. Ustawienia mieszkają w ~/.mlx-serve/config.json.
Domyślne → Model
| Ustawienie | Do czego służy |
|---|---|
| URL serwera | Punkt końcowy zgodny z OpenAI. Lokalne serwery nie potrzebują klucza. |
| Klucz API | Puste dla serwerów lokalnych (mlx-serve, Ollama, LM Studio). Przycisk oka pokazuje je lub ukrywa. |
| Nazwa modelu | Który model na tym serwerze, np. deepseek-v4-flash-free. |
| Test | Sprawdza połączenie z bieżącymi wartościami — przydatne, zanim cokolwiek zapiszesz. |
| Modele zapasowe | Próbowane po kolei, gdy główny zawiedzie lub zostanie przycięty. Każdy ma własny pseudonim, URL, klucz i model, a także Test, zmianę kolejności i usuwanie. Dodaj jest nieaktywne, dopóki ostatni wiersz nie będzie kompletny. |
Domyślne → Telegram
| Ustawienie | Do czego służy |
|---|---|
| Dozwolone ID czatów | Oddzielone przecinkami ID użytkowników/grup, które mogą rozmawiać z botem. Puste = każdy. |
| Godzina codziennego briefinga | Kiedy bot wysyła codzienny briefing — rozwijane godziny/minuty w formacie 24 h (np. 08:00). |
| Prompt briefinga | Co ma obejmować briefing — np. „pogoda, moje dzisiejsze przypomnienia i wszelkie alerty cenowe”. |
| Maks. tokenów odpowiedzi | Górna granica bezpieczeństwa dla odpowiedzi; długie odpowiedzi są dzielone na wiele wiadomości. |
| Kontekst na czat | Ile ostatnich wiadomości bot przechowuje na czat jako kontekst. |
| Wspomnienia na użytkownika | Długoterminowe wspomnienia przywoływane na użytkownika, za każdą wiadomość, na którą odpowiada bot. |
| Rozmiar bazy pamięci (na użytkownika) | Maks. wspomnień przechowywanych na użytkownika; powyżej tego limitu najstarsze są usuwane. |
| Tokeny raportów badawczych | Budżet na raporty /research i /insiders. |
| Limit czasu API (s) | Sekundy, po których porzucany jest wolny dostawca — kolejki darmowego planu potrafią stać ponad minutę. |
| Plik Soul | Persona, z którą działają boty. Pliki .md w tym folderze (soul*.md, *persona*.md) pojawiają się w menu rozwijanym Soul każdego bota. |
| Słowa wyzwalające bota | Oddzielone przecinkami słowa, które sprawiają, że bot odpowiada w grupach (poza @wzmianką, odpowiedzią lub komendą) — np. „momo, jarvis, hey bot”. |
| Słowa wyzwalające klipy wideo/audio | Słowa, które sprawiają, że bot traktuje dołączone wideo lub audio jako klip — np. „clip this, save this”. |
Strony poszczególnych botów
Każdy bot na pasku bocznym ma własną stronę. Puste pola dziedziczą domyślne; opis pod każdym wierszem mówi, co dziedziczy.
| Ustawienie | Do czego służy |
|---|---|
| Token | Token bota z @BotFather (przycisk oka odkrywa go). Zmiana tokenu zmienia nazwę bota na pasku bocznym. |
| Pseudonim | Używany w statusie, logach i na pasku bocznym — np. „Trading”. |
| Dozwolone ID czatów / Słowa wyzwalające / Słowa klipów | Zastąpienia odpowiadających domyślnych dla tego bota. |
| URL serwera, klucz API, model | Menu rozwijane oferuje dostawców skonfigurowanych w Domyślne → Model, plus dowolną wartość niestandardową. Własne modele zapasowe można dodać dla każdego bota. |
| Godzina codziennego briefinga / Prompt briefinga | Briefing per bot z przyciskiem „Użyj globalnych”, który czyści zastąpienie. |
| Tryb | Badacz, Asystent, Programista, Kucharz lub Brak — puste używa trybu domyślnego. |
| Plik Soul | Zastąpienie persony tego bota, wybrane spośród plików soul/persona znalezionych na dysku. |
| Umiejętności | Otwiera arkusz umiejętności bota — wyłącz umiejętności dla tego bota ponad domyślne albo przywróć domyślne. |
Domyślne → Aplikacja
| Ustawienie | Do czego służy |
|---|---|
| Pokaż w Docku | Czy aplikacja z paska menu pojawia się też w Docku. |
| Uruchamiaj przy logowaniu | Uruchamiaj Telebot AI przy logowaniu. |
| Katalog danych | Gdzie przechowywane są konfiguracja, pamięć, przypomnienia i logi (domyślnie ~/.mlx-serve). |
| Otwórz dziennik / Otwórz folder danych | Przejdź prosto do pliku logu lub folderu danych w Finderze. |
| Eksportuj ustawienia | Zapisz pełną konfigurację (w tym klucze API) do pliku — na potrzeby kopii zapasowej lub przenosin na innego Maca. |
| Importuj ustawienia | Wczytaj plik konfiguracji i zastosuj go natychmiast. |
Umiejętności & funkcje
Zdolności bota to umiejętności sterowane modelem — zwykłe instrukcje, które model wykonuje swoimi narzędziami, więc możesz opisać, czego chcesz, prostym językiem, zamiast zapamiętywać komendy. Każda grupa ma główny przełącznik; pojedyncze umiejętności można włączać i wyłączać.
| Grupa | Umiejętności | Spróbuj powiedzieć |
|---|---|---|
| Badania | stock-research, stocks-crypto, insider-trading, currency | „research TSLA”, „cena BTC”, „transakcje insiderów dla AAPL”, „ile to 50 USD w CAD?” |
| Codzienne | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | „/briefing”, „podsumuj ten czat”, „przypomnij mi o 17:00”, „oznacz dzisiejszy nawyk jako zrobiony”, „tygodniowy przegląd”, „/pomodoro 25”, „zapisz lunch za 25” |
| Media | media, voice, translation, feeds | „przeanalizuj to wideo”, „przeczytaj to na głos”, „przetłumacz to na chiński”, „co nowego w moich kanałach?” |
| Narzędzia | memory | „o czym rozmawialiśmy wczoraj?” |
| Z rejestru | Umiejętności zainstalowane z rejestru | — |
Rejestr umiejętności
Zakładka rejestru pozwala instalować gotowe umiejętności z publicznego katalogu anthropics/skills — obsługa PDF-ów i dokumentów, arkusze kalkulacyjne, prezentacje, testowanie aplikacji webowych, budowanie serwerów MCP, sztuka i więcej. Wczytaj katalog, wybierz umiejętność, a pojawi się w zakładce Umiejętności & funkcje jak każda inna.
Aktualizacje
Zakładka Aktualizacje porównuje manifest strony z zainstalowaną wersją i pokazuje najnowsze wydanie z linkiem do pobrania. Sprawdzanie jest ciche — offline lub brak dostępu oznacza po prostu „masz aktualną wersję”. Aby zaktualizować: pobierz nowy .dmg i przeciągnij go na starą aplikację w Aplikacjach. Ustawienia, boty i wspomnienia mieszkają poza aplikacją, więc przeniosą się bez zmian.
Dane & prywatność
- Gdzie rzeczy mieszkają: konfiguracja, pamięć czatu, przypomnienia, umiejętności i logi zostają w Twoim katalogu danych (domyślnie ~/.mlx-serve).
- Co opuszcza Twojego Maca: samo API Telegrama, serwer modelu, na który wskażesz bota, oraz anonimowe statystyki użycia (uruchomienia aplikacji i akcje w menu). Żadnych treści czatów, tokenów ani danych osobowych.
Rozwiązywanie problemów
- „Apple nie może sprawdzić, czy nie zawiera złośliwego oprogramowania” — to normalne: kliknij aplikację w Aplikacjach prawym przyciskiem (Control-klik) → Otwórz → Otwórz ponownie. Jeden raz, a potem działa normalnie.
- Bot nie odpowiada. Otwórz Ustawienia → stronę bota: czy token jest poprawny? Potem Domyślne → Model → Test dostawcy. Na koniec sprawdź log (pasek menu → Logi albo zakładka Aplikacja → Otwórz dziennik).
- Odpowiedzi są wolne albo bot milknie. Dostawcy z darmowego planu potrafią stać ponad minutę — podnieś limit czasu API i dodaj modele zapasowe, żeby bot przełączał się, gdy główny jest przycięty.
- Lokalny serwer nie odpowiada. Upewnij się, że serwer faktycznie działa (mlx-serve, Ollama…), zanim przetestujesz go w zakładce Model.
- Aktualizacje dziwnie mówią „masz aktualną wersję”. Sprawdzanie jest celowo ciche — jeśli manifest jest nieosiągalny, raportuje aktualną wersję.
- Coś innego? Wyślij opinię — każda wiadomość trafia na Telegram dewelopera i dostaje prawdziwą odpowiedź.
Pobierz Telebot AI · Podoba Ci się? Postaw mi kawę ☕