Установка и настройка
Свой агент в Telegram
за десять минут
Одна команда на сервере или компьютере. Установщик скачает готовую программу, мастер спросит модель и бота, сам всё проверит и запустит агента службой.
Актуальная версия v1.2.4. Подходит сервер с Linux, а также компьютер с Windows или macOS.
Видеоинструкция
Установка за полторы минуты
Настоящая запись на чистом сервере Debian. Долгие места ускорены. Ключ нейросети и токен бота в записи тестовые.
Перед началом
Что понадобится
Сервер или компьютер
Лучше всего сервер с Linux: агент отвечает круглосуточно. Ubuntu или Debian, процессор x86_64 или arm64, от 2 ГБ памяти и вход по SSH с правами root. Для расшифровки голосовых и записей звонков лучше 4 ГБ и 4 ядра. Открывать порты наружу не нужно: агент сам забирает сообщения у Telegram. Для Windows и macOS смотрите ниже.
Доступ к нейросети
Подписка ChatGPT (вход кодом с телефона, ключ не нужен) или ключ API: OpenRouter, DeepSeek, Anthropic, GigaChat, YandexGPT и другие. Подойдёт и своя модель на этой же машине.
Бот в Telegram
Напишите @BotFather, отправьте /newbot, придумайте имя и логин бота. BotFather пришлёт токен: длинную строку с двоеточием. Её вставите в мастер.
Свой Telegram ID
Это число, по которому агент узнает владельца. Напишите @userinfobot, он пришлёт ваш ID. Если не успели, бот назовёт его сам в ответ на первое сообщение.
По шагам
Установка
# на сервере, от root# curl -fsSL https://capyagent.ru/install.sh | sh
Зайдите на сервер
Откройте терминал и подключитесь: ssh root@адрес_сервера. Если вы входите обычным пользователем, станьте root командой sudo -i.
Выполните одну команду
Установщик скачает готовую программу под ваш процессор с capyagent.ru, сверит контрольную сумму и сам откроет мастер настройки. Собирать ничего не нужно.
Выберите модель
Введите номер из списка или название: chatgpt, openrouter, deepseek. Для подписки ChatGPT мастер покажет ссылку и код: откройте её на телефоне и введите код. Ключ API вставьте и нажмите Enter. Мастер сразу проверит, что модель отвечает, и только потом запишет настройки.
Подключите Telegram
Вставьте токен бота (при вставке его не видно, так задумано) и свой Telegram ID. На вопрос о службе ответьте «да»: агент будет работать сам и поднимется после перезагрузки. Если нужны голосовые и записи звонков, на эти вопросы тоже ответьте «да». Файлы больше 20 МБ требуют прямой связи сервера с Telegram, а с серверов в России её обычно нет: тогда на этот вопрос ответьте «нет», всё остальное работает и так.
Напишите боту
Дождитесь строки «Готово: агент работает службой» и напишите боту в Telegram «привет». Агент ответит. Дальше просто разговаривайте с ним.
Свой компьютер
Windows и macOS
Агент работает и на обычном компьютере. Бот в Telegram отвечает, пока компьютер включён и агент запущен. Нужен круглосуточный бот - ставьте на сервер.
macOS
Откройте Терминал и выполните ту же команду, что и на сервере: curl -fsSL https://capyagent.ru/install.sh | sh. Права администратора не нужны: программа ляжет в ваш домашний каталог, мастер настройки откроется сам. В конце мастер напишет точную команду запуска агента: пока она работает, бот отвечает. Расшифровке голосовых на Mac нужна программа whisper.cpp: brew install whisper-cpp.
Windows
Откройте PowerShell (не от администратора) и выполните: iwr -useb https://capyagent.ru/install.ps1 | iex. Программа ляжет в ваш профиль, мастер спросит модель и бота так же, как на сервере. Расшифровки голосовых на самой машине под Windows пока нет. Если у вас стоит WSL2 с Ubuntu, можно поставить агента внутри неё командой для Linux.
Приложение с окном
Не хотите терминал - скачайте приложение CapyAgent для macOS, Windows или Linux. Внутри тот же агент: чат, настройки и подключение Telegram в окне.
Потом
Полезные команды
Для сервера с Linux и установки от root. Если ставили обычным пользователем, программа лежит в ~/.local/bin/capyagent, а служба управляется через systemctl --user.
# проверить, что всё в порядке# /opt/capyagent/bin/capyagent doctor # работает ли агент и его журнал# systemctl status capyagent# journalctl -u capyagent -f # обновить вручную# /opt/capyagent/bin/capyagent update
Что агент умеет сразу: отвечает в Telegram и в веб-панели, помнит разговоры, расшифровывает голосовые и записи звонков прямо на сервере, принимает большие файлы, ставит напоминания и задачи по расписанию.
Если не пошло
Частые вопросы
Мастер пишет, что сервис не пускает из вашей страны
Бот не отвечает
/opt/capyagent/bin/capyagent doctor: она покажет, что не так, и подскажет, что сделать. Журнал службы: journalctl -u capyagent -f. Частая причина: ответ приходит, только если вы написали с того Telegram, чей ID указали в мастере.Как обновить агента
sudo CAPYAGENT_UPDATE=1 /opt/capyagent/bin/capyagent update. Перед обновлением он сохраняет прежнюю версию и данные, при сбое возвращается назад.Можно поставить без root или на свой компьютер
Голосовые и записи звонков уходят куда-то
Сколько это стоит
Агент работает - дайте ему первую задачу
Можно разобраться самому или заказать настройку под ваши задачи.