Как поставить AI-агента Hermes на российском сервере Timeweb

// Что такое Hermes Agent

Hermes Agent — опенсорсный AI-агент от Nous Research. Живёт на VPS, помнит всё между сессиями, сам пишет переиспользуемые скиллы в процессе работы. Общается через CLI, Telegram, email и другие каналы.

Главное отличие: это не чат без памяти. Hermes живёт на сервере постоянно — видит инфраструктуру, запускает команды, читает логи, пишет код, отправляет письма, выполняет cron-задачи.

// Hermes vs другие инструменты

Большинство запускает Hermes вместе с Claude Code. Claude Code — для кодинга в репо. Hermes — для всего остального: мониторинг ботов, почта, cron, дайджесты, автоматизация.

// Что нужно заранее

• → VPS на Timeweb — сам разворачивал именно там, работает стабильно, поддержка на русском: timeweb.cloud/r/dh428486 (или Hetzner, DO, Hostinger — не принципиально)
• → SSH-доступ: ssh root@SERVER_IP
• → Прокси, если LLM API нестабильны из РФ — рабочий вариант: t.me/ModJus_bot
• → API-ключи: OpenRouter, Anthropic Claude, Kie.ai (медиа)
• → Виртуальная карта для оплаты API из РФ: t.me/zarub_robot
• → Telegram bot token (если нужен бот-интерфейс от @BotFather)

// Подготовка сервера

apt update
apt install -y curl git build-essential python3 python3-venv nginx docker.io docker-compose-plugin

Составь карту того, что уже живёт на сервере — потом это понадобится для кастомного скилла server-bots-ops:

systemctl list-units --type=service
docker ps
find /root -maxdepth 3 -type f -name "*.py"
find /opt -maxdepth 3 -type f -name "docker-compose.yml"

// Установка Hermes

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | sh
source ~/.bashrc
hermes setup

hermes doctor

Если что-то красное — почти всегда одна из трёх причин:

// Выбор модели — главная ошибка первой недели

// Прокси для LLM API

На российских VPS OpenAI, Anthropic, OpenRouter иногда работают нестабильно. Прокидываем все LLM-запросы через прокси — рабочий вариант для РФ покупал тут: t.me/ModJus_bot

HTTP_PROXY=http://USER:PASS@HOST:PORT
HTTPS_PROXY=http://USER:PASS@HOST:PORT
ALL_PROXY=http://USER:PASS@HOST:PORT

// Telegram-шлюз и запуск как сервис

hermes gateway setup
# вставить токен бота от @BotFather
# числовой Telegram user ID из @userinfobot — именно число, не @username

systemctl enable hermes-gateway.service
systemctl start hermes-gateway.service

// Скиллы — как Hermes умнеет

После каждых ~5 вызовов инструментов Hermes делает паузу и спрашивает себя: есть ли здесь переиспользуемый паттерн? Если да — пишет ~/.hermes/skills/<name>/SKILL.md и подтягивает его в следующий раз. Скиллы — обычный markdown: читаются, редактируются, удаляются вручную.

Установить в первый день:

hermes skills install duckduckgo-search    # поиск
hermes skills install scrapling            # веб-скрапинг
hermes skills install agentmail            # почта
hermes skills install qdrant-vector-search # база знаний
hermes skills install security-audit       # аудит репо

Кастомные скиллы (добавляешь сам):

// Почта через Himalaya

curl -sSL https://raw.githubusercontent.com/soywod/himalaya/master/install.sh | bash
himalaya account configure

Для Gmail — app password, не обычный пароль. Перед отправкой Hermes показывает черновик и ждёт подтверждения. Пример:

// Примеры задач

// Безопасность

• ✓ Ключи только в .env — никогда не хардкодить в коде
• ✓ Панель закрыть Nginx Basic Auth
• ✓ Не открывать Hermes API наружу без авторизации
• ✓ Подтверждение перед rm, docker compose down, массовыми рассылками
• ✓ Числовой Telegram user ID в allowlist — не @хэндл

hermes
> включи политику подтверждения для деструктивных операций

// Итоговая архитектура

Timeweb VPS
├── Hermes Agent
├── OpenRouter / Claude / Kie.ai через proxy
├── Telegram gateway
├── custom skills (server-bots-ops, email-ops, kie-router)
├── Gmail через Himalaya
├── Telegram / Docker боты
└── Mission Control (Nginx :8090)

Это уже не «чат с нейронкой». Это серверный оператор: видит инфраструктуру, пишет код, проверяет ботов, готовит письма, запускает cron, собирает данные — и становится умнее с каждой неделей.

// FAQ

// Полезные ссылки