Hermes Agent-ті Telegram-ға қалай қосып, тапсырмаларды телефоннан басқаруға болады
MarkdownҚадамдық баптау: BotFather арқылы бот жасап, Hermes Agent ішінде токен мен рұқсаттар тізімін қосып, шлюзді іске қосыңыз. Дауыстық хабарламалар, жоспарланған тапсырмалар және телефоннан басқару.
Мақаланы толық оқу
Компьютерден алыста жүргенде телефоннан Telegram арқылы Hermes Agent-ке хабарлама жіберіп немесе тапсырманы дауыстап айтып, нәтижесін сол чаттан ала аласыз. Жоспарланған тапсырмалардың нәтижесі бір рет негізгі чат ретінде белгілеген чатыңызға келеді.
Егер Hermes әлі орнатылмаса, алдымен бұл агенттің не екенін және оны қалай орнату керегін оқып, содан кейін Telegram-ды қосу үшін оралыңыз.
Қосымша нұсқаулар Ailoot құжаттамасында бар.
Hermes Agent-ті Telegram-ға қосу үшін не қажет?
Негізгі түйін
Сізге моделі қосылған Hermes Agent және Telegram аккаунты қажет. Telegram ішінде бот жасау тегін, ал Hermes — ашық бастапқы коды бар жоба. Модельге, бұлттағы сөйлеуді тануға және ботты тәулік бойы жұмыс істету үшін серверге бөлек ақы алынуы мүмкін.
hermes doctor командасы Hermes орнатылымы мен модель қосылымын тексереді. Ботты Telegram қолданбасында жасаймыз, ал терминалда командаларды орындау үшін компьютер қажет.
BotFather арқылы ботты қалай жасауға болады?
Негізгі түйін
Telegram-да @BotFather-ді ашып, /newbot жіберіңіз, көрсетілетін атау мен bot деп аяқталатын бірегей пайдаланушы атын таңдаңыз. BotFather 123456789:ABCdef... пішіміндегі токен жібереді — бұл ботыңыздың кілті. Оны сақтап, ешкімге көрсетпеңіз.
Әр Telegram ботында токен болады — ол ботты басқаруға арналған құпия кілт. Оны Telegram-дың ресми боты @BotFather береді.
@BotFather-ді ашыңыз
Telegram ішінен
@BotFatherдеп іздеңіз немесе t.me/BotFather сілтемесін ашыңыз. Нағыз BotFather-де көк растау белгісі бар. «Start» түймесін басып, сөйлесуді бастаңыз./newbot командасын жіберіңіз
BotFather екі атау сұрайды. Біріншісі — көрсетілетін атау; ол кез келген атау болуы мүмкін, мысалы, “My Agent.” Екіншісі — пайдаланушы аты: ол бірегей болып,
botдеп аяқталуы керек, мысалы,moy_agent_bot.Токенді алыңыз
BotFather құттықтау хабарламасын және
123456789:ABCdefGHIjklMNOpqrSTUvwxYZпішіміндегі ұзын жолды жібереді. Бұл — бот токені. Жолды толық көшіріп алыңыз.
Назар аударыңыз
Токен ботты толық басқаруға мүмкіндік береді: токенді білген адам оны басқара алады. Токен тарап кетсе, BotFather-мен сөйлесуде /revoke командасын дереу жіберіп, жаңасын алыңыз.
BotFather-мен қолмен сөйлеспей-ақ жасаудың жылдам жолы да бар. Hermes веб-панелінде (hermes dashboard) және жұмыс үстелі қолданбасындағы “Messaging → Telegram” бетінде “Create with QR” түймесі бар: кодты телефонмен сканерлеңіз, сонда Hermes бот жасап, ID-іңізді анықтап, токенді баптауларға сақтап, шлюзді қайта іске қосады. Төменде қолмен жасау жолы берілген; QR таңдасаңыз, қосылымды тексеру бөліміне бірден өтіңіз.
Telegram ID-іңізді қалай табуға болады және ол не үшін керек?
Негізгі түйін
Сандық Telegram ID-іңізді табыңыз. Бұл — аккаунт нөміріңіз; @ белгісі бар пайдаланушы аты рұқсаттар тізіміне жарамайды. Hermes бұл ID-ді рұқсаттар тізімі үшін пайдаланады: тізім болмаса, шлюз сізге қоса ешкімге жауап бермейді.
Telegram аккаунтында екі идентификатор бар: @ белгісі бар ашық пайдаланушы аты және ішкі сандық ID. Hermes санды пайдаланады.
The quick “Create with QR” method described above detects your ID automatically. Write it down next to your token.
Токенді Hermes Agent-ке қалай беріп, шлюзді іске қосуға болады?
Негізгі түйін
hermes gateway setup командасымен баптау шеберін іске қосып, Telegram-ды таңдаңыз: ол токен мен ID-ді сұрап, бәрін сақтайды. Қолмен баптау үшін ~/.hermes/.env файлына екі жол қосылады. Содан кейін hermes gateway командасымен шлюзді іске қосыңыз, бот бірнеше секундта дайын болады.
| Баптау шебері | Қолмен | |
|---|---|---|
| Не іске қосасыз | hermes gateway setup | ~/.hermes/.env файлын ашатын редактор |
| Не енгізесіз | Шебер сұраған кезде токен мен ID | Екі айнымалыны қолмен |
| Қайда сақталады | Шебер оларды баптауларға өзі сақтайды | Баптаулар тікелей .env файлына жазылады |
| Кімге арналған | Барлығына; ұсынылатын әдіс | Конфигурациялармен жұмыс істеуге немесе скриптпен баптауға үйренгендерге |
Баптау шеберін іске қосыңыз
hermes gateway setupКоманданы Hermes орнатылған компьютерде орындаңыз. Шебер хабар алмасу қолданбаларының тізімін ұсынады.
Telegram-ды таңдап, деректеріңізді енгізіңіз
Шебер бот токені мен рұқсат етілген ID-лерді сұрайды (бірнешеуін үтірмен бөліп енгізуге болады) және бәрін баптауларға өзі сақтайды.
Шлюзді іске қосыңыз
hermes gatewayШлюз іске қосылып, Telegram-ға қосылады. Бірнеше секундтан кейін қолданбадан ботыңызға кез келген хабарлама жіберіңіз: Hermes жауап берсе, қосылым дайын.
Шеберді қолданбайтын қолмен баптау былай орындалады: ~/.hermes/.env файлын ашып, BotFather берген токен мен сандық ID-ді қойып, екі жол қосыңыз:
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789
Екінші жол сол адамдарға жеке чаттар мен топтарда рұқсат береді; бөлек топ чаты авторизациясы да қолжетімділік бере алады. Бірнеше адамды үтірмен бөліңіз. Файлды сақтағаннан кейін шлюзді сол hermes gateway командасымен іске қосыңыз.
Бот жеке чатта да үнсіз қалса, сол терминалдағы шлюз журналдарын қарап, алдымен токен мен рұқсаттар тізіміндегі ID-іңіздің дұрыстығын тексеріңіз; басқа қателер мақаланың соңындағы кестеде берілген.
Телефондағы Telegram боты не істей алады?
Негізгі түйін
Telegram боты мәтіндік және дауыстық хабарламаларды оқиды, файлдар мен суреттерді қабылдайды, қауіпті командалар алдында чаттың өзінде рұқсат сұрайды және модель таңдауын түймелер арқылы көрсетеді. Әдепкіде дыбыс тек соңғы жауаптарға, растау сұрауларына және командалардың орындалғанын растауға беріледі.
Телефонда жиі қажет болатын бес мүмкіндік бар.
Мәтіндік және дауыстық хабарламалар. Тапсырманы мәтінмен жазыңыз немесе дауыстық хабарлама түрінде айтыңыз — сөйлеуді тану бапталған болса, Hermes оны мәтінге айналдырып, түсінеді. Жергілікті провайдер қолданылса, кілттер қажет емес; барлығы агент іске қосылған компьютерде өңделеді.
Файлдар мен суреттер. Ботқа құжатты, электрондық кестені немесе скриншотты қайта жібере аласыз — агент оны тіркеме ретінде алады. Ол жасалған файлдарды да қайта жібере алады: есеп сұраңыз, сонда оны чатта файл ретінде жібереді.
Қауіпті әрекеттерді растау. Агент файлдарды жою сияқты қауіпті әрекет жасамақ болғанда, алдымен чатта сұрайды: “yes” немесе “y” деп жауап берсеңіз, орындайды; “no” немесе “n” десеңіз, бас тартады.
Қайта терудің орнына түймелер. Агентке нақтылау қажет болса, ол кірістірілген нұсқа түймелері бар сұрақ жібереді — бір нұсқаны басыңыз, агент жұмысын жалғастырады. Аргументсіз /model командасы дәл осындай түймелері бар модель таңдау мәзірін көрсетеді.
Үнсіз хабарландырулар. Әдепкіде телефон тек соңғы жауаптар, растау сұраулары және командалардың орындалғанын растау үшін дыбыс шығарады. “calling a tool” және “compressing context” сияқты қызметтік хабарландырулар үнсіз келеді, сондықтан телефон әр қадам сайын шырылдамайды. Әр қадамда дыбысты хабарландыру алғыңыз келсе, баптаулардан режимді ауыстырыңыз.
Фондық тапсырмалардың нәтижесін чаттан қалай алуға болады?
Негізгі түйін
Жоспарланған тапсырмалар нәтижені негізгі чатқа жібереді: ботпен сөйлесуді ашып, /sethome командасын жіберіңіз. Тақырыптан басталған фондық тапсырмалар жауабын сол тақырыпқа қайтарады. Негізгі талап — шлюз жұмысын тоқтатпауы керек; әйтпесе компьютер өшірулі кезде бот үнсіз қалады.
Жоспарланған тапсырмаларға арналған негізгі чат. Hermes жоспарланған тапсырмаларды қолдайды: “күн сайын таңғы 7:43-те маған қорытынды дайында.” Нәтиже негізгі чатқа жіберіледі; оны ботпен сөйлесуде /sethome командасын бір рет жіберіп белгілейсіз. Шлюз жұмыс істеп тұрса, қорытындылар автоматты түрде келеді.
Фондық тапсырмалар. Ұзақ тапсырманы фондық режимде орындауға жіберіп, өз ісіңізді жалғастыра аласыз: дайын болғанда бот хабарлама жібереді. Тақырыптан басталған тапсырма жауабын сол тақырыпқа қайтарады, сондықтан ештеңе жоғалмайды.
Маңызды шектеу: бот тек шлюз жұмыс істеп тұрғанда жауап береді. Hermes орнатылған компьютерді өшірсеңіз немесе ұйқы режиміне қойсаңыз, компьютер қайта іске қосылғанша бот жауап бермейді. Ботты үнемі желіде ұстау үшін агентті серверге көшіріңіз: бізде Hermes Agent-ті тәулік бойы қалай іске қосуға болатыны туралы бөлек нұсқаулық бар. Әдепкіде шлюз Telegram-нан жаңа хабарламаларды сұрап тексереді; кіріс трафигі болмаса ұйқыға кететін бұлттық платформалар үшін құжаттамада webhook режимі ұсынылған. Ол қосылым бағытын өзгертіп, Telegram-ның өзі ботқа сұраулар жіберуіне мүмкіндік береді.
Бейтаныс адамдарды боттан қалай шектеуге болады?
Негізгі түйін
TELEGRAM_ALLOWED_USERS тізіміндегі жіберуші ID-лері жеке чаттар мен топтарда рұқсат алады. Топ қолжетімділігі бөлек те беріледі: TELEGRAM_GROUP_ALLOWED_CHATS тізіміндегі әр топтың барлық мүшесін рұқсаттайды. Токенді құпия сақтаңыз; белгілеу сүзгілері кімнің қолы жететінін емес, боттың қашан жауап беретінін басқарады.
Ботты Telegram іздеуінен пайдаланушы аты арқылы табуға болады, сондықтан қорғаныс екі нәрсеге сүйенеді: рұқсаттар тізіміне және токеннің құпия сақталуына.
Алдымен TELEGRAM_ALLOWED_USERS арқылы жіберуші қолжетімділігін баптаңыз. Топтар үшін TELEGRAM_GROUP_ALLOWED_CHATS мәнін де қараңыз: чат осы тізімде болса, жеке allowlist-те ID болмаса да, оның кез келген мүшесіне рұқсат беріледі. Сондықтан жеке тізімнің бос болуы барлық топ жабық екенін өздігінен дәлелдемейді.
Екіншісі — токен. Ол скриншоттарға, қайта жіберілген хабарламаларға немесе репозиторийлерге түсіп қалмауы керек. Токен тарап кетсе, BotFather ішінде /revoke командасымен кері қайтарыңыз. Содан кейін жаңа токенді баптауларға енгізіп, шлюзді қайта іске қосыңыз.
Топтарға қатысты жеке ескерту: жіберуші авторизациясы мен чат авторизациясы бөлек. TELEGRAM_GROUP_ALLOWED_CHATS арқылы рұқсат етілген топ мүшесі ID-і TELEGRAM_ALLOWED_USERS ішінде болмаса да ботты қолдана алады. Қолжетімділік жеке қалуы керек болса, бүкіл топқа рұқсат бермеңіз; орнатылған нұсқаңызда жіберуші шектеулерін баптап, тексеріңіз. Боттың топта тек шақырылғанда жауап беруін қаласаңыз, telegram.require_mention параметрі бар. Бұл жағдайда бот @ арқылы белгілеуге, өз хабарламасына жауапқа, /command@yourbot сияқты командаға және telegram.mention_patterns ішіндегі үлгілерге сай хабарламаларға жауап беріп, топтағы жай хабарламаларды елемейді.
Бот топта неге үнсіз қалады және мұны қалай түзетуге болады?
Негізгі түйін
Себебі — Telegram-ның құпиялылық режимі: әдепкіде топтағы бот тек командалар мен өзінің хабарламаларына берілген жауаптарды көреді. Оны @BotFather арқылы өшіріңіз: /mybots → Bot Settings → Group Privacy → Turn off. Содан кейін ботты топтан шығарып, қайта қосу қажет — Telegram ескі баптауды есте сақтайды. Балама ретінде құпиялылық режимін өшірмей-ақ ботты топ әкімшісі етіңіз.
Жаңа Telegram боттарында құпиялылық режимі әдепкіде қосулы болады; Hermes құжаттамасында бұл топтардағы боттарға қатысты түсінбеушіліктің ең жиі себебі деп сипатталған. Бұл режимде бот тек / командасынан басталатын хабарламаларды, өзінің хабарламаларына берілген жауаптарды және қызметтік хабарландыруларды алады. Қарапайым топ хабарламалары оған жетпейді — Telegram оларды жібермейді және ешбір агент баптауы мұны түзете алмайды.
Түзету жолы:
- @BotFather-ді ашып,
/mybotsжіберіңіз. - Ботыңызды таңдаңыз.
- “Bot Settings” → “Group Privacy” → “Turn off” тармағын ашыңыз.
- Ботты топтан шығарып, қайта қосыңыз.
Төртінші қадамды ұмытып кету оңай, сонда бот “әлі де үнсіз” қалады. Telegram бот топқа қосылған кездегі құпиялылық баптауын есте сақтайды және ботты топтан шығарып, қайта қоспайынша оны жаңартпайды.
Құпиялылықты жалпы өшіргіңіз келмесе, екінші нұсқа бар: ботты топ әкімшісі етіңіз. Әкімші боттар кез келген құпиялылық режимінде барлық хабарламаны алады.
Қосылымдағы жиі қателер және оларды түзету жолдары
Негізгі түйін
Алдымен шлюздің жұмыс істеп тұрғанын, токеннің және рұқсаттар тізіміндегі ID-дің дұрыс екенін тексеріңіз. Топтар үшін құпиялылық режимін, дауысты тану үшін STT провайдерін, ал Edge TTS арқылы дауыстық жауаптар үшін ffmpeg бар-жоғын тексеріңіз.
| Белгісі | Себебі | Не істеу керек |
|---|---|---|
| Бот мүлде жауап бермейді | Токен қате немесе шлюз жұмыс істемей тұр | .env ішіндегі токенді тексеріп, hermes gateway қызметін қайта іске қосыңыз және сол терминалдағы журналдарды қараңыз |
| Бот “unauthorized” деп жауап береді | ID рұқсаттар тізімінде жоқ | ID-іңізді тексеріп, TELEGRAM_ALLOWED_USERS ішіне қосыңыз да, шлюзді қайта іске қосыңыз |
| Жеке чатта жауап береді, топта үнсіз | Құпиялылық режимі | BotFather арқылы “Turn off” таңдаңыз, содан кейін ботты топтан шығарып, қайта қосыңыз немесе оны әкімші етіңіз |
| Дауыстық хабарламалар мәтінге айналмайды | Сөйлеуді тану бапталмаған | Жергілікті тану faster-whisper пакетімен орнатылады; бұлттық нұсқаларға өз кілті қажет |
| Edge TTS арқылы дауыстық жауап кәдімгі дауыстық хабарлама орнына файл болып келеді | ffmpeg жоқ | ffmpeg орнатыңыз — Edge TTS-ке оны Telegram дауыстық хабарлама пішіміне түрлендіру үшін қолдану қажет |
| Токен жұмыс істемей қалды | Токен кері қайтарылған | BotFather арқылы /revoke және /newbot (немесе /token) көмегімен жаңасын алып, .env ішіндегі мәнді ауыстырып, шлюзді қайта іске қосыңыз |
Адамдар Hermes Agent туралы Telegram-да тағы не сұрайды?
Негізгі түйін
Сервер міндетті емес, бірақ бот тек шлюз жұмыс істеп тұрған кезде белсенді болады. Қосу тегін; тек модель үшін төлейсіз. ID тізімі арқылы бірнеше адамды қоса аласыз. Бот жеке чаттарды көре алмайды. 20 MB-тан үлкен файлдар үшін қосымша баптау қажет.
Жиі қойылатын сұрақтар
Боттың жұмыс істеуі үшін сервер керек пе?
Жоқ, бастау үшін Hermes орнатылған компьютер жеткілікті. Бот шлюз жұмыс істеп тұрғанда ғана белсенді екенін есте сақтаңыз. Компьютерді өшірсеңіз немесе ұйқы режиміне қойсаңыз, қайта іске қосылғанша бот үнсіз қалады. Оны тәулік бойы іске қосқыңыз келсе, агентті серверге көшіріңіз — бұл туралы бөлек нұсқаулығымыз бар.
Ботты қосу қанша тұрады?
Қосу тегін. Telegram боттар үшін ақы алмайды, ал Hermes Agent — ашық бастапқы коды бар жоба. Агентке қосылған модельге және оны тәулік бойы жүргізгіңіз келсе, серверге бөлек ақы алынуы мүмкін.
Әйелімді немесе командамды ботқа қоса аламын ба?
Иә. TELEGRAM_ALLOWED_USERS тізіміндегі ID-лер үтірмен бөлінеді, тізімдегі әр адам ботқа жеке хабарлама жібере алады. Ал TELEGRAM_GROUP_ALLOWED_CHATS арқылы чаттың өзіне рұқсат берсеңіз, сол топтың кез келген мүшесі ботты пайдалана алады — құжаттамаға сәйкес рұқсат етілген чаттар тізімі осылай жұмыс істейді.
Бот менің жеке хаттарымды көре ала ма?
Жоқ. Bot API ботқа жеке чаттарда тек өзіне арналған хабарламаларды береді, ал топтарда жоғарыда айтылғандай Telegram-ның құпиялылық режимі қолданылады. Боттың басқа адамдармен жазысқан хаттарыңызға қол жеткізе алмайды.
Бот неге ұзақ дауыстық хабарламаны қабылдамады?
Жалпыға қолжетімді Bot API файлдарды жүктеуге 20 MB шектеу қояды; одан үлкен файл қабылданбайды. Hermes құжаттамасында жергілікті Bot API серверін қолданып, шектеуді 2 GB-қа дейін арттыру тәсілі сипатталған. Бұл тек 20 MB-тан үлкен файлдарды қабылдағыңыз келсе қажет; құжаттамаға сілтеме мақаланың соңындағы “Sources” бөлімінде берілген.
Ботқа жаңа мүмкіндіктер қоса аламын ба?
Иә. Hermes-те агентке арналған дайын мүмкіндіктер — дағдылар мен плагиндер бар. Мұндай AI агент ботына плагин орнату жолы бөлек нұсқаулықта берілген: Telegram-дағы AI агент ботына плагинді қалай орнатуға болады.
Дереккөздер
- Hermes Agent: Telegram баптауы — бастапқы нұсқаулықтың негізгі дереккөзі, авторы 12.09.2026 күні тексерген
- Hermes Agent: хабар алмасу шлюзі
- Hermes Agent: орнату
- Hermes Agent: жылдам бастау
- Hermes Agent: жоспарланған тапсырмалар
- BotFather — Telegram боттарын жасауға арналған ресми бот
Дайын болғанда, Ailoot-пен танысыңыз.
Толығырақ
Жиі қойылатын сұрақтар
Жеке allowlist рұқсат берілген топтағы тізімде жоқ адамдарды бұғаттай ма?
Бүкіл чат TELEGRAM_GROUP_ALLOWED_CHATS арқылы рұқсат етілсе, бұғаттамайды: сол топтың кез келген мүшесі рұқсат алады. TELEGRAM_ALLOWED_USERS жеке жіберушілерді рұқсаттайды; ботты топқа ашпас бұрын екі баптауды да қараңыз.
@ арқылы шақыруды талап ету топты тек таңдаулы адамдарға жеке ете ме?
Жоқ. Белгілеу және үлгі баптаулары қай хабарламаға жауап берілетінін анықтайды. Олар рұқсат етілген чаттың барлық мүшесіне берілген авторизацияны жоймайды.