Личный ассистент в Telegram на Claude

Пишешь боту в Telegram → Claude раз в 15 минут разбирает входящие, отвечает и запоминает.

Ставится из браузера за 30 минут. Терминал, Node и Git не нужны.

Deploy with Vercel

Как это работает

  Telegram  ──POST──▶  /api/telegram   ──▶  Supabase.inbox  (status = new)
                                                   │
                                        каждые 15 мин, по расписанию
                                                   ▼
                                          Claude (Cowork)
                                                   │  через MCP-коннектор
                                                   ▼
                                      /api/mcp/<секрет>  ──▶  Supabase.items
                                                   │              (память)
                                                   ▼
                                        sendMessage ──▶ Telegram

Сервер не думает. Он только принимает сообщения, хранит их и умеет писать в Telegram. Всё мышление — на стороне Claude, по расписанию. Поэтому нет ни одного платного API-ключа модели.

Что нужно

Сервис	План	Зачем
Telegram	бесплатно	сам бот
Supabase	Free	база: входящие + память
GitHub	Free	копия этого репозитория
Vercel	Hobby	хостинг вебхука и MCP
Claude Pro или Max	платно	Cowork + расписание + коннекторы

Установка

1. Бот в Telegram

Открой @BotFather → /newbot → имя → username (обязан кончаться на bot). Скопируй токен вида 8123456789:AAH... — это TELEGRAM_BOT_TOKEN.

2. База в Supabase

supabase.com → New project (регион — Southeast Asia · Singapore) → придумай пароль, запиши его. Пока проект поднимается (~2 мин), возьми ключи в Project Settings → API Keys:

Project URL → это SUPABASE_URL
Secret key sb_secret_… (нажми Reveal; если ключей нет — Create new API keys) → это SUPABASE_SECRET_KEY

В старых проектах вместо него legacy-ключ service_role — тоже подойдёт, но Supabase выводит его из оборота до конца 2026.

Затем SQL Editor → New query → вставь целиком файл schema.sql → Run.

Secret key обходит все ограничения доступа (RLS). Он живёт только в переменных Vercel. В браузер, в чат и в скриншоты — никогда.

3. Деплой на Vercel

Нажми кнопку Deploy выше. Vercel попросит:

подключить GitHub (Create Git Repository) — репозиторий скопируется тебе;
заполнить 4 переменные (см. таблицу ниже).

Через ~40 секунд получишь адрес вида https://my-assistant-xxxx.vercel.app.

4. Самонастройка

Открой в браузере:

https://ТВОЙ-АДРЕС.vercel.app/api/setup?secret=ТВОЙ_APP_SECRET

Страница сама проверит ключи, проверит базу, зарегистрирует webhook в Telegram и выдаст готовый MCP-адрес для Claude.

5. Коннектор в Claude

Claude → Settings → Connectors → Add custom connector. Имя: assistant. URL: тот, что выдала страница настройки.

Проверь в чате: «покажи мои новые сообщения» — Claude должен дёрнуть get_new_messages.

6. Расписание

В Cowork напиши /schedule и вставь промт из PROMPTS.md. Раз в 15 минут — */15 * * * *.

Переменные окружения

Переменная	Откуда
`TELEGRAM_BOT_TOKEN`	@BotFather, шаг 1
`APP_SECRET`	придумай сам: 20+ случайных символов, латиница и цифры
`SUPABASE_URL`	Supabase → Project Settings → API Keys → Project URL
`SUPABASE_SECRET_KEY`	там же → Secret key (`sb_secret_…`) → Reveal

APP_SECRET служит двум целям сразу: им подписан webhook Telegram и им закрыт MCP-эндпоинт. Кто знает секрет — управляет ботом. Меняется в Vercel → Settings → Environment Variables → Redeploy, после чего надо заново открыть /api/setup и обновить URL коннектора.

Что умеет ассистент

Инструменты, которые видит Claude:

Инструмент	Что делает
`get_new_messages`	забрать необработанные сообщения
`mark_message_done`	закрыть сообщение (иначе обработает повторно)
`send_telegram`	написать в Telegram
`save_item`	сохранить task / reminder / idea / note
`list_items`	найти в памяти по типу, статусу, подстроке
`complete_item`	закрыть задачу

Если что-то не работает

Симптом	Причина
`/api/setup` — красное про Supabase	не прогнал `schema.sql`, либо неверный URL/ключ
`/api/setup` — красное про Telegram	опечатка в токене бота
Бот молчит на сообщение	не открыл `/api/setup`, webhook не зарегистрирован
Claude не видит инструменты	опечатка в MCP-URL; секрет в адресе должен совпадать с `APP_SECRET`
Claude отвечает дважды	пропущен `mark_message_done` — поправь промт расписания
Всё умерло через неделю	Supabase Free ставит проект на паузу после 7 дней тишины. Разбуди в дашборде

Диагностический промт — в PROMPTS.md, раздел «Спасатель».

Куда расти

Голос. Ловить msg.voice в webhook, гнать file_id в распознавание, класть текст в тот же inbox.
Проактивность. Отдельное расписание в 8:00: list_items(kind=reminder, status=open) → сводка дня.
Кто угодно не напишет. Проверять msg.from.id против своего Telegram ID в api/telegram.ts.
Векторный поиск. pgvector в Supabase поверх items — семантический поиск вместо ilike.

Лицензия

MIT. Форкай, ломай, переделывай под себя.