tg-connect
ПОДКЛЮЧИТЬ Telegram на ЭТОЙ машине — оба стека сразу: Telethon-рельса (роботы, 0 LLM) и MCP (живые сессии). Триггеры «/tg-connect», «/tg-login», «подключи телегу», «подключи телеграм на этой машине», «залогинь телегу», «телега отвалилась», «AuthKeyDuplicated», «перелогинь аккаунт
Install
npx skills add https://github.com/tonydzi/second-brain-starter-kit/tree/master/skills/tg-connect
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tonydzi-second-brain-starter-kit@llmmart
git clone https://github.com/tonydzi/second-brain-starter-kit.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole tonydzi/second-brain-starter-kit collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
OBJECTIVE: сделать этот узел TG-готовым — обе рельсы живы, у каждой своя сессия, вердикт
подтверждён /tg-check. Всё, что можно, делаю сам: логины и авторизации мои по умолчанию
(Антон, 27.06.2026: «ВСЕГДА делай все авторизации максимально автономно»). Антона зову
только там, где физически нет пути.
Закон (нарушать нельзя, остальное — детали)
- Каждая машина логинится САМА, один раз на аккаунт. Один аккаунт держит сколько угодно устройств — это норма Telegram.
- ⛔ НИКОГДА не копировать и не синкать session-строку между машинами. Строка = паспорт
машины, а не общий секрет. Одна строка на два IP → Telegram видит угон ключа →
AuthKeyDuplicated→ гасит ключ → падают ОБЕ машины. - Сессия живёт машинно-локально, вне синка: Windows
%LOCALAPPDATA%\claude-tgbus\session.env, macOS~/Library/Application Support/claude-tgbus/, Linux~/secrets/(chmod 600). - Два стека на узел — оба обязательны: MCP для живых сессий, Telethon-рельса для роботов. Узел с одним стеком не считается подключённым.
Канон: reglament-telegram-login-svoya-sessiya-na-mashinu-master (входная точка) +
reglament-telegram-dva-steka-telethon-i-mcp + reglament-shina-telegram-bez-mcp-i-svoya-sessiya-na-mashinu.
Какая дверь живая (реколл 05.08.2026 — не гадать заново)
Скриптов логина в двух домах 14, живых из них три. Остальное — исторические половинки.
| движок | роль | когда звать |
|---|---|---|
tg_session_init.py |
⭐ ГЛАВНЫЙ: даёт машине свою строку на выбранный аккаунт, сам берёт код и 2FA, пишет в нужный дом, бэкапит .env перед правкой |
всегда, это и есть подключение |
tg_authcheck.py |
истина о МОЕЙ сессии (current=True + свежая date_active), под общим локом |
до и после |
tg_channels_check.py |
матрица обеих рельс на машине, 0 токенов | до и после |
tg_init_step1_request.py + tg_init_step2_signin.py |
ручная двухходовка, когда код приходится вводить с рук | только если главный не смог достать код |
tg_init_step2_mcp.py |
отдельный вход для MCP на Якорье | Linux-узел |
_imports/dialogs/tg_login_*.py (4 шт) |
ИЮНЬСКАЯ ветка под выделенную read-сессию для индекса чатов | не трогать для подключения |
Ход работы
Шаг 0. Диагноз (0 токенов, ничего не меняет).
python "$USERPROFILE\.claude\scripts\tg_authcheck.py"
python "$USERPROFILE\.claude\scripts\tg_channels_check.py"
Читай ДАННЫЕ сессии, а не догадки: ⛔ не судить о телеге по _heartbeat-*.txt, по синканной
.env или по sender_id (все машины ходят под одним аккаунтом — по нему их не различить).
Свежий AuthKeyDuplicated в mcp_errors.log = кто-то поделился строкой, это корень, а не симптом.
Шаг 1. Рельса Telethon (аккаунт REFRESH = @[рабочий аккаунт]). Сперва вхолостую, потом боевым:
python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account REFRESH --dry
python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account REFRESH
Строка ляжет в machine-local session.env. Движок держит общий лок _refresh_[рабочий аккаунт].lock
только для этого аккаунта — не запускать параллельно с роботами шины.
Шаг 2. Аккаунты MCP. Их на хабе четыре, у каждого свой ключ в [путь владельца]
(файл бэкапится перед каждой правкой):
python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account [рабочий аккаунт]
python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account [рабочий аккаунт]
python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account [рабочий аккаунт]_MCP
python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account TONYDZI
⚠️ [рабочий аккаунт]_MCP ≠ REFRESH: это один аккаунт @[рабочий аккаунт], но ДВА разных auth-key — по одному на
рельсу. Так и должно быть; попытка обслужить обе рельсы одной строкой и есть тот самый
AuthKeyDuplicated.
Шаг 3. Подними потребителя. MCP на хабе — не stdio-копия в каждой сессии, а ОДИН
SSE-демон (.claude.json → "telegram": {"type":"sse","url":"http://127.0.0.1:8765/sse"}),
его держит сторож «MCP Daemons Watchdog». После смены строк демон надо перезапустить, иначе
он до конца жизни ходит со старым ключом. Живые инструменты появляются в сессии только после
её перезапуска — это не поломка.
Шаг 4. Вердикт чужим прибором. Свой же скрипт доказательством не считается:
python "$USERPROFILE\.claude\scripts\tg_channels_check.py"
плюс живой вызов mcp__telegram__list_accounts прямо в сессии — скриптом MCP честно не
проверить, это stdio/SSE-сервер харнесса. Полный протокол = скилл /tg-check.
Курица и яйцо (главная граница)
Код входа я забираю САМ из служебного чата 777000 — но через уже живую сессию этого аккаунта. Значит:
- аккаунт жив хоть где-то → делаю всё сам, Антона не трогаю;
- сессия мертва ВЕЗДЕ (первый вход на новой машине, снесли все устройства) → кода взять
неоткуда. Тогда по лестнице: (1) попросить пир по шине забрать код своей живой сессией
([[peer-otp-relay]]); (2) только если и пиров нет — руки Антона, и тогда код передаётся
через
TG_LOGIN_CODE, а не вводится в чат. - 2FA берётся из
secrets\telegram_2fa.envсам, в лог не печатается.
⭐ QR-АКЦЕПТ ДОНОРОМ — когда код НЕ приходит в 777000 (добавлено 21.09.2026)
Ступень лестницы выше, а не замена ей: нужна, когда OTP идёт SMS на телефон, а не в служебный
чат — там 777000 не помогает. Именно на этом месте 14.09 родился ложный вывод «обхода нет, нужны
руки Антона»; он прожил один день.
Условие применимости: аккаунт жив хоть на одном узле флота. Тогда рук Антона не нужно вовсе — донор подтверждает вход так же, как телефон подтверждает QR-код в приложении:
- на безногом узле —
client.qr_login(), берёмqr.token(base64url); токен живёт ~50 сек; - на узле-доноре —
AcceptLoginTokenRequest(raw_token)его живой сессией ЭТОГО аккаунта; SessionPasswordNeededError→client.sign_in(password=...)изtelegram_2fa.env(штатный шаг, не сбой);- строка → в
.envпотребителя, дальше рестарт демона и проверка чужим прибором (см. «Ход работы»).
⚠️ Приёмник кладётся на донора заранее и зовётся прямым ssh: обёртка со scp+ssh не успевает
в окно токена (замер 15.09: доставка 38 с → AuthTokenExpiredError).
✅ Закон №2 тут не нарушается: узел получает СВОЙ auth key, строка донора никуда не едет. Донор
после выдачи остаётся authorized (проверено 15.09, перепроверено 21.09).
Разбор случая: память fleet-shares-tg-access-via-qr и tg-archive-false-green-[рабочий аккаунт] §опровержение.
Границы и грабли
- ⛔ Не копировать строки между машинами — ни «временно», ни «чтобы быстрее». Это не удобство, это авария на обе машины.
- ⛔ Не поднимать второй Telethon-клиент как health-check: два клиента на одной сессии = разлогин. Поэтому диагноз ходит под локом, а не «просто подключиться и посмотреть».
- Синканный
[путь владельца]с*_SESSION— известная утечка, её доводят до per-machine-split. Новые строки туда НЕ писать. - Частые перелогины с прыжками по IP/странам могут вызвать SMS-переверификацию. Логинимся один раз на машину и не дёргаем.
- Секреты не уезжают в волт, в always-loaded и в исходящее: только
secrets\и локальные.env.
Соседи: /tg-check (диагноз обеих рельс) · /telegram-howto (что уметь после подключения) ·
/whatsapp-pair (та же задача для WhatsApp) · /raise-sync (если лежит синк, а не телега).
Like this skill? It is part of second-brain-starter-kit: the second brain we built for ourselves and run every day at Palo Alto AI Research Lab. Install the whole set with npx skills add tonydzi/second-brain-starter-kit. Everything is open source and free, so take what you need.
Flagships worth a look on their own: secondop-panel (a second opinion from a panel of external models), claude-memory-tidy (stop your agent's memory from rotting), telegram-mcp-kit (your own Telegram over MCP in about 15 minutes).
Author: Anton Dziatkovskii, Palo Alto AI Research Lab. Telegram @tonydzi - WhatsApp +1 341 222 9178 - X @Tony_Stef_
Engineers: want to test-drive this setup? Message me. I hand out free starter seeds to engineers who test and report back, and custom skill requests are welcome.
Files (second-brain-starter-kit)
-
SKILL.md 12.6 KB
--- name: tg-connect description: "ПОДКЛЮЧИТЬ Telegram на ЭТОЙ машине — оба стека сразу: Telethon-рельса (роботы, 0 LLM) и MCP (живые сессии). Триггеры «/tg-connect», «/tg-login», «подключи телегу», «подключи телеграм на этой машине», «залогинь телегу», «телега отвалилась», «AuthKeyDuplicated», «перелогинь аккаунт <имя>», «настрой telethon и mcp», «connect telegram», «relogin telegram»" version: 1.0.0 --- OBJECTIVE: сделать этот узел TG-готовым — обе рельсы живы, у каждой своя сессия, вердикт подтверждён `/tg-check`. Всё, что можно, делаю сам: логины и авторизации мои по умолчанию (Антон, 27.06.2026: «ВСЕГДА делай все авторизации максимально автономно»). Антона зову только там, где физически нет пути. ## Закон (нарушать нельзя, остальное — детали) 1. **Каждая машина логинится САМА, один раз на аккаунт.** Один аккаунт держит сколько угодно устройств — это норма Telegram. 2. **⛔ НИКОГДА не копировать и не синкать session-строку между машинами.** Строка = паспорт машины, а не общий секрет. Одна строка на два IP → Telegram видит угон ключа → `AuthKeyDuplicated` → гасит ключ → падают ОБЕ машины. 3. **Сессия живёт машинно-локально, вне синка:** Windows `%LOCALAPPDATA%\claude-tgbus\session.env`, macOS `~/Library/Application Support/claude-tgbus/`, Linux `~/secrets/` (chmod 600). 4. **Два стека на узел — оба обязательны:** MCP для живых сессий, Telethon-рельса для роботов. Узел с одним стеком не считается подключённым. Канон: `reglament-telegram-login-svoya-sessiya-na-mashinu-master` (входная точка) + `reglament-telegram-dva-steka-telethon-i-mcp` + `reglament-shina-telegram-bez-mcp-i-svoya-sessiya-na-mashinu`. ## Какая дверь живая (реколл 05.08.2026 — не гадать заново) Скриптов логина в двух домах **14**, живых из них три. Остальное — исторические половинки. | движок | роль | когда звать | |---|---|---| | **`tg_session_init.py`** | ⭐ ГЛАВНЫЙ: даёт машине свою строку на выбранный аккаунт, сам берёт код и 2FA, пишет в нужный дом, бэкапит `.env` перед правкой | всегда, это и есть подключение | | **`tg_authcheck.py`** | истина о МОЕЙ сессии (`current=True` + свежая `date_active`), под общим локом | до и после | | **`tg_channels_check.py`** | матрица обеих рельс на машине, 0 токенов | до и после | | `tg_init_step1_request.py` + `tg_init_step2_signin.py` | ручная двухходовка, когда код приходится вводить с рук | только если главный не смог достать код | | `tg_init_step2_mcp.py` | отдельный вход для MCP на Якорье | Linux-узел | | `_imports/dialogs/tg_login_*.py` (4 шт) | ИЮНЬСКАЯ ветка под выделенную read-сессию для индекса чатов | не трогать для подключения | ## Ход работы **Шаг 0. Диагноз (0 токенов, ничего не меняет).** ```bash python "$USERPROFILE\.claude\scripts\tg_authcheck.py" python "$USERPROFILE\.claude\scripts\tg_channels_check.py" ``` Читай ДАННЫЕ сессии, а не догадки: ⛔ не судить о телеге по `_heartbeat-*.txt`, по синканной `.env` или по `sender_id` (все машины ходят под одним аккаунтом — по нему их не различить). Свежий `AuthKeyDuplicated` в `mcp_errors.log` = кто-то поделился строкой, это корень, а не симптом. **Шаг 1. Рельса Telethon (аккаунт REFRESH = @[рабочий аккаунт]).** Сперва вхолостую, потом боевым: ```bash python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account REFRESH --dry python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account REFRESH ``` Строка ляжет в machine-local `session.env`. Движок держит общий лок `_refresh_[рабочий аккаунт].lock` только для этого аккаунта — не запускать параллельно с роботами шины. **Шаг 2. Аккаунты MCP.** Их на хабе четыре, у каждого свой ключ в `[путь владельца]` (файл бэкапится перед каждой правкой): ```bash python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account [рабочий аккаунт] python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account [рабочий аккаунт] python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account [рабочий аккаунт]_MCP python "$USERPROFILE\.claude\scripts\tg_session_init.py" --account TONYDZI ``` ⚠️ `[рабочий аккаунт]_MCP` ≠ `REFRESH`: это один аккаунт @[рабочий аккаунт], но ДВА разных auth-key — по одному на рельсу. Так и должно быть; попытка обслужить обе рельсы одной строкой и есть тот самый `AuthKeyDuplicated`. **Шаг 3. Подними потребителя.** MCP на хабе — не stdio-копия в каждой сессии, а ОДИН SSE-демон (`.claude.json` → `"telegram": {"type":"sse","url":"http://127.0.0.1:8765/sse"}`), его держит сторож «MCP Daemons Watchdog». После смены строк демон надо перезапустить, иначе он до конца жизни ходит со старым ключом. Живые инструменты появляются в сессии только после её перезапуска — это не поломка. **Шаг 4. Вердикт чужим прибором.** Свой же скрипт доказательством не считается: ```bash python "$USERPROFILE\.claude\scripts\tg_channels_check.py" ``` плюс живой вызов `mcp__telegram__list_accounts` прямо в сессии — скриптом MCP честно не проверить, это stdio/SSE-сервер харнесса. Полный протокол = скилл `/tg-check`. ## Курица и яйцо (главная граница) Код входа я забираю САМ из служебного чата 777000 — но **через уже живую сессию этого аккаунта**. Значит: - аккаунт жив хоть где-то → делаю всё сам, Антона не трогаю; - сессия мертва ВЕЗДЕ (первый вход на новой машине, снесли все устройства) → кода взять неоткуда. Тогда по лестнице: (1) попросить пир по шине забрать код своей живой сессией ([[peer-otp-relay]]); (2) только если и пиров нет — руки Антона, и тогда код передаётся через `TG_LOGIN_CODE`, а не вводится в чат. - 2FA берётся из `secrets\telegram_2fa.env` сам, в лог не печатается. ### ⭐ QR-АКЦЕПТ ДОНОРОМ — когда код НЕ приходит в 777000 (добавлено 21.09.2026) Ступень лестницы выше, а не замена ей: нужна, когда OTP идёт **SMS на телефон**, а не в служебный чат — там `777000` не помогает. Именно на этом месте 14.09 родился ложный вывод «обхода нет, нужны руки Антона»; он прожил один день. Условие применимости: **аккаунт жив хоть на одном узле флота**. Тогда рук Антона не нужно вовсе — донор подтверждает вход так же, как телефон подтверждает QR-код в приложении: 1. на безногом узле — `client.qr_login()`, берём `qr.token` (base64url); токен живёт **~50 сек**; 2. на узле-доноре — `AcceptLoginTokenRequest(raw_token)` его живой сессией ЭТОГО аккаунта; 3. `SessionPasswordNeededError` → `client.sign_in(password=...)` из `telegram_2fa.env` (штатный шаг, не сбой); 4. строка → в `.env` потребителя, дальше рестарт демона и проверка чужим прибором (см. «Ход работы»). ⚠️ Приёмник кладётся на донора **заранее** и зовётся прямым `ssh`: обёртка со scp+ssh не успевает в окно токена (замер 15.09: доставка 38 с → `AuthTokenExpiredError`). ✅ Закон №2 тут не нарушается: узел получает СВОЙ auth key, строка донора никуда не едет. Донор после выдачи остаётся authorized (проверено 15.09, перепроверено 21.09). Разбор случая: память `fleet-shares-tg-access-via-qr` и `tg-archive-false-green-[рабочий аккаунт]` §опровержение. ## Границы и грабли - ⛔ Не копировать строки между машинами — ни «временно», ни «чтобы быстрее». Это не удобство, это авария на обе машины. - ⛔ Не поднимать второй Telethon-клиент как health-check: два клиента на одной сессии = разлогин. Поэтому диагноз ходит под локом, а не «просто подключиться и посмотреть». - Синканный `[путь владельца]` с `*_SESSION` — **известная утечка**, её доводят до per-machine-split. Новые строки туда НЕ писать. - Частые перелогины с прыжками по IP/странам могут вызвать SMS-переверификацию. Логинимся один раз на машину и не дёргаем. - Секреты не уезжают в волт, в always-loaded и в исходящее: только `secrets\` и локальные `.env`. Соседи: `/tg-check` (диагноз обеих рельс) · `/telegram-howto` (что уметь после подключения) · `/whatsapp-pair` (та же задача для WhatsApp) · `/raise-sync` (если лежит синк, а не телега). <!--kit-footer--> --- **Like this skill?** It is part of [second-brain-starter-kit](https://github.com/tonydzi/second-brain-starter-kit): the second brain we built for ourselves and run every day at Palo Alto AI Research Lab. Install the whole set with `npx skills add tonydzi/second-brain-starter-kit`. Everything is open source and free, so take what you need. Flagships worth a look on their own: [secondop-panel](https://github.com/tonydzi/secondop-panel) (a second opinion from a panel of external models), [claude-memory-tidy](https://github.com/tonydzi/claude-memory-tidy) (stop your agent's memory from rotting), [telegram-mcp-kit](https://github.com/tonydzi/telegram-mcp-kit) (your own Telegram over MCP in about 15 minutes). Author: **Anton Dziatkovskii**, Palo Alto AI Research Lab. Telegram [@tonydzi](https://t.me/tonydzi) - WhatsApp [+1 341 222 9178](https://wa.me/13412229178) - X [@Tony_Stef_](https://x.com/Tony_Stef_) **Engineers: want to test-drive this setup?** Message me. I hand out free starter seeds to engineers who test and report back, and custom skill requests are welcome.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.