Hermes Agent

В последние годы область ИИ-агентов быстро развивалась, эволюционируя от простых чат-ботов к агентам, которые действительно могут выполнять действия, обладают постоянной памятью и автономно развиваются.

Hermes Agent — это фреймворк автономных ИИ-агентов с открытым исходным кодом от Nous Research. Как автономный ИИ-агент, взаимодействующий посредством естественного языка, он может выполнять команды терминала, управлять браузером, читать и записывать файлы, искать в интернете, генерировать изображения и поддерживать память между сессиями.

Репозиторий GitHub:https://github.com/nousresearch/hermes-agent
Официальный сайт Hermes Agent:https://hermes-agent.nousresearch.com/

Официальное определение очень простое:
The agent that grows with you.
一个会随着使用不断成长的 Agent.
Это автономный агент, который становится тем более способным, чем дольше он работает.

Основная философия Hermes Agent такова:Сделать ИИ долгосрочным постоянно работающим цифровым сотрудником, а не одноразовым чат-ботом.

Hermes Agent — один из немногих в отраслиИИ-агент с нативно встроенным циклом обучения, который может извлекать навыки из опыта выполнения, автономно оптимизировать возможности, сохранять знания, получать доступ к истории разговоров и непрерывно совершенствовать когнитивную модель пользователя от сессии к сессии.

Отличия от обычных инструментов ИИ-чата:

Измерение	Обычный ИИ-чат (например, ChatGPT)	Hermes Agent
Память	Каждый разговор начинается с нуля	Постоянная память между сессиями; понимает вас тем лучше, чем больше вы им пользуетесь
Способность к выполнению	Может только генерировать текст	Может выполнять команды терминала, манипулировать файлами, управлять браузером
Расположение среды выполнения	Облако, данные загружаются поставщику услуг	Локально или на вашем собственном сервере, данные никогда не покидают вас
Расширяемость	Закрытая экосистема	Открытый стандарт навыков (agentskills.io), экосистема MCP
Способы доступа	Веб	CLI + Telegram/Discord/Slack/WhatsApp и др.
Привязка к модели	Фиксированная модель	Поддержка 300+ моделей, переключение в любой момент, без привязки

Основные возможности:

Подключение:Telegram, Discord, Slack, WhatsApp, Signal, Email, CLI — один агент, единая память, все платформы. Разговор, начатый в Telegram, можно бесшовно продолжить в терминале.
Запоминание:Hermes изучает ваши проекты, автоматически генерирует навыки и никогда не забывает решённые проблемы. После каждой сессии важная информация записывается в постоянную память.
Расписание:Настраивайте запланированные задачи на естественном языке — ежедневные отчёты, резервные копии, регулярные проверки, утренние брифинги — выполняемые без присмотра в фоне.
Делегирование:Создавайте изолированных субагентов с независимыми контекстами диалога, независимыми терминалами и Python RPC-скриптами, что позволяет строить параллельные конвейеры с нулевыми затратами контекста.
Поиск и мультимодальность:Веб-поиск, автоматизация браузера, визуальное понимание, генерация изображений, синтез речи и мультимодельное рассуждение — всё встроено.

Hermes Agent поддерживает свободное переключение между любой ведущей моделью, включаяNous Portal, OpenRouter (200+ моделей), OpenAI, GLM, Kimi, MiniMaxи т. д., выполнитеhermes modelчтобы мгновенно переключиться, без изменений кода и без привязки к поставщику.

Provider	Описание	Способ настройки
Nous Portal	По подписке, без настройки	через`hermes model`Вход через OAuth
OpenAI Codex	ChatGPT OAuth, использует модель Codex	через`hermes model`Аутентификация с помощью кода устройства
Anthropic	Использовать модель Claude напрямую	Через аутентификацию Claude Code или ключ Anthropic API
OpenRouter	Маршрутизация между несколькими провайдерами	Введите свой API-ключ
DeepSeek	Прямой доступ к DeepSeek API	Настройка`DEEPSEEK_API_KEY`
Hugging Face	Доступ к 20+ открытым моделям через единый роутер	Настройки`HF_TOKEN`
Пользовательский эндпоинт	VLLM, SGLang, Ollama или любой API, совместимый с OpenAI	Укажите базовый URL и ключ API

Конечно, покупка чего-то вроде Coding Plan по-прежнему наиболее выгодна, поскольку это ежемесячная подписка:

Особенности	Описание возможностей
Нативное взаимодействие с терминалом	Полноценный интерфейс TUI, поддерживающий многострочное редактирование, автодополнение команд, вызов истории, потоковый вывод и т. д.
Кроссплатформенный доступ	Единый шлюз, соединяющий CLI, Telegram, Discord, Slack, WhatsApp и другие платформы
Система обучения с замкнутым циклом	Автономное управление памятью, генерация и оптимизация навыков, воспроизведение между сессиями, моделирование пользователя
Автоматизация по расписанию	Встроенный планировщик Cron, поддерживающий автоматизированные задачи 7×24, такие как ежедневные отчёты, резервное копирование и аудит
Параллельная обработка задач	Поддерживает параллельное выполнение субагентов, разделение на несколько рабочих процессов и вызовы инструментов RPC
Работа в нескольких средах	Поддерживает 6 бэкендов, включая local, Docker, SSH, Daytona, Modal и т. д.
Возможности исследовательского уровня	Поддерживает генерацию траекторий, среды обучения с подкреплением и сжатие обучающих данных

Общая архитектура

Общий рабочий процесс:

Схема архитектуры:

Модуль	Функция	Пример
Уровень доступа (клиенты)	Принимает пользовательские запросы	Web, App, API, Feishu
Входной слой (Input)	Обрабатывает различные входные данные	Текст, изображения, PDF, Excel
Планировщик (Agent Orchestrator)	Понимает задачи и декомпозирует рабочие процессы выполнения	Анализ требований → Составление плана
Слой возможностей (Capabilities)	Предоставляет возможности выполнения	Диалог, поиск, выполнение кода
Слой памяти (Memory)	Сохраняет контекст и историческую информацию	Память сессии, долговременная память
Слой знаний (Knowledge)	Обеспечивает возможности извлечения знаний	RAG, векторная база данных
Слой модели (Model Layer)	Обеспечивает возможности рассуждения	GPT, Claude, локальные модели
Слой инструментов (Tools)	Вызывает внешние инструменты для выполнения задач	Поиск, база данных, API
Внешние сервисы	Интеграция с бизнес-системами	ERP, CRM, облачные сервисы
Инфраструктурный слой (Infrastructure)	Поддержка работы системы.	Разрешения, логи, мониторинг

Быстрая установка

Следующие команды установки применимы к системам Linux, macOS и WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

После завершения установки перезагрузите оболочку:


bashsource ~/.bashrc   # 使用 bash
# или 
source ~/.zshrc    # 使用 zsh

Нативная установка Windows (PowerShell):

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Нативная поддержка Windows всё ещё экспериментальна; рекомендуется в первую очередь использовать WSL2.

Версия для macOS / Windows (Desktop App):Перейдите наhermes-agent.nousresearch.comСкачайте установщик для вашей платформы; CLI и настольное приложение будут установлены вместе.

После загрузки просто дважды щёлкните, чтобы установить:

Проверка установки

hermes --version

Вывод номера версии означает успешную установку.

Установщик автоматически обработает все зависимости:

uvБыстрый менеджер пакетов Python
Python 3.11— Установка через uv, sudo не требуется.
Node.js v22— Для автоматизации браузера и моста WhatsApp.
ripgrepБыстрый поиск файлов
ffmpegПреобразование аудиоформата TTS

Системные инструкции Windows: : Нативная среда Windows не поддерживается. Сначала установите WSL2, затем выполните указанную выше команду в терминале WSL2.

Если вы установили OpenClaw, вы также можете напрямую импортировать конфигурацию:

Затем настройте поставщика услуг, вы можете задать свой существующий API-ключ, здесь выберите Coding Plan от Bailian:

Задайте имя модели, например MiniMax-M2.5.

Здесь выберите не импортировать; введите.n, перейдите в настройки модели, выберите первую быструю настройку:

Далее выбираем предпоследний пункт, Другие провайдеры:

Здесь вы можете выбрать больше отечественных или зарубежных больших моделей:

Далее мы используем.Byte Ark Coding Plan, поэтому выбраноКлиентский эндпоинтТо есть пользовательский адрес API и ключ API.

Base URL настраивает инструмент ByteDance Ark, совместимый с протоколом интерфейса OpenAI:https://ark.cn-beijing.volces.com/api/coding/v3

Укажите ключ API и поддерживаемые большие модели, напримерark-code-latest。

После установки выполните следующую команду:

source ~/.bashrc    # 重载shell配置（若使用zsh，执行：source ~/.zshrc）
hermes              # 开启智能体对话！

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

hermes              # 交互式命令行界面 — 开启对话
hermes model        # 选择大语言模型服务商与对应模型
hermes tools        # 配置启用的工具集
hermes config set   # 设置单项配置项
hermes gateway      # 启动消息网关（支持Telegram、Discord等平台）
hermes setup        # 运行全量配置向导（一站式完成所有配置）
hermes claw migrate # 从OpenClaw迁移数据（适用于原OpenClaw用户）
hermes update       # 更新至最新版本
hermes doctor       # 诊断运行环境与配置问题

Ручная установка

Если вы предпочитаете полностью контролировать процесс установки, выполните следующие шаги.

Шаг 1: Клонируйте репозиторий

Используйте--recurse-submodulesчтобы клонировать и получить необходимые подмодули:

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Если вы уже клонировали, но без подмодулей:

git submodule update --init --recursive

Шаг 2: Установите uv и создайте виртуальное окружение

# 安装 uv（如果尚未安装）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建 Python 3.11 的虚拟环境（uv 会在需要时下载，无需 sudo）
uv venv venv --python 3.11

Примечание:вамне нужноактивировать виртуальное окружение для использованияhermes. Точка входа имеет жёстко заданный shebang, указывающий на Python в виртуальном окружении, поэтому её можно использовать после глобальной ссылки.

Шаг 3: Установка зависимостей Python

# 告诉 uv 要安装到哪个虚拟环境
export VIRTUAL_ENV="$(pwd)/venv"

# 安装所有扩展
uv pip install -e ".[all]"

Если вам нужен только основной агент (без поддержки Telegram/Discord/cron):

uv pip install -e "."

Примечания по дополнительным расширениям:

Расширение	Характеристика	Команда установки
`all`	Включает все следующие функции	`uv pip install -e ".[all]"`
`messaging`	Шлюзы Telegram и Discord	`uv pip install -e ".[messaging]"`
`cron`	Разбор cron-выражений для запланированных задач	`uv pip install -e ".[cron]"`
`voice`	Ввод с микрофона в CLI и воспроизведение аудио	`uv pip install -e ".[voice]"`
`mcp`	Поддержка Model Context Protocol	`uv pip install -e ".[mcp]"`
`honcho`	AI-нативная память (интеграция с Honcho)	`uv pip install -e ".[honcho]"`

Мы можем использовать их в сочетании:uv pip install -e ".[messaging,cron]"

Шаг 4: Создайте каталог конфигурации

# 创建目录结构
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}

# 复制示例配置文件
cp cli-config.yaml.example ~/.hermes/config.yaml

# 创建空的 .env 文件用于存储 API 密钥
touch ~/.hermes/.env

Шаг 5: Добавьте ключи API

Open~/.hermes/.envи добавьте как минимум один ключ провайдера LLM:

# 必需 — 至少一个 LLM 提供商：
OPENROUTER_API_KEY=sk-or-v1-your-key-here

# 可选 — 启用其他工具：
FIRECRAWL_API_KEY=fc-your-key          # 网页搜索和抓取
FAL_KEY=your-fal-key                   # 图像生成（FLUX）

Или задайте его через CLI:

hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here

Шаг 6: Добавьте hermes в PATH

mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes

Если~/.local/binне находится в PATH, пожалуйста, добавьте его в конфигурацию вашей оболочки:

# Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Шаг 7: Настройте вашего провайдера

hermes model       # 选择您的 LLM 提供商和模型

Шаг 8: Проверьте установку

hermes version    # 检查命令是否可用
hermes doctor     # 运行诊断以验证一切正常
hermes status     # 检查您的配置
hermes chat -q "Hello! What tools do you have available?"

Устранение неполадок

Проблема	Решение
`hermes: command not found`	Перезагрузите оболочку (`source ~/.bashrc`) или проверьте PATH
API-ключ не задан	Запустите`hermes model`чтобы настроить провайдера, или`hermes config set OPENROUTER_API_KEY your_key`
Конфигурация потеряна после обновления	Запустите`hermes config check`затем`hermes config migrate`

Для получения дополнительной диагностической информации выполнитеhermes doctor— он подскажет, чего не хватает и как это исправить.

Примечание:Вы всегда можете, черезhermes modelПереключайте провайдеров — без изменений кода, без привязки.

Заголовок карточки

Больше контента

Список содержимого

Конфигурация Hermes Agent Hermes Agent CLI Инструменты Hermes Agent Навыки Hermes Agent Интеграция MCP Hermes Agent

Шлюз сообщений

Шлюз сообщений Hermes Agent позволяет взаимодействовать с агентом на нескольких платформах — Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant и других.

Отправляйте сообщения на 15+ платформ из единого шлюза. Оставайтесь на связи с Hermes, где бы вы ни находились.

Поддерживаемые платформы

Платформа	Описание	Status
Telegram	Самая полная интеграция с платформой обмена сообщениями	✅ Поддерживается
Discord	Поддержка серверов и голосовых каналов	✅ Поддерживается
Slack	Интеграция с рабочим пространством	✅ Поддерживается
WhatsApp	Через WhatsApp Web	✅ Поддерживается
Signal	Приложение для приватных сообщений	✅ Поддерживается
Matrix	Децентрализованное общение	✅ Поддерживается
Mattermost	Обмен сообщениями с собственным хостингом	✅ Поддерживается
Электронная почта	Электронная почта SMTP	✅ Поддерживается
SMS	Отправка SMS	✅ Поддерживается
DingTalk	DingTalk	✅ Поддерживается
Feishu	Feishu	✅ Поддерживается
WeCom	WeCom	✅ Поддерживается
BlueBubbles	macOS iMessage	✅ Поддерживается
Home Assistant	Умный дом	✅ Поддерживается
Вебхуки	Пользовательский HTTP-колбэк	✅ Поддерживается

Настройка платформы обмена сообщениями

Интерактивная настройка:

hermes gateway setup

Это запускает интерактивный мастер настройки, который проведёт вас через настройку каждой платформы.

Ручная настройка:

Или отредактируйте напрямую~/.hermes/config.yaml：

Telegram:

# 在 ~/.hermes/.env 中
TELEGRAM_BOT_TOKEN=your-bot-token

# config.yaml
gateway:
  adapters:
    telegram:
      enabled: true

Discord:

# 在 ~/.hermes/.env 中
DISCORD_BOT_TOKEN=your-discord-token

# config.yaml
gateway:
  adapters:
    discord:
      enabled: true
      allowed_channels:
        - "123456789"

Slack:

# 在 ~/.hermes/.env 中
SLACK_BOT_TOKEN=xoxb-your-token
SLACK_SIGNING_SECRET=your-signing-secret

# config.yaml
gateway:
  adapters:
    slack:
      enabled: true

WhatsApp:

# WhatsApp 需要浏览器自动化
# 首次设置需要扫描二维码

# config.yaml
gateway:
  adapters:
    whatsapp:
      enabled: true
      session_dir: ~/.hermes/whatsapp/session

Электронная почта (SMTP):

# 在 ~/.hermes/.env 中
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
[email protected]
SMTP_PASSWORD=your-app-password

# config.yaml
gateway:
  adapters:
    email:
      enabled: true
      from_email: [email protected]

Home Assistant:

# 在 ~/.hermes/.env 中
HA_URL=http://homeassistant.local:8123
HA_TOKEN=your-long-lived-access-token

# config.yaml
gateway:
  adapters:
    homeassistant:
      enabled: true

Запуск шлюза

Запуск на переднем плане:

hermes gateway

Запуск в фоновом режиме (рекомендуется):

hermes gateway &
# 或使用 systemd
systemctl enable hermes-agent
systemctl start hermes-agent

Запуск с помощью Docker:

docker run -d \
  --name hermes-gateway \
  -v ~/.hermes:/home/hermes/.hermes \
  ghcr.io/nousresearch/hermes-agent:latest \
  hermes gateway

Конфигурация для конкретной платформы

Telegram:

Создайте нового бота через @BotFather
Получите токен бота
Настройте и запустите Hermes
Отправьте сообщение своему боту в Telegram/start

Discord:

Создайте приложение на портале разработчиков Discord
Добавьте бота на сервер
Получите токен бота
Настройте и запустите Hermes

Slack:

Создайте новое приложение на портале приложений Slack
Добавить области действия токена бота
Установить в рабочее пространство
Настройте и запустите Hermes

Отправка сообщений:

Используйтеsend_messageинструмент для отправки сообщений через любой настроенный канал:

send_message(
  platform="telegram",
  chat_id="123456789",
  message="Hello from Hermes!"
)

Или запланируйте автоматические сообщения через cron:

# 设置每日简报
hermes
❯ 每天早上9点检查 Hacker News 上的 AI 新闻，并通过 Telegram 给我发送摘要

Поддержка голоса

Некоторые платформы поддерживают голосовое взаимодействие:

Telegram: голосовые сообщения и голосовые вызовы
Discord: голосовые каналы и голосовые сообщения
CLI: ввод с микрофона и TTS

Подробнее о голосовых режимах см. в руководстве по голосовым режимам.

Вопросы безопасности

Важно:

Не добавляйте API-ключи в систему контроля версий
Используйте переменные окружения или защищённое хранилище учётных данных
Ограничьте пользователей/каналы, которым разрешено взаимодействовать с агентом
Регулярно выполняйте ротацию API-ключей
Включите подтверждение команд на публичных платформах

Устранение неполадок

Проблема	Решение
Бот не отвечает	Проверьте, работает ли шлюз
Ошибки прав доступа	Проверьте токен бота и разрешения
Сообщения не отправляются	Проверьте идентификатор канала и конфигурацию
Тайм-аут соединения	Проверьте настройки сети и брандмауэра

Совет:Используйтеhermes gateway --verboseчтобы просмотреть подробные журналы для отладки проблем.

Другие расширения

Инструменты агента

Python: реализация интеллектуальных агентов

Hermes Agent

Общая архитектура

Быстрая установка

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

Ручная установка

Шаг 1: Клонируйте репозиторий

Шаг 2: Установите uv и создайте виртуальное окружение

Шаг 3: Установка зависимостей Python

Шаг 4: Создайте каталог конфигурации

Шаг 5: Добавьте ключи API

Шаг 6: Добавьте hermes в PATH

Шаг 7: Настройте вашего провайдера

Шаг 8: Проверьте установку

Устранение неполадок

Шлюз сообщений

Поддерживаемые платформы

Настройка платформы обмена сообщениями

Интерактивная настройка:

Ручная настройка:

Запуск шлюза

Запуск на переднем плане:

Запуск в фоновом режиме (рекомендуется):

Запуск с помощью Docker:

Конфигурация для конкретной платформы

Telegram:

Discord:

Slack:

Отправка сообщений:

Поддержка голоса

Вопросы безопасности

Устранение неполадок