📚 दस्तावेज़
हर सुविधा, हर सेटिंग।
ऐप जो कुछ भी करता है और उसकी हर सेटिंग — आपके चल रहे संस्करण के लिए लिखा गया। मेनू बार से लेकर स्किल रजिस्ट्री तक, यह पूरा मैनुअल है।
इस पेज पर
त्वरित शुरुआत मेनू बार ऐप सेटिंग्स, समझाई गईं मॉडल टैब टेलीग्राम टैब प्रति-बॉट पेज ऐप टैब स्किल और सुविधाएँ स्किल रजिस्ट्री अपडेट डेटा और गोपनीयता समस्या निवारणत्वरित शुरुआत
- इंस्टॉल करें। .dmg डाउनलोड करें, Telebot AI को Applications में खींचें। बिल्ड अभी नोटराइज़्ड नहीं है, इसलिए अगर macOS चेतावनी दिखाए, तो ऐप पर राइट-क्लिक (Control-क्लिक) करें और खोलें चुनें — एक बार।
- बॉट बनाएँ। Telegram पर @BotFather को संदेश भेजें, /newbot चलाएँ, और टोकन कॉपी करें। एक बॉट के लिए एक टोकन — आप कई चला सकते हैं।
- टोकन जोड़ें। मेनू बार से Telebot AI खोलें, सेटिंग्स खोलें, और टोकन को बॉट के टोकन फ़ील्ड में पेस्ट करें। टाइप करते ही यह सहेज जाता है — कोई सहेजें बटन नहीं है।
- दिमाग़ जोड़ें। मॉडल टैब में सर्वर URL (http://localhost:11234 mlx-serve के लिए, http://localhost:11434 Ollama के लिए) और मॉडल नाम सेट करें, या कोई भी OpenAI-संगत क्लाउड API उपयोग करें। कनेक्शन जाँचने के लिए परीक्षण दबाएँ।
- बॉट शुरू करें। मेनू बार में लौटें और बॉट शुरू करें चुनें। अपने बॉट को Telegram पर संदेश भेजें — वह उसी क्षण से जवाब देता है।
लोकल मॉडल में नए हैं? गाइड पढ़ें — इसमें mlx-serve, Ollama और LM Studio शामिल हैं, और हर मॉडल को कितनी RAM चाहिए।
मेनू बार ऐप
Telebot AI आपके मेनू बार में रहता है (⌘ आइकन)। मेनू आपको देता है:
- शुरू करें / रोकें / पुनः शुरू करें — हर बॉट के लिए और एक साथ सभी के लिए। बॉट LaunchAgent के रूप में चलते हैं: हमेशा चालू, रास्ते से बाहर।
- सेटिंग्स खोलें — सेटिंग्स विंडो।
- लॉग — बॉट का लॉग देखें कि वह क्या कर रहा है या किसी समस्या का पता लगाएँ।
- बाहर निकलें — सब कुछ रोकता है (और जब तक आप फिर शुरू नहीं करते, LaunchAgent को अक्षम कर देता है)।
सेटिंग्स, समझाई गईं
सेटिंग्स विंडो में दो तरह के पेजों वाला साइडबार है:
- डिफ़ॉल्ट — मॉडल, टेलीग्राम, ऐप, स्किल और सुविधाएँ, स्किल रजिस्ट्री, परिचय, अपडेट। वे मान जो हर बॉट इनहेरिट करता है।
- बॉट्स — हर बॉट के लिए एक पेज। हर फ़ील्ड दिखाता है कि यह बॉट वास्तव में क्या उपयोग करता है: कोई मान डिफ़ॉल्ट को ओवरराइड करता है, खाली फ़ील्ड उसे इनहेरिट करता है (हर पंक्ति के नीचे का व्याख्याकार यही बताता है)। इसीलिए कोई "वैश्विक उपयोग करें" चेकबॉक्स नहीं है — एक खाली फ़ील्ड ही "वैश्विक उपयोग करें" है।
सब कुछ टाइप या टॉगल करते ही अपने आप सेव हो जाता है। सेटिंग्स ~/.mlx-serve/config.json में रहती हैं।
डिफ़ॉल्ट → मॉडल
| सेटिंग | यह क्या करती है |
|---|---|
| सर्वर URL | OpenAI-संगत एंडपॉइंट। लोकल सर्वर को कुंजी की ज़रूरत नहीं। |
| API कुंजी | लोकल सर्वर (mlx-serve, Ollama, LM Studio) के लिए खाली रखें। आँख वाला बटन इसे दिखाता या छिपाता है। |
| मॉडल नाम | उस सर्वर पर कौन सा मॉडल, जैसे deepseek-v4-flash-free। |
| परीक्षण | मौजूदा मानों के साथ कनेक्शन जाँचता है — कुछ सहेजने से पहले उपयोगी। |
| बैकअप मॉडल | प्राथमिक विफल या थ्रॉटल होने पर क्रम से आज़माए जाते हैं। हर एक का अपना उपनाम, URL, कुंजी और मॉडल होता है, साथ में परीक्षण, पुनः क्रम और हटाना। जब तक अंतिम पंक्ति पूरी न हो, जोड़ें अक्षम रहता है। |
डिफ़ॉल्ट → टेलीग्राम
| सेटिंग | यह क्या करती है |
|---|---|
| अनुमत चैट 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 | "research TSLA", "price of BTC", "insider trades for AAPL", "how much is 50 USD in CAD?" |
| दैनिक | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "digest this chat", "remind me at 5pm", "mark today's habit done", "weekly review", "/pomodoro 25", "track 25 lunch" |
| मीडिया | media, voice, translation, feeds | "analyze this video", "read this aloud", "translate this to Chinese", "what's new in my feeds?" |
| उपकरण | memory | "what did we talk about yesterday?" |
| रजिस्ट्री से | वे स्किल जो आप रजिस्ट्री से इंस्टॉल करते हैं | — |
स्किल रजिस्ट्री
रजिस्ट्री टैब आपको सार्वजनिक anthropics/skills कैटलॉग से तैयार स्किल इंस्टॉल करने देता है — PDF और दस्तावेज़ हैंडलिंग, स्प्रेडशीट, प्रेज़ेंटेशन, वेब-ऐप टेस्टिंग, MCP सर्वर बिल्डिंग, कला और बहुत कुछ। कैटलॉग लोड करें, एक स्किल चुनें, और वह किसी भी अन्य की तरह स्किल और सुविधाएँ टैब में दिखने लगती है।
अपडेट
अपडेट टैब लैंडिंग साइट के मेनिफ़ेस्ट को आपके इंस्टॉल्ड संस्करण से जाँचता है और डाउनलोड लिंक के साथ नवीनतम रिलीज़ दिखाता है। जाँचें चुपचाप होती हैं — ऑफ़लाइन या अप्राप्य होने का मतलब बस "अप टू डेट" है। अपडेट करने के लिए: नया .dmg डाउनलोड करें और उसे Applications में पुराने ऐप के ऊपर खींचें। सेटिंग्स, बॉट्स और यादें ऐप के बाहर रहती हैं, इसलिए वे बिना किसी बदलाव के साथ चली आती हैं।
डेटा और गोपनीयता
- चीज़ें कहाँ रहती हैं: कॉन्फ़िग, चैट मेमोरी, रिमाइंडर, स्किल और लॉग सभी आपकी डेटा निर्देशिका में रहते हैं (डिफ़ॉल्ट ~/.mlx-serve)।
- आपके Mac से क्या बाहर जाता है: Telegram API ही, वह मॉडल सर्वर जिससे आप बॉट को जोड़ते हैं, और अनाम उपयोग आँकड़े (ऐप लॉन्च और मेनू क्रियाएँ)। न कोई चैट सामग्री, न टोकन, न व्यक्तिगत डेटा।
समस्या निवारण
- "Apple इसकी जाँच नहीं कर सकता कि इसमें मैलिशस सॉफ़्टवेयर है या नहीं" — यह सामान्य है: Applications में ऐप पर राइट-क्लिक (Control-क्लिक) करें → खोलें → खोलें फिर से। एक बार, फिर यह सामान्य रूप से चलता है।
- बॉट जवाब नहीं देता। सेटिंग्स खोलें → बॉट का पेज: क्या टोकन सही है? फिर डिफ़ॉल्ट → मॉडल → प्रदाता का परीक्षण करें। फिर लॉग जाँचें (मेनू बार → लॉग, या ऐप टैब → लॉग खोलें)।
- उत्तर धीमे हैं या बॉट चुप हो जाता है। फ्री-टियर प्रदाता एक मिनट+ तक रुक सकते हैं — API टाइमआउट बढ़ाएँ, और बैकअप मॉडल जोड़ें ताकि प्राथमिक थ्रॉटल होने पर बॉट उस पर चला जाए।
- लोकल सर्वर जवाब नहीं दे रहा। मॉडल टैब में परीक्षण करने से पहले सुनिश्चित करें कि सर्वर वास्तव में चल रहा है (mlx-serve, Ollama…)।
- अपडेट अजीब तरह से "अप टू डेट" कहते हैं। जाँच डिज़ाइन से चुपचाप होती है — अगर मेनिफ़ेस्ट अप्राप्य है, तो यह अप टू डेट बताता है।
- कुछ और? फ़ीडबैक भेजें — हर संदेश डेवलपर के Telegram पर पहुँचता है और उसे असली जवाब मिलता है।
Telebot AI डाउनलोड करें · पसंद आया? मुझे कॉफ़ी पिलाएँ ☕