📚 Documentatie
Elke functie, elke instelling.
Alles wat de app doet en elke instelling die hij heeft — geschreven voor de versie die jij draait. Van de menubalk tot het vaardighedenregister: dit is de volledige handleiding.
Op deze pagina
Snelle start De menubalk-app Instellingen uitgelegd Tabblad Model Tabblad Telegram Pagina's per bot Tabblad App Vaardigheden & functies Vaardighedenregister Updates Gegevens & privacy Problemen oplossenSnelle start
- Installeren. Download de .dmg en sleep Telebot AI naar Applications. De build is nog niet genotariseerd, dus als macOS een waarschuwing toont, klik dan met de rechtermuisknop (Control-klik) op de app en kies Open — één keer.
- Een bot maken. Stuur @BotFather een bericht op Telegram, voer /newbot uit en kopieer het token. Eén token per bot — je kunt er meerdere draaien.
- Het token toevoegen. Open Telebot AI vanuit de menubalk, open Instellingen en plak het token in het veld Token van een bot. Het wordt opgeslagen zodra je typt — er is geen knop Opslaan.
- Een brein aansluiten. Stel op het tabblad Model de server-URL in (http://localhost:11234 voor mlx-serve, http://localhost:11434 voor Ollama) en de modelnaam, of gebruik elke OpenAI-compatibele cloud-API. Druk op Testen om de verbinding te controleren.
- De bot starten. Kies terug in de menubalk voor Bot starten. Stuur je bot een bericht op Telegram — vanaf dat moment antwoordt hij.
Nieuw met lokale modellen? Lees de handleiding — hij behandelt mlx-serve, Ollama en LM Studio, en hoeveel RAM elk model nodig heeft.
De menubalk-app
Telebot AI leeft in je menubalk (⌘-pictogram). Het menu biedt je:
- Starten / Stoppen / Opnieuw starten — per bot en allemaal tegelijk. Bots draaien als LaunchAgents: altijd aan, uit je weg.
- Instellingen openen — het instellingenvenster.
- Logs — volg het logboek van de bot om te zien wat hij doet of om een probleem op te lossen.
- Stoppen — stopt alles (en schakelt de LaunchAgents uit tot je weer start).
Instellingen uitgelegd
Het instellingenvenster heeft een zijbalk met twee soorten pagina's:
- Standaarden — Model, Telegram, App, Vaardigheden & functies, Vaardighedenregister, Over, Updates. Waarden die elke bot erft.
- Bots — één pagina per bot. Elk veld toont wat deze bot werkelijk gebruikt: een waarde overschrijft de standaard, een leeg veld erft hem (de uitleg onder elke rij zegt dat). Daarom zijn er geen "Globaal gebruiken"-vakjes — een leeg veld is "globaal gebruiken".
Alles wordt automatisch opgeslagen terwijl je typt of schakelt. Instellingen leven in ~/.mlx-serve/config.json.
Standaarden → Model
| Instelling | Wat het doet |
|---|---|
| Server-URL | Het OpenAI-compatibele eindpunt. Lokale servers hebben geen sleutel nodig. |
| API-sleutel | Leeg voor lokale servers (mlx-serve, Ollama, LM Studio). Met de oogknop toon of verberg je hem. |
| Modelnaam | Welk model op die server, bijv. deepseek-v4-flash-free. |
| Testen | Controleert de verbinding met de huidige waarden — handig voordat je iets opslaat. |
| Back-upmodellen | Op volgorde geprobeerd wanneer de primaire faalt of beperkt. Elk heeft zijn eigen bijnaam, URL, sleutel en model, plus Testen, herschikken en verwijderen. Toevoegen is uitgeschakeld tot de laatste rij compleet is. |
Standaarden → Telegram
| Instelling | Wat het doet |
|---|---|
| Toegestane chat-ID's | Door komma's gescheiden gebruikers-/groeps-ID's die met de bot mogen praten. Leeg = iedereen. |
| Tijd dagelijkse briefing | Wanneer de bot zijn dagelijkse briefing stuurt — 24-uurs uur/minuut-keuzelijsten (bijv. 08:00). |
| Briefing-prompt | Wat de briefing moet behandelen — bijv. "weer, mijn herinneringen voor vandaag en eventuele prijsmeldingen". |
| Max. antwoordtokens | Veiligheidslimiet voor antwoorden; lange antwoorden worden in meerdere berichten gesplitst. |
| Context per chat | Hoeveel recente berichten de bot per chat als context bewaart. |
| Herinneringen per gebruiker | Langetermijnherinneringen die per gebruiker worden opgeroepen, per bericht dat de bot beantwoordt. |
| Geheugendatabasegrootte (per gebruiker) | Max. opgeslagen herinneringen per gebruiker; de oudste worden daarboven verwijderd. |
| Onderzoeksrapporttokens | Budget voor /research- en /insiders-rapporten. |
| API-time-out (s) | Seconden voordat een trage provider wordt opgegeven — wachtrijen van het gratis niveau kunnen een minuut+ stagneren. |
| Soul-bestand | De persona waarmee de bots draaien. .md-bestanden in deze map (soul*.md, *persona*.md) verschijnen in het Soul-menu van elke bot. |
| Triggerwoorden van bot | Door komma's gescheiden woorden die de bot in groepen laten antwoorden (naast @mention, antwoord of commando) — bijv. "momo, jarvis, hey bot". |
| Triggerwoorden voor video/audio-clips | Woorden die de bot een bijgevoegde video of audio als clip laten behandelen — bijv. "clip this, save this". |
Pagina's per bot
Elke bot in de zijbalk heeft zijn eigen pagina. Lege velden erven de standaarden; de uitleg onder elke rij vermeldt wat hij erft.
| Instelling | Wat het doet |
|---|---|
| Token | Het @BotFather-token van de bot (oogknop om te tonen). Wijzigen hernoemt de zijbalkinvoer van de bot. |
| Bijnaam | Gebruikt in status, logs en de zijbalk — bijv. "Trading". |
| Toegestane chat-ID's / Triggerwoorden / Clipwoorden | De overschrijvingen van deze bot voor de bijbehorende standaarden. |
| Server-URL, API-sleutel, Model | De keuzelijst biedt de providers die in Standaarden → Model zijn geconfigureerd, plus elke aangepaste waarde. Per bot kunnen eigen back-upmodellen worden toegevoegd. |
| Tijd dagelijkse briefing / Briefing-prompt | Briefing per bot met een knop "Globaal gebruiken" die de overschrijving wist. |
| Modus | Onderzoeker, Assistent, Coder, Chef of Geen — leeg gebruikt de standaardmodus. |
| Soul-bestand | De persona-overschrijving van deze bot, gekozen uit de soul-/personabestanden op schijf. |
| Vaardigheden | Opent het vaardighedenblad per bot — schakel vaardigheden voor deze bot uit bovenop de standaarden, of herstel de standaard. |
Standaarden → App
| Instelling | Wat het doet |
|---|---|
| Tonen in Dock | Of de menubalk-app ook in het Dock verschijnt. |
| Starten bij inloggen | Start Telebot AI wanneer je inlogt. |
| Datamap | Waar configuratie, geheugen, herinneringen en logs leven (standaard ~/.mlx-serve). |
| Logboek openen / Datamap openen | Spring direct naar het logbestand of de datamap in Finder. |
| Instellingen exporteren | Sla de volledige configuratie (inclusief API-sleutels) op in een bestand — voor back-ups of het overzetten naar een andere Mac. |
| Instellingen importeren | Laad een configuratiebestand en pas het direct toe. |
Vaardigheden & functies
De mogelijkheden van de bot zijn modelgestuurde vaardigheden — gewone instructies die het model met zijn tools uitvoert, zodat je in gewone taal kunt beschrijven wat je wilt in plaats van commando's te onthouden. Elke groep heeft een hoofdschakelaar; individuele vaardigheden kunnen aan of uit worden gezet.
| Groep | Vaardigheden | Probeer te zeggen |
|---|---|---|
| Onderzoek | stock-research, stocks-crypto, insider-trading, currency | "onderzoek TSLA", "prijs van BTC", "insider-trades voor AAPL", "hoeveel is 50 USD in CAD?" |
| Dagelijks | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "vat deze chat samen", "herinner me om 17:00", "markeer de gewoonte van vandaag als gedaan", "wekelijkse evaluatie", "/pomodoro 25", "registreer lunch van 25" |
| Media | media, voice, translation, feeds | "analyseer deze video", "lees dit hardop voor", "vertaal dit naar het Chinees", "wat is er nieuw in mijn feeds?" |
| Hulpmiddelen | memory | "waar hadden we het gisteren over?" |
| Uit registry | Vaardigheden die je uit het register installeert | — |
Vaardighedenregister
Met het registry-tabblad installeer je kant-en-klare vaardigheden uit de openbare catalogus anthropics/skills — PDF- en documentverwerking, spreadsheets, presentaties, web-app-testen, MCP-serverbouw, kunst en meer. Laad de catalogus, kies een vaardigheid en hij verschijnt net als elke andere in het tabblad Vaardigheden & functies.
Updates
Het tabblad Updates vergelijkt het manifest van de landingspagina met je geïnstalleerde versie en toont de nieuwste release met een downloadlink. Controles zijn stil — offline of onbereikbaar betekent gewoon "up-to-date". Bijwerken: download de nieuwe .dmg en sleep hem over de oude app in Applications. Instellingen, bots en herinneringen leven buiten de app, dus die blijven onaangetast behouden.
Gegevens & privacy
- Waar dingen leven: configuratie, chatgeheugen, herinneringen, vaardigheden en logs blijven allemaal in je datamap (standaard ~/.mlx-serve).
- Wat je Mac verlaat: de Telegram-API zelf, de modelserver waar je de bot op richt, en anonieme gebruiksstatistieken (app-starts en menuacties). Geen chatinhoud, geen tokens, geen persoonlijke gegevens.
Problemen oplossen
- "Apple kan niet controleren of er schadelijke software in zit" — normaal: klik met de rechtermuisknop (Control-klik) op de app in Applications → Open → nog eens Open. Eén keer, daarna draait hij normaal.
- De bot antwoordt niet. Open Instellingen → de pagina van de bot: klopt het token? Ga dan naar Standaarden → Model → Test de provider. Controleer daarna het logboek (menubalk → Logs, of tabblad App → Logboek openen).
- Antwoorden zijn traag of de bot wordt stil. Providers van het gratis niveau kunnen een minuut+ stagneren — verhoog de API-time-out en voeg back-upmodellen toe, zodat de bot overschakelt wanneer de primaire beperkt.
- Lokale server reageert niet. Zorg dat de server daadwerkelijk draait (mlx-serve, Ollama…) voordat je test op het tabblad Model.
- Updates melden vreemd genoeg "up-to-date". De controle is bewust stil — als het manifest onbereikbaar is, meldt hij up-to-date.
- Iets anders? Feedback sturen — elk bericht komt terecht in de Telegram van de ontwikkelaar en krijgt een echt antwoord.
Download Telebot AI · Bevalt het? Trakteer me op een koffie ☕