Mila Companion в Telegram: чаты, группы, кнопки, голос

Чаты

Одна Мила — все виды чатов

В каждом месте она ведёт себя по-своему, и как именно — решаете вы. У каждой карточки — ссылка на файл, который это делает.

01 · ЛИЧКА

Ваш личный чат

Ваш вопрос — первым, раньше новых входящих. Фото, видео и репосты она открывает и пишет, что внутри. «Отправить?» — только под готовым черновиком. Под выбором две-три кнопки, под отчётом — ни одной.

skills/lichka-hozyaina

02 · ГРУППЫ

Группы в трёх режимах

Добавьте бота и напишите в группе /channel_join. Вам в личку придёт карточка: 💬 всем, 🏷 по упоминанию, 👁 наблюдатель (в группе молчит, раз в день выжимка вам в личку) или отказ. Пока вы не нажали, она молчит. /mila_leave отключает чат.

skills/mila-v-chate mila-telegram · README

03 · ТОПИКИ

Темы форума

Отвечает в ту тему, откуда пришло сообщение. Для долгой задачи сама открывает тему, держит её короткую карточку (о чём, с кем, чей ход) и закрывает в архив, когда дело сделано.

skills/topiki

04 · ПУБЛИЧНЫЙ БОТ

Сообщения и рассылки

Одному человеку или рассылка от вашего публичного бота — только по вашему слову в личке. Карточка «Рассылка: N человек» с полным текстом, и ничего не уходит, пока вы не нажмёте ✅. Пишем только тем, кто сам писал боту; тихие часы 22:00–08:00; стоп-лист. Токен бота хранится на сервере, у Милы его нет.

Работает у Мил, которые размещает MILAGPT: служба отправки живёт на сервере.

skills/bot-send

Решения

Каждое решение — одно нажатие

Одна карточка — одно решение. Вопрос, два-три варианта с тем, что будет после каждого, её рекомендация со ★ и срок, если он есть. Нажатие возвращается к ней как «[кнопка] …». skills/kartochki
Текст уходит только после нажатия на этот текст. От вашего имени ничего не уходит само, а вчерашнее нажатие сегодняшний текст не покрывает. Это закон 3 её конституции. CONSTITUTION.md
Не нажали — значит, нет. Рутина идёт по правилам и пишется в журнал, остальное ждёт на карточке со сроком. Срок вышел без ответа — она этого не делает и прямо об этом говорит. install/permission_policy.ts
Карточка срабатывает один раз. После первого нажатия кнопки выбора гаснут, и одно решение нельзя принять дважды. mila-telegram · README

Оформление

Чистые сообщения, без сырых звёздочек

У Telegram свой MarkdownV2, а не обычный markdown. Сообщение с **жирным**, отправленное простым текстом, придёт со звёздочками. У Милы от этого три замка.

Что увидел бы клиент

Ваш заказ **готов**. Цена - 120 000 сум.

Что отправляет Мила

Ваш заказ готов. Цена — 120 000 сум.

tg.py экранирует сам

Она пишет обычную разметку, а скрипт переводит её в правильный MarkdownV2 и экранирует спецсимволы, включая точку и дефис.

skills/milagpt-chat/tg.py

Сторож не пропускает сырую разметку

Жирный, списки, код или ссылки без format=markdownv2 не уходят. Сначала она пересобирает сообщение.

Сейчас — у Мил, которые размещает MILAGPT; в установщик для своего сервера его добавляют.

send-guard.py

Копируется одним тапом

Текст для пересылки приходит моноширинным блоком: один тап на телефоне копирует его целиком.

skills/copyblock

Голос, файлы, реакции

Говорите с ней, как с человеком

Голосовое по дороге на встречу, фото чека, реакция 🔥 — она понимает всё это.

Что приходит в чат

Голосовые. Плагин отдаёт их команде расшифровки, которую выбираете вы; скрипт из набора берёт Groq whisper-large-v3 с вашим ключом и для узбекского делает второй проход. mila-telegram · README transcribe-voice.sh
Файлы и фото приходят вместе с сообщением, и она открывает их до ответа. lichka-hozyaina
Файлы обратно: отчёт, PDF, картинка — вложением. install/mila
Реакции и цитаты: она видит, на какое её сообщение вы отреагировали в личке и на что именно отвечаете. receiver.ts reply quotes
«Ты кто?» Любой может написать /whoami: бот ответит, что он ИИ, к чему подключён и кто за него отвечает. mila-telegram · README
Каждый ответ доходит до Telegram. Стоп-хук не даёт ей закончить ход без ответа вам. Сейчас — у размещённых Мил. reply-required.py

Ничего не теряется

Перезапуск, обновление, сбой: сообщения ждут

Приёмник работает демоном рядом с сессией и пишет каждое входящее в журнал. Сессия вернулась — дочитывает журнал с того места, где остановилась. mila status показывает звенья; если бот замолчал, mila doctor проходит токен, режим приватности у BotFather, список доступа, демон и права файлов и говорит, что починить.

docs/REFERENCE.md · mila-telegram · README · install/doctor.py

$ mila status
receiver   running (pid 32455)
sender     running
bridge     cursor 268968 / 268968
journal    268968 bytes, 1633 events
outbox     empty

Честно

Чего эта страница не обещает

Только Telegram. Коннекторов WhatsApp, Slack или Discord в репозитории нет. Посты в соцсети идут через сторонний сервис (Zernio) с вашим ключом.
Два сторожа — сначала у размещённых Мил. Фильтр отправки и хук ответа лежат в репозитории, но установщик для своего сервера пока их не включает; это добавляют. install/install.sh
Одна сессия на все чаты Милы. Стена между клиентами стоит на выходе: каждое сообщение проверяется на имена и названия чатов из другого разговора. send-guard.py
Сообщения — недоверенный ввод. Любой в допущенном чате может попробовать дать ей указание. Поэтому в группах по умолчанию нужно упоминание, а команды от всех, кроме хозяина, — данные, а не поручение. mila-telegram · README skills/mila-v-chate

В репозитории

Каждую строку можно прочитать

Файлы интеграции с Telegram в репозиториях mila-companion и mila-telegram
Файл	Что делает
skills/lichka-hozyaina	как она пишет вам в личку
skills/mila-v-chate	поведение в группах, три режима
skills/topiki	темы форума: открыть, вести, в архив
skills/kartochki	карточки решений с кнопками
skills/bot-send	сообщения и рассылки от вашего публичного бота
skills/milagpt-chat	правила MarkdownV2 и `tg.py`
send-guard.py	проверяет каждое исходящее
install/transcribe-voice.sh	голосовые в текст
install/reply-required.py	ход не кончается без ответа
skills/mila-session	команда `mila`: запуск, продолжение, здоровье канала
docs/team-hearing.md	как Милы слышат друг друга в группе
mila-telegram · receiver.ts	плагин: демон, журнал, подключение групп, реакции

Открытый код · Apache-2.0

Форкните, научите, пришлите PR

Оба репозитория открыты: набор с умениями, хуками, инструментами и шаблонами и Telegram-плагин. Каждый pull request читает человек и Мила Качество.

Звезда на GitHub mila-telegram на GitHub ← Mila Companion Своя Мила

Факты на странице: github.com/shakhruz/mila-companion (main, v1.3.0) и github.com/shakhruz/mila-telegram (main), проверено 18.10.2026. «Mila», «MILAGPT» и логотип — товарные знаки MILAGPT.

Милы

Для бизнеса

Умения

Блог

О нас

Мила работает в вашем Telegram, где ваше дело уже разговаривает