📚 Belgeler
Her özellik, her ayar.
Uygulamanın yaptığı her şey ve sahip olduğu her ayar — çalıştırdığınız sürüm için yazıldı. Menü çubuğundan beceri kayıt defterine kadar, kullanım kılavuzunun tamamı burada.
Bu sayfada
Hızlı başlangıç Menü çubuğu uygulaması Ayarlar, açıklamalı Model sekmesi Telegram sekmesi Bot başına sayfalar Uygulama sekmesi Beceriler & Özellikler Beceri Kayıt Defteri Güncellemeler Veri & gizlilik Sorun gidermeHızlı başlangıç
- Kurulum. .dmg'i indirin, Telebot AI'yı Uygulamalar klasörüne sürükleyin. Derleme henüz noter tasdikli değil; macOS bir uyarı gösterirse uygulamaya sağ tıklayın (Control-tıklama) ve Aç'ı seçin — bir kez.
- Bir bot oluşturun. Telegram'da @BotFather'a yazın, /newbot komutunu çalıştırın ve tokeni kopyalayın. Her bot için bir token — birkaç tane çalıştırabilirsiniz.
- Tokeni ekleyin. Telebot AI'yı menü çubuğundan açın, Ayarlar'ı açın ve tokeni bir botun Token alanına yapıştırın. Yazdığınız anda kaydedilir — Kaydet düğmesi yok.
- Bir beyin bağlayın. Model sekmesinde sunucu URL'sini (mlx-serve için http://localhost:11234, Ollama için http://localhost:11434) ve model adını ayarlayın ya da OpenAI uyumlu herhangi bir bulut API'si kullanın. Bağlantıyı kontrol etmek için Test'e basın.
- Botu başlatın. Menü çubuğuna dönün ve Botu başlat'ı seçin. Telegram'da botunuza mesaj yazın — o andan itibaren yanıt verir.
Yerel modellerde yeni misiniz? Rehberi okuyun — mlx-serve, Ollama ve LM Studio'yu ve her modelin ne kadar RAM istediğini anlatıyor.
Menü çubuğu uygulaması
Telebot AI menü çubuğunuzda yaşar (⌘ simgesi). Menü size şunları sunar:
- Başlat / Durdur / Yeniden Başlat — bot başına ve hepsi birden. Botlar LaunchAgent olarak çalışır: hep açık, yolunuzdan çekilmiş.
- Ayarları Aç — ayarlar penceresi.
- Günlükler — botun günlüğünü izleyin: ne yaptığını görün ya da bir sorunu ayıklayın.
- Çıkış — her şeyi durdurur (ve tekrar başlatana kadar LaunchAgent'ları devre dışı bırakır).
Ayarlar, açıklamalı
Ayarlar penceresinin kenar çubuğunda iki tür sayfa vardır:
- Varsayılanlar — Model, Telegram, Uygulama, Beceriler & Özellikler, Beceri Kayıt Defteri, Hakkında, Güncellemeler. Her botun miras aldığı değerler.
- Botlar — her bot için bir sayfa. Her alan, bu botun gerçekte ne kullandığını gösterir: bir değer varsayılanı geçersiz kılar, boş bir alan onu miras alır (her satırın altındaki açıklama bunu söyler). "Geneli kullan" onay kutularının olmamasının nedeni bu — boş bir alan zaten "geneli kullan" demektir.
Yazdıkça ya da açtıkça her şey otomatik kaydedilir. Ayarlar ~/.mlx-serve/config.json içinde yaşar.
Varsayılanlar → Model
| Ayar | Ne işe yarar |
|---|---|
| Sunucu URL'si | OpenAI uyumlu uç nokta. Yerel sunucular anahtar gerektirmez. |
| API anahtarı | Yerel sunucular (mlx-serve, Ollama, LM Studio) için boş bırakın. Göz düğmesi gösterir ya da gizler. |
| Model adı | O sunucudaki model, örn. deepseek-v4-flash-free. |
| Test | Geçerli değerlerle bağlantıyı kontrol eder — bir şey kaydetmeden önce işe yarar. |
| Yedek modeller | Birincil başarısız olursa ya da kısıtlarsa sırayla denenir. Her birinin kendi takma adı, URL'si, anahtarı ve modeli vardır; ayrıca Test, yeniden sıralama ve kaldırma. Son satır tamamlanana kadar Ekle devre dışıdır. |
Varsayılanlar → Telegram
| Ayar | Ne işe yarar |
|---|---|
| İzin verilen sohbet ID'leri | Botla konuşabilen, virgülle ayrılmış kullanıcı/grup ID'leri. Boş = herkes. |
| Günlük özet saati | Botun günlük özetini gönderdiği saat — 24 saatlik saat/dakika açılır menüleri (örn. 08:00). |
| Özet komutu | Özetin neyi kapsayacağı — örn. "hava durumu, bugünkü hatırlatıcılarım ve fiyat uyarıları". |
| Maks. yanıt tokeni | Yanıtlar için güvenlik tavanı; uzun yanıtlar birden çok mesaja bölünür. |
| Sohbet başına bağlam | Botun bağlam olarak sohbet başına tuttuğu son mesaj sayısı. |
| Kullanıcı başına bellek | Botun yanıtladığı her mesaj için kullanıcı başına hatırlanan uzun vadeli bellekler. |
| Bellek veritabanı boyutu (kullanıcı başına) | Kullanıcı başına saklanan maks. bellek; bunun üzerinde en eskiler silinir. |
| Araştırma raporu tokenleri | /research ve /insiders raporları için bütçe. |
| API zaman aşımı (sn) | Yavaş bir sağlayıcıdan vazgeçilmeden önceki saniye — ücretsiz kademe kuyrukları bir dakikadan fazla takılabilir. |
| Soul dosyası | Botların çalıştığı kişilik. Bu klasördeki .md dosyaları (soul*.md, *persona*.md) her botun Soul açılır menüsünde görünür. |
| Bot tetikleyici kelimeleri | Botun gruplarda yanıt vermesini sağlayan, virgülle ayrılmış kelimeler (@bahsetme, yanıt veya komut dışında) — örn. "momo, jarvis, hey bot". |
| Video/ses klip tetikleyici kelimeleri | Botun ekli videoyu/sesi klip olarak almasını sağlayan kelimeler — örn. "bunu kliple, bunu kaydet". |
Bot başına sayfalar
Kenar çubuğundaki her botun kendi sayfası vardır. Boş alanlar varsayılanı miras alır; her satırın altındaki açıklama neyi miras aldığını söyler.
| Ayar | Ne işe yarar |
|---|---|
| Token | Botun @BotFather tokeni (göstermek için göz düğmesi). Değiştirmek botun kenar çubuğundaki girişini yeniden adlandırır. |
| Takma ad | Durumda, günlüklerde ve kenar çubuğunda kullanılır — örn. "Trading". |
| İzin verilen sohbet ID'leri / Tetikleyici kelimeler / Klip kelimeleri | Bu botun ilgili varsayılanları geçersiz kılmaları. |
| Sunucu URL'si, API anahtarı, Model | Açılır menü, Varsayılanlar → Model'de yapılandırılan sağlayıcıları ve herhangi bir özel değeri sunar. Bot başına kendi yedek modelleri eklenebilir. |
| Günlük özet saati / Özet komutu | Geçersiz kılmayı temizleyen bir "Geneli kullan" düğmesiyle bot başına özet. |
| Mod | Araştırmacı, Asistan, Kodlayıcı, Şef ya da Yok — boş, varsayılan modu kullanır. |
| Soul dosyası | Bu botun kişilik geçersiz kılması; diskte bulunan soul/kişilik dosyalarından seçilir. |
| Beceriler | Bot başına beceri sayfasını açar — bu bot için varsayılanların üzerine becerileri devre dışı bırakın ya da varsayılana sıfırlayın. |
Varsayılanlar → Uygulama
| Ayar | Ne işe yarar |
|---|---|
| Dock'ta göster | Menü çubuğu uygulamasının Dock'ta da görünüp görünmeyeceği. |
| Oturum açarken başlat | Oturum açtığınızda Telebot AI'yı başlatın. |
| Veri dizini | Yapılandırma, bellek, hatırlatıcılar ve günlüklerin yaşadığı yer (varsayılan ~/.mlx-serve). |
| Günlüğü aç / Veri klasörünü aç | Finder'da doğrudan günlük dosyasına ya da veri klasörüne atlayın. |
| Ayarları dışa aktar | Yapılandırmanın tamamını (API anahtarları dahil) bir dosyaya kaydedin — yedeklemek ya da Mac değiştirmek için. |
| Ayarları içe aktar | Bir yapılandırma dosyası yükleyin ve hemen uygulayın. |
Beceriler & Özellikler
Botun yetenekleri model yönetimindeki becerilerdir — modelin araçlarıyla izlediği sade talimatlar. Böylece komut ezberlemek yerine ne istediğinizi düz dille anlatabilirsiniz. Her grubun bir ana anahtarı vardır; tek tek beceriler açılıp kapatılabilir.
| Grup | Beceriler | Şunu demeyi deneyin |
|---|---|---|
| Araştırma | stock-research, stocks-crypto, insider-trading, currency | "TSLA araştırması", "BTC fiyatı", "AAPL için içeriden işlemler", "50 USD kaç CAD eder?" |
| Günlük | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "bu sohbeti özetle", "saat 17:00'de hatırlat", "bugünün alışkanlığını tamamla", "haftalık değerlendirme", "/pomodoro 25", "25'lık öğle yemeğini kaydet" |
| Medya | media, voice, translation, feeds | "bu videoyu analiz et", "bunu sesli oku", "bunu Çinceye çevir", "akışlarımda ne var?" |
| Araçlar | memory | "dün ne konuşmuştuk?" |
| Kayıt defterinden | Kayıt defterinden kurduğunuz beceriler | — |
Beceri Kayıt Defteri
Kayıt defteri sekmesi, herkese açık anthropics/skills kataloğundan hazır beceriler kurmanızı sağlar — PDF ve belge işleme, elektronik tablolar, sunumlar, web uygulaması testi, MCP sunucusu geliştirme, sanat ve daha fazlası. Kataloğu yükleyin, bir beceri seçin; diğerleri gibi Beceriler & Özellikler sekmesinde belirir.
Güncellemeler
Güncellemeler sekmesi, site bildirimini kurulu sürümünüze karşı kontrol eder ve indirme bağlantısıyla en son sürümü gösterir. Kontroller sessizdir — çevrimdışı ya da erişilemez olması yalnızca "güncel" anlamına gelir. Güncellemek için: yeni .dmg'i indirin ve Uygulamalar'daki eski uygulamanın üzerine sürükleyin. Ayarlar, botlar ve bellekler uygulamanın dışında yaşar, bu yüzden hiç dokunulmadan aktarılır.
Veri & gizlilik
- Neler nerede yaşar: yapılandırma, sohbet belleği, hatırlatıcılar, beceriler ve günlükler veri dizininizde kalır (varsayılan ~/.mlx-serve).
- Mac'inizden ne çıkar: Telegram API'sinin kendisi, botu yönlendirdiğiniz model sunucusu ve anonim kullanım istatistikleri (uygulama açılışları ve menü eylemleri). Sohbet içeriği yok, token yok, kişisel veri yok.
Sorun giderme
- "Apple, kötü amaçlı yazılım içerip içermediğini kontrol edemiyor" — beklenen bir durum: Uygulamalar'daki uygulamaya sağ tıklayın (Control-tıklama) → Aç → tekrar Aç. Bir kez, sonrasında normal çalışır.
- Bot yanıt vermiyor. Ayarlar'ı açın → botun sayfası: token doğru mu? Sonra Varsayılanlar → Model → sağlayıcıyı Test edin. Sonra günlüğü kontrol edin (menü çubuğu → Günlükler ya da Uygulama sekmesi → Günlüğü aç).
- Yanıtlar yavaş ya da bot sessizleşiyor. Ücretsiz kademe sağlayıcıları bir dakikadan fazla takılabilir — API zaman aşımını yükseltin ve birincil kısıtlandığında botun devreye girmesi için yedek modeller ekleyin.
- Yerel sunucu yanıt vermiyor. Model sekmesinde test etmeden önce sunucunun gerçekten çalıştığından emin olun (mlx-serve, Ollama…).
- Güncellemeler tuhaf şekilde "güncel" diyor. Kontrol tasarım gereği sessizdir — bildirime ulaşılamazsa güncel olarak raporlar.
- Başka bir şey mi var? Geri bildirim gönder — her mesaj geliştiricinin Telegram'ına düşer ve gerçek bir yanıt alır.
Telebot AI'yı İndir · Beğendiniz mi? Bana kahve ısmarla ☕