📚 Documentation
Chaque fonctionnalité, chaque réglage.
Tout ce que l'app fait et chaque réglage qu'elle a — écrit pour la version que vous utilisez. De la barre de menus au registre de compétences, c'est le manuel complet.
Sur cette page
Démarrage rapide L'app de la barre de menus Les réglages, expliqués Onglet Modèle Onglet Telegram Pages par bot Onglet App Compétences et fonctions Registre de compétences Mises à jour Données et confidentialité DépannageDémarrage rapide
- Installez. Téléchargez le .dmg et glissez Telebot AI dans Applications. Le build n'est pas encore notarisé ; si macOS affiche un avertissement, faites un clic droit (Control-clic) sur l'app et choisissez Ouvrir — une fois.
- Créez un bot. Écrivez à @BotFather sur Telegram, lancez /newbot et copiez le token. Un token par bot — vous pouvez en faire tourner plusieurs.
- Ajoutez le token. Ouvrez Telebot AI depuis la barre de menus, ouvrez les Réglages et collez le token dans le champ Token d'un bot. Il est sauvegardé dès que vous tapez — il n'y a pas de bouton d'enregistrement.
- Branchez un cerveau. Dans l'onglet Modèle, définissez l'URL du serveur (http://localhost:11234 pour mlx-serve, http://localhost:11434 pour Ollama) et le nom du modèle, ou utilisez n'importe quelle API cloud compatible OpenAI. Appuyez sur Tester pour vérifier la connexion.
- Lancez le bot. Revenez à la barre de menus et choisissez Démarrer le bot. Écrivez à votre bot sur Telegram — il répond à partir de ce moment.
Nouveau avec les modèles locaux ? Lisez le guide — il couvre mlx-serve, Ollama et LM Studio, et la RAM nécessaire à chaque modèle.
L'app de la barre de menus
Telebot AI vit dans votre barre de menus (icône ⌘). Le menu vous donne :
- Démarrer / Arrêter / Redémarrer — par bot ou tous d'un coup. Les bots tournent comme LaunchAgents : toujours actifs, jamais dans vos jambes.
- Ouvrir les réglages — la fenêtre des réglages.
- Journaux — suivez le journal du bot pour voir ce qu'il fait ou déboguer un problème.
- Quitter — arrête tout (et désactive les LaunchAgents jusqu'à ce que vous redémarriez).
Les réglages, expliqués
La fenêtre des réglages a une barre latérale avec deux types de pages :
- Valeurs par défaut — Modèle, Telegram, App, Compétences et fonctions, Registre de compétences, À propos, Mises à jour. Les valeurs que chaque bot hérite.
- Bots — une page par bot. Chaque champ montre ce que ce bot utilise réellement : une valeur remplace le défaut, un champ vide l'hérite (l'explication sous chaque ligne le dit). C'est pour ça qu'il n'y a pas de cases « Utiliser le réglage global » — un champ vide est « utiliser le réglage global ».
Tout se sauvegarde automatiquement pendant que vous tapez ou basculez. Les réglages vivent dans ~/.mlx-serve/config.json.
Valeurs par défaut → Modèle
| Réglage | Rôle |
|---|---|
| URL du serveur | Le point d'accès compatible OpenAI. Les serveurs locaux n'ont pas besoin de clé. |
| Clé API | Vide pour les serveurs locaux (mlx-serve, Ollama, LM Studio). Le bouton œil l'affiche ou la masque. |
| Nom du modèle | Quel modèle sur ce serveur, ex. deepseek-v4-flash-free. |
| Tester | Vérifie la connexion avec les valeurs actuelles — utile avant de sauvegarder quoi que ce soit. |
| Modèles de secours | Essayés dans l'ordre quand le principal échoue ou limite. Chacun a son propre surnom, URL, clé et modèle, plus Tester, réorganiser et supprimer. Ajouter est désactivé tant que la dernière ligne n'est pas complète. |
Valeurs par défaut → Telegram
| Réglage | Rôle |
|---|---|
| ID de chats autorisés | ID d'utilisateurs/groupes séparés par des virgules pouvant parler au bot. Vide = n'importe qui. |
| Heure du briefing quotidien | Quand le bot envoie son briefing quotidien — menus déroulants heure/minute sur 24 h (ex. 08:00). |
| Consigne du briefing | Ce que le briefing doit couvrir — ex. « météo, mes rappels du jour et toutes les alertes de prix ». |
| Max. de jetons de réponse | Plafond de sécurité pour les réponses ; les longues réponses sont scindées en plusieurs messages. |
| Contexte par chat | Combien de messages récents le bot garde par chat comme contexte. |
| Mémoires par utilisateur | Mémoires à long terme rappelées par utilisateur, pour chaque message auquel le bot répond. |
| Taille de la base de mémoire (par utilisateur) | Maximum de mémoires stockées par utilisateur ; au-delà, les plus anciennes sont supprimées. |
| Jetons des rapports de recherche | Budget pour les rapports /research et /insiders. |
| Délai d'API (s) | Secondes avant d'abandonner un fournisseur lent — les files gratuites peuvent dépasser la minute. |
| Fichier d'âme | La personnalité avec laquelle les bots tournent. Les fichiers .md de ce dossier (soul*.md, *persona*.md) apparaissent dans le menu déroulant Personnalité de chaque bot. |
| Mots déclencheurs du bot | Mots séparés par des virgules qui font répondre le bot dans les groupes (en plus de @mention, réponse ou commande) — ex. « momo, jarvis, hey bot ». |
| Mots déclencheurs de clips vidéo/audio | Mots qui font capturer au bot une vidéo ou un audio joint comme clip — ex. « clip this, save this ». |
Pages par bot
Chaque bot de la barre latérale a sa propre page. Les champs vides héritent des valeurs par défaut ; l'explication sous chaque ligne indique ce qui est hérité.
| Réglage | Rôle |
|---|---|
| Token | Le token @BotFather du bot (bouton œil pour le révéler). Le changer renomme l'entrée du bot dans la barre latérale. |
| Surnom | Utilisé dans le statut, les journaux et la barre latérale — ex. « Trading ». |
| ID de chats autorisés / Mots déclencheurs / Mots de clip | Les remplacements de ce bot pour les valeurs par défaut correspondantes. |
| URL du serveur, clé API, modèle | Le menu déroulant propose les fournisseurs configurés dans Valeurs par défaut → Modèle, plus n'importe quelle valeur personnalisée. Des modèles de secours propres peuvent être ajoutés par bot. |
| Heure du briefing quotidien / Consigne du briefing | Briefing propre au bot, avec un bouton « Utiliser le réglage global » qui efface le remplacement. |
| Mode | Chercheur, Assistant, Programmeur, Chef ou Aucun — vide utilise le mode par défaut. |
| Fichier d'âme | Le remplacement de personnalité de ce bot, choisi parmi les fichiers soul/persona trouvés sur le disque. |
| Compétences | Ouvre la feuille de compétences du bot — désactivez des compétences pour ce bot en plus des valeurs par défaut, ou revenez aux valeurs par défaut. |
Valeurs par défaut → App
| Réglage | Rôle |
|---|---|
| Afficher dans le Dock | Si l'app de la barre de menus apparaît aussi dans le Dock. |
| Lancer à la connexion | Démarrer Telebot AI à la connexion. |
| Dossier de données | Où vivent la configuration, la mémoire, les rappels et les journaux (par défaut ~/.mlx-serve). |
| Ouvrir le journal / Ouvrir le dossier de données | Accédez directement au fichier de journal ou au dossier de données dans le Finder. |
| Exporter la configuration | Sauvegarde la configuration complète (clés API comprises) dans un fichier — pour les sauvegardes ou le changement de Mac. |
| Importer la configuration | Charge un fichier de configuration et l'applique immédiatement. |
Compétences et fonctions
Les capacités du bot sont des compétences pilotées par le modèle — des instructions claires que le modèle suit avec ses outils, pour décrire ce que vous voulez en langage naturel au lieu de mémoriser des commandes. Chaque groupe a un interrupteur maître ; les compétences individuelles peuvent être activées ou désactivées.
| Groupe | Compétences | Essayez de dire |
|---|---|---|
| Recherche | stock-research, stocks-crypto, insider-trading, currency | « recherche TSLA », « prix du BTC », « opérations d'initiés pour AAPL », « combien font 50 USD en CAD ? » |
| Quotidien | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | « /briefing », « résume ce chat », « rappelle-moi à 17h », « habit du jour fait », « revue hebdomadaire », « /pomodoro 25 », « note 25 € de déjeuner » |
| Médias | media, voice, translation, feeds | « analyse cette vidéo », « lis ça à voix haute », « traduis ça en français », « quoi de neuf dans mes flux ? » |
| Outils | memory | « de quoi avons-nous parlé hier ? » |
| Du registre | Les compétences que vous installez depuis le registre | — |
Registre de compétences
L'onglet Registre permet d'installer des compétences prêtes à l'emploi depuis le catalogue public anthropics/skills — traitement de PDF et de documents, feuilles de calcul, présentations, tests d'apps web, construction de serveurs MCP, art et plus. Chargez le catalogue, choisissez une compétence, et elle apparaît dans l'onglet Compétences et fonctions comme n'importe quelle autre.
Mises à jour
L'onglet Mises à jour compare le manifeste du site avec votre version installée et affiche la dernière version avec un lien de téléchargement. Les vérifications sont silencieuses — hors ligne ou injoignable signifie simplement « à jour ». Pour mettre à jour : téléchargez le nouveau .dmg et glissez-le sur l'ancienne app dans Applications. Réglages, bots et souvenirs vivent hors de l'app, donc ils sont conservés tels quels.
Données et confidentialité
- Où vivent les choses : configuration, mémoire de chat, rappels, compétences et journaux restent tous dans votre dossier de données (par défaut ~/.mlx-serve).
- Ce qui quitte votre Mac : l'API Telegram elle-même, le serveur de modèles vers lequel vous pointez le bot, et des statistiques d'utilisation anonymes (lancements d'app et actions de menu). Aucun contenu de chat, aucun token, aucune donnée personnelle.
Dépannage
- « Apple ne peut pas vérifier si l'app contient des logiciels malveillants » — normal : clic droit (Control-clic) sur l'app dans Applications → Ouvrir → Ouvrir à nouveau. Une fois, et elle fonctionne normalement ensuite.
- Le bot ne répond pas. Ouvrez Réglages → la page du bot : le token est-il bon ? Puis Valeurs par défaut → Modèle → Tester le fournisseur. Ensuite, consultez le journal (barre de menus → Journaux, ou onglet App → Ouvrir le journal).
- Réponses lentes ou bot silencieux. Les fournisseurs gratuits peuvent dépasser la minute — augmentez le délai d'API et ajoutez des modèles de secours pour que le bot bascule quand le principal limite.
- Le serveur local ne répond pas. Assurez-vous que le serveur tourne vraiment (mlx-serve, Ollama…) avant de tester dans l'onglet Modèle.
- « À jour » affiché bizarrement. La vérification est volontairement silencieuse — si le manifeste est injoignable, elle signale à jour.
- Autre chose ? Envoyer un commentaire — chaque message arrive dans le Telegram du développeur et reçoit une vraie réponse.
Télécharger Telebot AI · Ça vous plaît ? Offre-moi un café ☕