Установка и обновление агента

Два разных сценария, которые легко перепутать: установка с нуля и обновление уже работающего агента.

Главное различие

• Установка с нуля создаёт нового агента в новой папке. Памяти ещё нет, терять нечего.
• Обновление меняет только код бота. Память не затрагивается: файлы личности (SOUL.md, MEMORY.md, GOALS.md), дневники, knowledge/ и индекс поиска лежат вне папки с кодом бота.

Бонусный архив нельзя распаковывать поверх уже установленного агента: шаблонные файлы затрут память. Для обновления использовать только команду ниже.

Установка с нуля

1. Написать боту команду /new.
2. Бот присылает готовый промпт с персональной ссылкой на архив.
3. Открыть Claude Code на компьютере или на сервере.
4. Вставить промпт целиком и нажать Enter.
5. Агент сам скачает и распакует архив, затем задаст около 10 вопросов для настройки.

Одна ссылка рассчитана на 3 скачивания.

Обновление

В терминале на сервере, где стоит агент (по SSH или через VS Code; для VPS под root), выполнить одну команду:

curl -fsSL <адрес-скрипта-обновления>/update-bot.sh -o /tmp/update-bot.sh && bash /tmp/update-bot.sh

Скрипт скачивает свежий установщик, обновляет код бота, делает резервную копию и перезапускает бота. При сбое он автоматически откатывается к прежней версии. Через 1–2 минуты в меню бота появятся новые команды. Чат с ботом лучше закрыть и открыть заново, чтобы Telegram подгрузил меню.

Какой путь не использовать

Встроенный /update в чате и запуск update-bot.sh с диска у старых версий (2.0.0 и раньше) ломаются. Они запускают устаревший установщик, который не знает о новых модулях, бот падает с ERR_MODULE_NOT_FOUND и откатывается. Рабочий путь один: скачать свежий скрипт во временную папку и запустить его, как показано выше.

Что сохраняется при обновлении

• SOUL.md, MEMORY.md, GOALS.md, USER.md;
• дневники и база знаний;
• диалоги (sessions.json) и настройки;
• токены и ключи.

Единственное удаление происходит во временной папке /tmp.

Что нового в версии 2.1.0

• /connect: VS Code через бота. Бот присылает ссылку авторизации GitHub и код, затем ссылку вида vscode.dev/tunnel/.... SSH-клиент не нужен.
• /reauth: переподключить Claude без обращения в поддержку. См. инструкцию «Переавторизация Claude на сервере».
• /update и /version в меню Telegram.