Hermes Agent
Подключение Hermes Agent от Nous Research — самообучающегося AI-агента с Telegram, памятью и веб-дашбордом — к Hubris.
Hermes Agent — открытый AI-агент от Nous Research. Работает с файлами и терминалом, сам формирует «навыки» из опыта, хранит память между сессиями, поддерживает чат через Telegram. Подключается к любому OpenAI-совместимому провайдеру.
Требования
- Linux / macOS / WSL2 / Android (Termux)
- Python 3.11+
- Аккаунт на hubris.pw и API-ключ
Установка
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bashПерезагрузите shell:
source ~/.bashrc # или source ~/.zshrcПодключение к Hubris
Через мастер настройки (рекомендуется)
hermes setupВ меню выберите Custom Endpoint и заполните:
| Поле | Значение |
|---|---|
| Base URL | https://api.hubris.pw/v1 |
| API Key | ваш ключ из личного кабинета |
| Model | например anthropic/claude-haiku-4.5 |
| Context window | размер контекста модели (см. каталог) |
Остальные параметры можно оставить по умолчанию.
Через файлы конфигурации
~/.hermes/.env:
OPENAI_API_KEY=sk-gw-...
OPENAI_BASE_URL=https://api.hubris.pw/v1~/.hermes/config.yaml:
model:
default: "anthropic/claude-haiku-4.5"
provider: "custom"
base_url: "https://api.hubris.pw/v1"Запуск
hermesОткроется интерактивный терминал. Можно сразу писать задачу.
Веб-дашборд
Hermes поставляется со встроенным веб-интерфейсом для управления сессиями, памятью и навыками:
hermes dashboardПо умолчанию открывается на http://localhost:9119. Не открывайте на публичном IP без защиты — дашборд хранит API-ключи. Для удалённого доступа используйте SSH-туннель:
ssh -L 9119:localhost:9119 user@ваш-серверПодключение Telegram-бота
Hermes умеет принимать команды через Telegram.
- У @BotFather создайте бота (
/newbot), скопируйте токен. - У @userinfobot узнайте свой Telegram ID.
- Добавьте в
~/.hermes/.env:
TELEGRAM_BOT_TOKEN=ваш_токен_от_BotFather
TELEGRAM_ALLOWED_USERS=ваш_telegram_id- Запустите gateway:
hermes gateway startТеперь бот отвечает в Telegram через выбранную модель Hubris.
Рекомендуемые модели
Hermes — агент с длинной сессией и многократными вызовами инструментов. Подойдут модели с хорошим tool calling:
| ID | Когда уместна |
|---|---|
anthropic/claude-haiku-4.5 | быстрые типовые задачи |
openai/gpt-4o-mini | универсальный выбор |
google/gemini-2.0-flash | мультимодальные сценарии, большой контекст |
Для сложных автономных задач (рефакторинг, длинные сессии) — Claude Sonnet/Opus из каталога. Фильтр «tool calling» поможет отобрать подходящие.
Решение проблем
hermes: command not found после установки
source ~/.bashrc # или ~/.zshrcПроверьте, что ~/.local/bin в PATH: echo $PATH.
Invalid API key
- Перепроверьте ключ в
~/.hermes/.env— без пробелов, начинается сsk-gw-.
Бот в Telegram не отвечает
- Проверьте gateway:
hermes gateway status. - Убедитесь, что Telegram ID правильно указан в
TELEGRAM_ALLOWED_USERS, без пробелов и комментариев в той же строке.
No messaging platforms enabled в логах
- Проверьте, что
TELEGRAM_BOT_TOKENуказан без inline-комментариев в .env (TOKEN=xyz # commentломает парсинг — комментарий выносите на отдельную строку).
Что дальше
- Каталог моделей — выбор по поддержке tool calling.
- Управление API-ключами — отдельный ключ под Hermes.
- Расходы — детализация сессий.
- OpenClaw — альтернативный multi-messenger агент.
Обновлено: