Быстрый старт#

1. Токен#

@BotFather → ваш бот → Serverless → CLI Access → Access token. Формат app<id>:<secret>. Это не Bot API токен (123456:AA…). Сначала включите Serverless у этого бота.

2. Диалог с агентом#

Вы:    создай бота в ~/bots/echoАгент: create_project → попросит CLI access token → login_bot       → поправит tgcloud/handlers/message.js → push → webhook_sync

Бот жив. Проверка логики без живого чата:

Агент: run_handler { module: 'handlers/message', args: '{ chat: { id: 1 }, text: "hi" }' }

run_handler запускает и endpoints. Init data передаётся в ctx.

3. Что дальше#

• Инструменты — все 16 команд
• Безопасность — guardrails и токены
• Кукбук — бот с базой, кнопками и Mini App

После правок фронтенда агент вызывает deploy (сборка, затем push). Обычный push заливает папку сборки как есть и бандлер не запускает. Изменение схемы: push, затем migrate (предпросмотр), затем migrate с confirm: true. Если в предпросмотре нет удалений, берите apply: "safe".