🏠 Главная › Reference › cli commands

sidebar_position: 1 title: "CLI Commands Reference" description: "Authoritative reference for Hermes terminal commands and command families" lang: ru

Справочник команд CLI

На этой странице описаны команды терминала, которые вы запускаете из своей оболочки.

Слэш-команды в чате см. в Справочнике косых команд.

Глобальная точка входа

hermes [global-options] <command> [subcommand/options]

Глобальные параметры

Вариант Описание
--version, -V Показать версию и выйти.
--profile <name>, -p <name> Выберите, какой профиль Hermes использовать для этого вызова. Отменяет фиксированное значение по умолчанию, установленное hermes profile use.
--resume <session>, -r <session> Возобновите предыдущий сеанс по идентификатору или названию.
--continue [name], -c [name] Возобновите самый последний сеанс или самый последний сеанс, соответствующий заголовку.
--worktree, -w Начните с изолированного рабочего дерева git для рабочих процессов параллельного агента.
--yolo Обход запросов на одобрение опасных команд.
--pass-session-id Включите идентификатор сеанса в системную подсказку агента.
--ignore-user-config Игнорируйте ~/.hermes/config.yaml и вернитесь к встроенным настройкам по умолчанию. Учетные данные в .env все еще загружаются.
--ignore-rules Пропустите автоматическое внедрение AGENTS.md, SOUL.md, .cursorrules, памяти и предварительно загруженных навыков.
--tui Запустите TUI вместо классического интерфейса командной строки. Эквивалент HERMES_TUI=1.
--dev С помощью --tui: запустите исходные коды TypeScript напрямую через tsx вместо готового пакета (для участников TUI).

Команды верхнего уровня

Команда Цель
hermes chat Интерактивный или одноразовый чат с агентом.
hermes model В интерактивном режиме выберите поставщика и модель по умолчанию.
hermes fallback Управление резервными поставщиками осуществляется при ошибках основной модели.
hermes gateway Запускайте или управляйте службой шлюза обмена сообщениями.
hermes setup Интерактивный мастер настройки для всей или части конфигурации.
hermes whatsapp Настройте и подключите мост WhatsApp.
hermes slack Помощники Slack (на данный момент: генерируют манифест приложения с каждой командой в виде собственной косой черты).
hermes auth Управляйте учетными данными — добавляйте, перечисляйте, удаляйте, сбрасывайте, устанавливайте стратегию. Обрабатывает потоки OAuth для Codex/Nous/Anthropic.
hermes login / logout Устарело — вместо этого используйте hermes auth.
hermes status Показать агент, авторизацию и статус платформы.
hermes cron Проверьте и отметьте планировщик cron.
hermes kanban Многопрофильная доска совместной работы (задачи, ссылки, диспетчер).
hermes webhook Управляйте динамическими подписками на веб-перехватчики для активации на основе событий.
hermes hooks Проверьте, одобрите или удалите перехватчики сценариев оболочки, объявленные в config.yaml.
hermes doctor Диагностика проблем конфигурации и зависимостей.
hermes dump Сводная информация о настройке с возможностью копирования и вставки для поддержки/отладки.
hermes debug Инструменты отладки — загружайте журналы и информацию о системе для поддержки.
hermes backup Создайте резервную копию домашнего каталога Hermes в zip-файле.
hermes import Восстановите резервную копию Hermes из zip-файла.
hermes logs Просмотр, хвост и фильтрация файлов журнала агента/шлюза/ошибок.
hermes config Показывайте, редактируйте, переносите и запрашивайте файлы конфигурации.
hermes pairing Одобрить или отозвать коды сопряжения для обмена сообщениями.
hermes skills Просматривайте, устанавливайте, публикуйте, проверяйте и настраивайте навыки.
hermes curator Обслуживание фоновых навыков — статус, запуск, пауза, закрепление. См. Куратор.
hermes memory Настройте поставщика внешней памяти. Подкоманды, специфичные для плагина (например, hermes honcho), регистрируются автоматически, когда их провайдер активен.
hermes acp Запустите Hermes в качестве сервера ACP для интеграции редактора.
hermes mcp Управляйте конфигурациями сервера MCP и запускайте Hermes в качестве сервера MCP.
hermes plugins Управление плагинами Hermes Agent (установка, включение, отключение, удаление).
hermes tools Настройте включенные инструменты для каждой платформы.
hermes sessions Просматривайте, экспортируйте, сокращайте, переименовывайте и удаляйте сеансы.
hermes insights Показать аналитику токенов/стоимости/активности.
hermes fallback Интерактивный менеджер цепочки резервных поставщиков.
hermes claw Помощники по миграции OpenClaw.
hermes dashboard Запустите веб-панель для управления конфигурацией, ключами API и сеансами.
hermes profile Управление профилями — несколько изолированных экземпляров Hermes.
hermes completion Распечатать сценарии завершения оболочки (bash/zsh/fish).
hermes version Показать информацию о версии.
hermes update Извлеките последний код и переустановите зависимости. --check печатает разницу фиксации без извлечения; --backup делает предварительный снимок HERMES_HOME.
hermes uninstall Удалите Гермес из системы.

hermes chat

hermes chat [options]

Распространенные варианты:

Вариант Описание
-q, --query "..." Однократная неинтерактивная подсказка.
-m, --model <model> Переопределите модель для этого прогона.
-t, --toolsets <csv> Включите набор наборов инструментов, разделенных запятыми.
--provider <provider> Принудительно установить провайдера: auto, openrouter, nous, openai-codex, copilot-acp, copilot, anthropic, gemini, google-gemini-cli, huggingface, zai, kimi-coding, kimi-coding-cn, minimax, minimax-cn, minimax-oauth, kilocode, xiaomi, arcee, gmi, alibaba, alibaba-coding-plan (псевдоним alibaba_coding), deepseek, nvidia, ollama-cloud, xai (псевдоним grok), qwen-oauth, bedrock, opencode-zen, opencode-go, ai-gateway, azure-foundry, tencent-tokenhub (псевдоним tencent, tokenhub).
-s, --skills <name> Предварительно загрузите один или несколько навыков для сеанса (можно повторять или разделять запятыми).
-v, --verbose Подробный вывод.
-Q, --quiet Программный режим: запретить предварительный просмотр баннера/спиннера/инструмента.
--image <path> Прикрепите локальное изображение к одному запросу.
--resume <session> / --continue [name] Возобновите сеанс прямо из chat.
--worktree Создайте изолированное рабочее дерево git для этого запуска.
--checkpoints Включите контрольные точки файловой системы перед деструктивными изменениями файлов.
--yolo Пропустить запросы на одобрение.
--pass-session-id Передайте идентификатор сеанса в системную подсказку.
--ignore-user-config Игнорируйте ~/.hermes/config.yaml и используйте встроенные значения по умолчанию. Учетные данные в .env все еще загружаются. Полезно для изолированных запусков CI, воспроизводимых отчетов об ошибках и сторонних интеграций.
--ignore-rules Пропустите автоматическое внедрение AGENTS.md, SOUL.md, .cursorrules, постоянной памяти и предварительно загруженных навыков. В сочетании с --ignore-user-config для полностью изолированного запуска.
--source <tag> Тег источника сеанса для фильтрации (по умолчанию: cli). Используйте tool для сторонних интеграций, которые не должны отображаться в списках сеансов пользователей.
--max-turns <N> Максимальное количество итераций вызова инструмента за ход разговора (по умолчанию: 90 или agent.max_turns в конфигурации).

Примеры:

hermes
hermes chat -q "Summarize the latest PRs"
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills
hermes chat --quiet -q "Return only JSON"
hermes chat --worktree -q "Review this repo and open a PR"
hermes chat --ignore-user-config --ignore-rules -q "Repro without my personal setup"

hermes -z <prompt> — скриптовый одноразовый

Для программных вызывающих программ (сценарии оболочки, CI, cron, родительские процессы, передающие приглашение по конвейеру), hermes -z — это самая чистая одноразовая точка входа: одно приглашение, окончательный текст ответа, больше ничего на стандартный вывод или стандартный поток ошибок. Никакого баннера, никакого индикатора, никаких предварительных просмотров инструментов, никакой строки Session: — только окончательный ответ агента в виде обычного текста.

hermes -z "What's the capital of France?"
# → Paris.

# Parent scripts can cleanly capture the response:
answer=$(hermes -z "summarize this" < /path/to/file.txt)

Переопределения для каждого запуска (без изменения ~/.hermes/config.yaml):

Флаг Эквивалентная переменная окружения Цель
-m / --model <model> HERMES_INFERENCE_MODEL Переопределить модель для этого прогона
--provider <provider> HERMES_INFERENCE_PROVIDER Переопределить поставщика для этого запуска 
hermes -z "…" --provider openrouter --model openai/gpt-5.5
# or:
HERMES_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 hermes -z "…"

Тот же агент, те же инструменты, те же навыки — просто удаляются все интерактивные/косметические слои. Если вам также нужны выходные данные инструмента в расшифровке, используйте вместо этого hermes chat -q; -z явно означает «Мне нужен только окончательный ответ».

hermes model

Интерактивный провайдер + селектор модели. Это команда для добавления новых поставщиков, настройки ключей API и запуска потоков OAuth. Запускайте ее со своего терминала, а не из активного сеанса чата Hermes.

hermes model

Используйте это, если хотите: - добавить нового провайдера (OpenRouter, Anthropic, Copilot, DeepSeek, custom и т. д.) - войдите в провайдеры, поддерживающие OAuth (Anthropic, Copilot, Codex, Nous Portal) - введите или обновите ключи API - выбор из списков моделей конкретного поставщика - настроить пользовательскую/автономную конечную точку - сохранить новое значение по умолчанию в конфиге

:::предупреждение Модель Гермеса и /модель — почувствуйте разницу hermes model (запускается с вашего терминала вне любого сеанса Hermes) — это мастер полной настройки провайдера. Он может добавлять новых поставщиков, запускать потоки OAuth, запрашивать ключи API и настраивать конечные точки.

/model (введенный в активном сеансе чата Hermes) может только переключаться между поставщиками и моделями, которые вы уже настроили. Он не может добавлять новых поставщиков, запускать OAuth или запрашивать ключи API.

Если вам нужно добавить нового провайдера: сначала выйдите из сеанса Hermes (Ctrl+C или /quit), а затем запустите hermes model из командной строки терминала.

/model косая черта (в середине сеанса)

Переключайтесь между уже настроенными моделями, не выходя из сеанса:

/model                              # Show current model and available options
/model claude-sonnet-4              # Switch model (auto-detects provider)
/model zai:glm-5                    # Switch provider and model
/model custom:qwen-2.5              # Use model on your custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Use a named custom provider
/model openrouter:anthropic/claude-sonnet-4  # Switch back to cloud

По умолчанию изменения /model применяются только к текущему сеансу. Добавьте --global, чтобы сохранить изменения в config.yaml:

/model claude-sonnet-4 --global     # Switch and save as new default

ℹ️ Info

Что делать, если я вижу только модели OpenRouter? Если вы настроили только OpenRouter, `/model` будет отображать только модели OpenRouter. Чтобы добавить другого провайдера (Anthropic, DeepSeek, Copilot и т. д.), выйдите из сеанса и запустите `hermes model` с терминала.

Изменения поставщика и базового URL-адреса автоматически сохраняются в config.yaml. При переключении с пользовательской конечной точки устаревший базовый URL-адрес очищается, чтобы предотвратить его утечку к другим поставщикам.

hermes gateway

hermes gateway <subcommand>

Подкоманды:

Подкоманда Описание
run Запустите шлюз на переднем плане. Рекомендуется для WSL, Docker и Termux.
start Запустите установленную фоновую службу systemd/launchd.
stop Остановите службу (или приоритетный процесс).
restart Перезапустите службу.
status Показать статус услуги.
install Установите как фоновую службу systemd (Linux) или launchd (macOS).
uninstall Удалите установленную службу.
setup Настройка интерактивной платформы обмена сообщениями.

Опции:

Вариант Описание
--all На start / restart / stop: действуйте на шлюзе каждого профиля, а не только на активном HERMES_HOME. Полезно, если вы запускаете несколько профилей одновременно и хотите перезапустить их все после hermes update.

:::совет пользователям WSL Используйте hermes gateway run вместо hermes gateway start — поддержка systemd в WSL ненадежна. Для устойчивости оберните его в tmux: tmux new -s hermes 'hermes gateway run'. Подробности см. в Часто задаваемые вопросы о WSL.

hermes setup

hermes setup [model|tts|terminal|gateway|tools|agent] [--non-interactive] [--reset] [--quick] [--reconfigure]

Первый запуск: запускает мастер при первом запуске.

Вернувшийся пользователь (уже настроен): сразу открывается мастер полной перенастройки — в каждом запросе отображается текущее значение по умолчанию. Нажмите Enter, чтобы сохранить или ввести новое значение. Нет меню.

Перейдите в один раздел вместо полного мастера:

Раздел Описание
model Настройка поставщика и модели.
terminal Настройка серверной части терминала и песочницы.
gateway Настройка платформы обмена сообщениями.
tools Включить/отключить инструменты для каждой платформы.
agent Настройки поведения агента.

Опции:

Вариант Описание
--quick При запуске вернувшегося пользователя: запрашивать только те элементы, которые отсутствуют или не установлены. Пропустите элементы, которые вы уже настроили.
--non-interactive Используйте значения по умолчанию/среды без подсказок.
--reset Перед установкой сбросьте конфигурацию до значений по умолчанию.
--reconfigure Псевдоним обратной совместимости — пустой hermes setup в существующей установке теперь делает это по умолчанию.

hermes whatsapp

hermes whatsapp

Запускает процесс сопряжения/настройки WhatsApp, включая выбор режима и сопряжение с QR-кодом.

hermes slack

hermes slack manifest              # print manifest to stdout
hermes slack manifest --write      # write to ~/.hermes/slack-manifest.json
hermes slack manifest --slashes-only  # just the features.slash_commands array

Создает манифест приложения Slack, в котором регистрируются все команды шлюза. COMMAND_REGISTRY (/btw, /stop, /model, …) как первоклассный Команда Slack slash — соответствие Discord и Telegram четности. Вставьте вывод в конфигурацию вашего приложения Slack по адресу https://api.slack.com/apps → ваше приложение → Функции → Манифест приложения → Изменить, затем Сохранить. Slack запрашивает переустановите, если изменились области видимости или команды слэша.

Флаг По умолчанию Цель
--write [PATH] стандартный вывод Запись в файл вместо стандартного вывода. Голый --write пишет $HERMES_HOME/slack-manifest.json.
--name NAME Hermes Отображаемое имя бота в Slack.
--description DESC аннотация по умолчанию Описание бота отображается в каталоге приложения Slack.
--slashes-only выключен Выдавайте только features.slash_commands для слияния с манифестом, поддерживаемым вручную.

Запустите hermes slack manifest --write еще раз после hermes update, чтобы выбрать любые новые команды.

hermes login / hermes logout (Устарело)

:::осторожно hermes login удален. Используйте hermes auth для управления учетными данными OAuth, hermes model для выбора поставщика или hermes setup для полной интерактивной настройки.

hermes auth

Управляйте пулами учетных данных для ротации ключей одного и того же поставщика. Полную документацию см. в разделе Пулы учетных данных.

hermes auth                                              # Interactive wizard
hermes auth list                                         # Show all pools
hermes auth list openrouter                              # Show specific provider
hermes auth add openrouter --api-key sk-or-v1-xxx        # Add API key
hermes auth add anthropic --type oauth                   # Add OAuth credential
hermes auth remove openrouter 2                          # Remove by index
hermes auth reset openrouter                             # Clear cooldowns

Подкоманды: add, list, remove, reset. При вызове без подкоманды запускает мастер интерактивного управления.

hermes status

hermes status [--all] [--deep]
Вариант Описание
--all Покажите все детали в общедоступном отредактированном формате.
--deep Выполните более глубокие проверки, которые могут занять больше времени.

hermes cron

hermes cron <list|create|edit|pause|resume|run|remove|status|tick>
Подкоманда Описание
list Показать запланированные задания.
create / add Создайте запланированное задание из приглашения, при необходимости прикрепив один или несколько навыков с помощью повторяющегося --skill.
edit Обновите расписание задания, приглашение, имя, доставку, количество повторов или прикрепленные навыки. Поддерживает --clear-skills, --add-skill и --remove-skill.
pause Приостановите задание, не удаляя его.
resume Возобновите приостановленное задание и рассчитайте его следующее будущее выполнение.
run Запустите задание при следующем тике планировщика.
remove Удалить запланированное задание.
status Проверьте, запущен ли планировщик cron.
tick Запустите необходимые задания один раз и выйдите.

hermes kanban

hermes kanban [--board <slug>] <action> [options]

Многопрофильная, многопроектная доска сотрудничества. Каждая установка может содержать множество досок (по одной на проект, репозиторий или домен); каждая плата представляет собой отдельную очередь со своей собственной базой данных SQLite и областью действия диспетчера. Новые установки начинаются с одной платы под названием default, чья база данных — ~/.hermes/kanban.db для обратной совместимости; дополнительные доски доступны по адресу ~/.hermes/kanban/boards/<slug>/kanban.db. Диспетчер, встроенный в шлюз, проверяет каждую доску за тик.

Глобальные флаги (применяются ко всем действиям, указанным ниже):

Флаг Цель
--board <slug> Работайте на конкретной доске. По умолчанию используется текущая плата (устанавливается через hermes kanban boards switch, HERMES_KANBAN_BOARD env var или default).

Это поверхность для людей/сценариев. Работники агентов, созданные диспетчером, управляют платой с помощью специального kanban_* набора инструментов (kanban_show, kanban_complete, kanban_block, kanban_create, kanban_link, kanban_comment, kanban_heartbeat) вместо обстрела на hermes kanban. Работники закрепили HERMES_KANBAN_BOARD в своем окружении, чтобы они физически не могли видеть другие доски.

Действие Цель
init Создайте kanban.db, если он отсутствует. Идемпотент.
boards list / boards ls Перечислите все доски с количеством задач. --json, --all (включить в архив).
boards create <slug> Создайте новую доску. Флаги: --name, --description, --icon, --color, --switch (сделать активными). Слизень шашлычный, автоопускаемый.
boards switch <slug> / boards use Сохранять <slug> в качестве активной платы (пишет ~/.hermes/kanban/current).
boards show / boards current Распечатайте имя активной в данный момент доски, путь к базе данных и количество задач.
boards rename <slug> "<name>" Измените отображаемое имя доски. Слизень неизменен.
boards rm <slug> Архивировать (по умолчанию) или принудительно удалить доску. --delete пропускает этап архивирования. Архивированные платы перемещаются в boards/_archived/<slug>-<ts>/. Отказано по default.
create "<title>" Создайте новую задачу на активной доске. Флаги: --body, --assignee, --parent (повторяемые), --workspace scratch\|worktree\|dir:<path>, --tenant, --priority, --triage, --idempotency-key, --max-runtime, --skill (повторяемые).
list / ls Перечислите задачи на активной доске. Фильтруйте с помощью --mine, --assignee, --status, --tenant, --archived, --json.
show <id> Показать задачу с комментариями и событиями. --json для машинного вывода.
assign <id> <profile> Назначить или переназначить. Используйте none, чтобы отменить назначение. Отказано во время выполнения задачи.
link <parent> <child> Добавьте зависимость. Обнаружен цикл. Обе задачи должны находиться на одной доске.
unlink <parent> <child> Удалить зависимость.
claim <id> Атомарно заявите готовую задачу. Печатает разрешенный путь к рабочей области.
comment <id> "<text>" Добавить комментарий. Следующий рабочий процесс, заявивший о своей задаче, читает ее как часть своего ответа kanban_show().
complete <id> Отметить задачу как выполненную. Флаги: --result, --summary, --metadata.
block <id> "<reason>" Отметить задачу как заблокированную. Также добавляет причину в виде комментария.
unblock <id> Верните заблокированную задачу в состояние готовности.
archive <id> Скрыть из списка по умолчанию. gc удалит рабочие области.
tail <id> Следите за потоком событий задачи.
dispatch На активном табло проходит один диспетчер. Флаги: --dry-run, --max N, --json.
context <id> Распечатайте полный контекст, который увидит работник (заголовок + текст + родительские результаты + комментарии).
gc Удалите временные рабочие области для заархивированных задач.

Примеры:

# Create a second board and put a task on it without switching away.
hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
hermes kanban --board atm10-server create "Restart server" --assignee ops

# Switch the active board for subsequent calls.
hermes kanban boards switch atm10-server
hermes kanban list                  # shows atm10-server tasks

# Archive a board (recoverable) or hard-delete it.
hermes kanban boards rm atm10-server
hermes kanban boards rm atm10-server --delete

Порядок разрешения платы (сначала наивысший приоритет): флаг --board <slug> → HERMES_KANBAN_BOARD env var → ~/.hermes/kanban/current файл → default.

Все действия также доступны в виде команды с косой чертой в шлюзе (/kanban …) с той же поверхностью аргументов, включая подкоманды boards и флаг --board.

Полный дизайн — сравнение с Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise, восемь шаблонов совместной работы, четыре пользовательские истории, доказательство корректности параллелизма — см. docs/hermes-kanban-v1-spec.pdf в репозитории или руководство пользователя Kanban.

hermes webhook

hermes webhook <subscribe|list|remove|test>

Управляйте динамическими подписками на веб-перехватчики для активации агентов, управляемых событиями. Требуется, чтобы платформа веб-перехватчика была включена в конфигурации — если она не настроена, печатает инструкции по настройке.

Подкоманда Описание
subscribe / add Создайте маршрут вебхука. Возвращает URL-адрес и секрет HMAC для настройки в вашей службе.
list / ls Показать все подписки, созданные агентом.
remove / rm Удалить динамическую подписку. Статические маршруты из config.yaml не затрагиваются.
test Отправьте тестовый POST, чтобы убедиться, что подписка работает.

hermes webhook subscribe

hermes webhook subscribe <name> [options]
Вариант Описание
--prompt Шаблон запроса со ссылками на полезные данные {dot.notation}.
--events Типы событий, разделенные запятыми, которые можно принять (например, issues,pull_request). Пусто = все.
--description Читабельное описание.
--skills Имена навыков, разделенные запятыми, которые необходимо загрузить для запуска агента.
--deliver Цель доставки: log (по умолчанию), telegram, discord, slack, github_comment.
--deliver-chat-id Целевой идентификатор чата/канала для кросс-платформенной доставки.
--secret Пользовательский секрет HMAC. Генерируется автоматически, если опущено.

Подписки сохраняются на ~/.hermes/webhook_subscriptions.json и перезагружаются адаптером веб-перехватчика без перезапуска шлюза.

hermes doctor

hermes doctor [--fix]
Вариант Описание
--fix По возможности попытайтесь выполнить автоматический ремонт.

hermes dump

hermes dump [--show-keys]

Выводит компактную текстовую сводку всей вашей установки Hermes. Предназначен для копирования в Discord, GitHub Issues или Telegram при обращении за поддержкой — без цветов ANSI, без специального форматирования, только данные.

Вариант Описание
--show-keys Показывать отредактированные префиксы ключей API (первые и последние 4 символа) вместо set/not set.

Что это включает в себя

Раздел Подробности
Заголовок Версия Hermes, дата выпуска, хеш git commit
Окружающая среда ОС, версия Python, версия OpenAI SDK
Личность Имя активного профиля, путь HERMES_HOME
Модель Настроенная модель и поставщик по умолчанию
Терминал Тип бэкенда (локальный, докер, ssh и т. д.)
Ключи API Проверка присутствия всех 22 ключей API поставщика/инструмента
Особенности Включенные наборы инструментов, количество серверов MCP, поставщик памяти
Услуги Статус шлюза, настроенные платформы обмена сообщениями
Рабочая нагрузка Количество заданий Cron, количество установленных навыков
Переопределения конфигурации Любые значения конфигурации, отличающиеся от значений по умолчанию

Пример вывода

--- hermes dump ---
version:          0.8.0 (2026.4.8) [af4abd2f]
os:               Linux 6.14.0-37-generic x86_64
python:           3.11.14
openai_sdk:       2.24.0
profile:          default
hermes_home:      ~/.hermes
model:            anthropic/claude-opus-4.6
provider:         openrouter
terminal:         local

api_keys:
  openrouter           set
  openai               not set
  anthropic            set
  nous                 not set
  firecrawl            set
  ...

features:
  toolsets:           all
  mcp_servers:        0
  memory_provider:    built-in
  gateway:            running (systemd)
  platforms:          telegram, discord
  cron_jobs:          3 active / 5 total
  skills:             42

config_overrides:
  agent.max_turns: 250
  compression.threshold: 0.85
  display.streaming: True
--- end dump ---

Когда использовать

:::совет hermes dump специально создан для совместного использования. Для интерактивной диагностики используйте hermes doctor. Для визуального обзора используйте hermes status.

hermes debug

hermes debug share [options]

Загрузите отчет об отладке (информация о системе + последние журналы) в службу вставки и получите общий URL-адрес. Полезно для быстрых запросов в службу поддержки — включает все, что нужно помощнику для диагностики вашей проблемы.

Вариант Описание
--lines <N> Количество строк журнала, включаемых в каждый файл журнала (по умолчанию: 200).
--expire <days> Срок действия вставки в днях (по умолчанию: 7).
--local Распечатайте отчет локально, а не загружайте его.

Отчет включает информацию о системе (ОС, версия Python, версия Hermes), последние журналы агента и шлюза (ограничение 512 КБ на файл) и отредактированный статус ключа API. Ключи всегда редактируются — секреты не загружаются.

Сервисы вставки пробовал по порядку:paste.rs, dpaste.com.

Примеры

hermes debug share              # Upload debug report, print URL
hermes debug share --lines 500  # Include more log lines
hermes debug share --expire 30  # Keep paste for 30 days
hermes debug share --local      # Print report to terminal (no upload)

hermes backup

hermes backup [options]

Создайте zip-архив вашей конфигурации, навыков, сеансов и данных Hermes. Резервная копия исключает саму кодовую базу агента Hermes.

Вариант Описание
-o, --output <path> Выходной путь для zip-файла (по умолчанию: ~/hermes-backup-<timestamp>.zip).
-q, --quick Быстрый снимок: только файлы критического состояния (config.yaml, state.db, .env, задания аутентификации, cron). Гораздо быстрее, чем полное резервное копирование.
-l, --label <name> Метка снимка (используется только с --quick).

Резервное копирование использует backup() API SQLite для безопасного копирования, поэтому оно работает правильно, даже когда Hermes работает (безопасный режим WAL).

Что исключено из архива:

Примеры

hermes backup                           # Full backup to ~/hermes-backup-*.zip
hermes backup -o /tmp/hermes.zip        # Full backup to specific path
hermes backup --quick                   # Quick state-only snapshot
hermes backup --quick --label "pre-upgrade"  # Quick snapshot with label

hermes import

hermes import <zipfile> [options]

Восстановите ранее созданную резервную копию Hermes в свой домашний каталог Hermes.

Вариант Описание
-f, --force Перезаписать существующие файлы без подтверждения.

hermes logs

hermes logs [log_name] [options]

Просматривайте, отслеживайте и фильтруйте файлы журналов Hermes. Все журналы хранятся в ~/.hermes/logs/ (или <profile>/logs/ для профилей не по умолчанию).

Файлы журналов

Имя Файл Что он фиксирует
agent (по умолчанию) agent.log Вся деятельность агента — вызовы API, отправка инструментов, жизненный цикл сеанса (INFO и выше)
errors errors.log Только предупреждения и ошибки — отфильтрованное подмножество Agent.log
gateway gateway.log Активность шлюза обмена сообщениями — подключения к платформе, отправка сообщений, события веб-перехватчика

Опции

Вариант Описание
log_name Какой журнал просматривать: agent (по умолчанию), errors, gateway или list, чтобы показать доступные файлы с указанием размеров.
-n, --lines <N> Количество отображаемых строк (по умолчанию: 50).
-f, --follow Следите за журналом в режиме реального времени, например tail -f. Нажмите Ctrl+C, чтобы остановить.
--level <LEVEL> Минимальный уровень журнала для отображения: DEBUG, INFO, WARNING, ERROR, CRITICAL.
--session <ID> Фильтровать строки, содержащие подстроку идентификатора сеанса.
--since <TIME> Показывать строки, относящиеся к относительному времени назад: 30m, 1h, 2d и т. д. Поддерживается s (секунды), m (минуты), h (часы), d (дни).
--component <NAME> Фильтровать по компонентам: gateway, agent, tools, cli, cron.

Примеры

# View the last 50 lines of agent.log (default)
hermes logs

# Follow agent.log in real time
hermes logs -f

# View the last 100 lines of gateway.log
hermes logs gateway -n 100

# Show only warnings and errors from the last hour
hermes logs --level WARNING --since 1h

# Filter by a specific session
hermes logs --session abc123

# Follow errors.log, starting from 30 minutes ago
hermes logs errors --since 30m -f

# List all log files with their sizes
hermes logs list

Фильтрация

Фильтры можно комбинировать. Если активно несколько фильтров, для отображения строка журнала должна пройти все из них:

# WARNING+ lines from the last 2 hours containing session "tg-12345"
hermes logs --level WARNING --since 2h --session tg-12345

Строки без анализируемой временной метки включаются, когда --since активен (они могут быть строками продолжения многострочной записи журнала). Линии без обнаруживаемого уровня включаются, когда --level активен.

Ротация журналов

Гермес использует Python RotatingFileHandler. Старые журналы ротируются автоматически — ищите agent.log.1, agent.log.2 и т. д. Подкоманда hermes logs list показывает все файлы журналов, включая ротированные.

hermes config

hermes config <subcommand>

Подкоманды:

Подкоманда Описание
show Показать текущие значения конфигурации.
edit Откройте config.yaml в своем редакторе.
set <key> <value> Установите значение конфигурации.
path Распечатайте путь к файлу конфигурации.
env-path Распечатайте путь к файлу .env.
check Проверьте отсутствующую или устаревшую конфигурацию.
migrate Добавление новых опций в интерактивном режиме.

hermes pairing

hermes pairing <list|approve|revoke|clear-pending>
Подкоманда Описание
list Показать ожидающих и одобренных пользователей.
approve <platform> <code> Подтвердите код сопряжения.
revoke <platform> <user-id> Отменить доступ пользователя.
clear-pending Очистите ожидающие коды сопряжения.

hermes skills

hermes skills <subcommand>

Подкоманды:

Подкоманда Описание
browse Постраничный браузер для реестров навыков.
search Поиск реестров навыков.
install Установите навык.
inspect Предварительный просмотр навыка без его установки.
list Перечислите установленные навыки.
check Проверьте установленные навыки концентратора на предмет обновлений исходной версии.
update Переустановите навыки концентратора с изменениями, внесенными в исходную версию, если они доступны.
audit Повторное сканирование установленных навыков хаба.
uninstall Удаление навыка, установленного в хабе.
publish Опубликовать навык в реестре.
snapshot Экспорт/импорт конфигураций навыков.
tap Управляйте пользовательскими источниками навыков.
config Интерактивная настройка включения/выключения навыков в зависимости от платформы.

Распространенные примеры:

hermes skills browse
hermes skills browse --source official
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect official/security/1password
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react
hermes skills install official/migration/openclaw-migration
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills install https://sharethis.chat/SKILL.md                     # Direct URL (single-file SKILL.md)
hermes skills install https://example.com/SKILL.md --name my-skill        # Override name when frontmatter has none
hermes skills check
hermes skills update
hermes skills config

Примечания: - --force может отменять неопасные блокировки политики для сторонних/общественных навыков. - --force не отменяет вердикт сканирования dangerous. - --source skills-sh выполняет поиск в общедоступном каталоге skills.sh. - --source well-known позволяет указать Гермесу сайт, разоблачающий /.well-known/skills/index.json. - При передаче URL-адреса http(s)://…/*.md устанавливается один файл SKILL.md напрямую. Если во вступительной части нет name: и фрагмент URL-адреса не является допустимым идентификатором, интерактивный терминал запрашивает имя; неинтерактивные поверхности (/skills install внутри TUI, шлюзовые платформы) вместо этого требуют --name <x>.

hermes curator

hermes curator <subcommand>

Куратор — это фоновая задача вспомогательной модели, которая периодически проверяет навыки, созданные агентом, удаляет устаревшие, объединяет дублирующиеся навыки и архивирует устаревшие навыки. Навыки, включенные в комплект и установленные в хабе, никогда не затрагиваются. Архивы подлежат восстановлению; автоудаление никогда не происходит.

Подкоманда Описание
status Показать статус куратора и статистику навыков
run Запустить кураторскую проверку прямо сейчас
run --sync Блокировать до завершения прохождения LLM
run --dry-run Только предварительный просмотр — создание отчета о проверке без изменений
backup Сделайте вручную снимок tar.gz ~/.hermes/skills/ (куратор также делает снимки автоматически перед каждым реальным запуском)
rollback Восстановить ~/.hermes/skills/ из снимка (по умолчанию — самый новый)
rollback --list Список доступных снимков
rollback --id <ts> Восстановить конкретный снимок по id
rollback -y Пропустить запрос подтверждения
pause Приостановить работу куратора до возобновления
resume Резюме приостановленного куратора
pin <skill> Закрепите навык, чтобы куратор никогда не переключал его автоматически
unpin <skill> Открепить навык
restore <skill> Восстановить заархивированный навык

При новой установке первый запланированный проход откладывается на один полный interval_hours (по умолчанию 7 дней) — шлюз не будет курироваться сразу после первого тика после hermes update. Используйте hermes curator run --dry-run для предварительного просмотра, прежде чем это произойдет.

См. Куратор для ознакомления с поведением и конфигурацией.

hermes fallback

hermes fallback <subcommand>

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

Подкоманда Описание
list (псевдоним: ls) Показать текущую резервную цепочку (по умолчанию, если нет подкоманды)
add Выберите поставщика + модель (тот же выбор, что и hermes model) и добавьте в цепочку
remove (псевдоним: rm) Выберите запись, которую хотите удалить из цепочки
clear Удалить все резервные записи

См. Резервные поставщики.

hermes hooks

hermes hooks <subcommand>

Проверяйте перехватчики сценариев оболочки, объявленные в ~/.hermes/config.yaml, проверяйте их на соответствие синтетическим полезным нагрузкам и управляйте списком разрешений на первое использование в ~/.hermes/shell-hooks-allowlist.json.

Подкоманда Описание
list (псевдоним: ls) Список настроенных перехватчиков с сопоставлением, тайм-аутом и статусом согласия
test <event> Запустите каждый хук, соответствующий <event>, против синтетической полезной нагрузки
revoke (псевдонимы: remove, rm) Удаление записей белого списка команды (вступает в силу при следующем перезапуске)
doctor Проверьте каждый настроенный перехват: бит exec, список разрешений, отклонение времени mtime, достоверность JSON и синтетическое время выполнения

См. Hooks для сигнатур событий и форм полезных данных.

hermes memory

hermes memory <subcommand>

Настраивайте и управляйте плагинами внешнего поставщика памяти. Доступные провайдеры: honcho, openviking, mem0, Hindsight, Holographic, RetainedB, Byterover, SuperMemory. Одновременно может быть активен только один внешний провайдер. Встроенная память (MEMORY.md/USER.md) всегда активна.

Подкоманды:

Подкоманда Описание
setup Интерактивный выбор и настройка провайдера.
status Показать текущую конфигурацию поставщика памяти.
off Отключить внешнего провайдера (только встроенный).

ℹ️ Info

Подкоманды, специфичные для поставщика Когда внешний поставщик памяти активен, он может зарегистрировать свою собственную команду верхнего уровня `hermes ` для управления, зависящего от поставщика (например, `hermes honcho`, когда Honcho активен). Неактивные поставщики не раскрывают свои подкоманды. Запустите `hermes --help`, чтобы узнать, что сейчас подключено.

hermes acp

hermes acp

Запускает Hermes как stdio-сервер ACP (Agent Client Protocol) для интеграции редактора.

Связанные точки входа:

hermes-acp
python -m acp_adapter

Сначала установите поддержку:

pip install -e '.[acp]'

См. Интеграция редактора ACP и Внутренние компоненты ACP.

hermes mcp

hermes mcp <subcommand>

Управляйте конфигурациями сервера MCP (Model Context Protocol) и запускайте Hermes в качестве сервера MCP.

Подкоманда Описание
serve [-v\|--verbose] Запустите Hermes в качестве сервера MCP — откройте доступ к разговорам другим агентам.
add <name> [--url URL] [--command CMD] [--args ...] [--auth oauth\|header] Добавьте сервер MCP с автоматическим обнаружением инструментов.
remove <name> (псевдоним: rm) Удалите сервер MCP из конфигурации.
list (псевдоним: ls) Список настроенных серверов MCP.
test <name> Проверьте подключение к серверу MCP.
configure <name> (псевдоним: config) Переключить выбор инструментов для сервера.

См. Справочник по конфигурации MCP, Использование MCP с Hermes и Режим сервера MCP.

hermes plugins

hermes plugins [subcommand]

Унифицированное управление плагинами — общие плагины, поставщики памяти и контекстные механизмы в одном месте. Запуск hermes plugins без подкоманды открывает составной интерактивный экран с двумя разделами:

Подкоманда Описание
(нет) Составной интерактивный пользовательский интерфейс — общие переключатели плагинов + настройка плагина провайдера.
install <identifier> [--force] Установите плагин по URL-адресу Git или owner/repo.
update <name> Извлеките последние изменения для установленного плагина.
remove <name> (псевдонимы: rm, uninstall) Удалить установленный плагин.
enable <name> Включите отключенный плагин.
disable <name> Отключите плагин, не удаляя его.
list (псевдоним: ls) Список установленных плагинов с включенным/отключенным статусом.

Выбор плагина провайдера сохраняется в config.yaml: - memory.provider — поставщик активной памяти (пусто = только встроенная) - context.engine — механизм активного контекста ("compressor" = встроенный по умолчанию)

Общий список отключенных плагинов хранится в config.yaml под plugins.disabled.

См. Плагины и Создание плагина Hermes.

hermes tools

hermes tools [--summary]
Вариант Описание
--summary Распечатайте текущую сводку включенных инструментов и выйдите.

Без --summary запускается интерактивный пользовательский интерфейс настройки инструмента для каждой платформы.

hermes sessions

hermes sessions <subcommand>

Подкоманды:

Подкоманда Описание
list Перечислите последние сеансы.
browse Интерактивный выбор сеансов с поиском и возобновлением.
export <output> [--session-id ID] Экспортируйте сеансы в JSONL.
delete <session-id> Удалить одну сессию.
prune Удалите старые сеансы.
stats Показать статистику хранилища сеансов.
rename <session-id> <title> Установите или измените заголовок сеанса.

hermes insights

hermes insights [--days N] [--source platform]
Вариант Описание
--days <n> Анализируйте последние n дней (по умолчанию: 30).
--source <platform> Фильтруйте по источнику, например cli, telegram или discord.

hermes claw

hermes claw migrate [options]

Перенесите настройки OpenClaw в Hermes. Чтение из ~/.openclaw (или пользовательского пути) и запись в ~/.hermes. Автоматически определяет устаревшие имена каталогов (~/.clawdbot, ~/.moltbot) и имена файлов конфигурации (clawdbot.json, moltbot.json).

Вариант Описание
--dry-run Предварительный просмотр того, что будет перенесено, ничего не записывая.
--preset <name> Предварительная настройка миграции: full (все совместимые настройки) или user-data (исключая конфигурацию инфраструктуры). Ни одна из предустановок не импортирует секреты — передайте --migrate-secrets явно.
--overwrite Перезаписать существующие файлы Hermes при конфликтах (по умолчанию: отказаться от применения, если в плане есть конфликты).
--migrate-secrets Включите ключи API в миграцию. Требуется даже под --preset full.
--no-backup Пропустите zip-снимок ~/.hermes/ перед переносом (по умолчанию перед применением в ~/.hermes/backups/pre-migration-*.zip записывается один архив с точкой восстановления; его можно восстановить с помощью hermes import).
--source <path> Пользовательский каталог OpenClaw (по умолчанию: ~/.openclaw).
--workspace-target <path> Целевой каталог для инструкций рабочей области (AGENTS.md).
--skill-conflict <mode> Обработка конфликтов имен навыков: skip (по умолчанию), overwrite или rename.
--yes Пропустите запрос подтверждения.

Что будет перенесено

Миграция охватывает более 30 категорий личности, памяти, навыков, поставщиков моделей, платформ обмена сообщениями, поведения агентов, политик сеансов, серверов MCP, TTS и многого другого. Элементы либо напрямую импортируются в эквиваленты Hermes, либо архивируются** для проверки вручную.

Непосредственно импортированы: SOUL.md, MEMORY.md, USER.md, AGENTS.md, навыки (4 исходных каталога), модель по умолчанию, пользовательские поставщики, серверы MCP, токены платформы обмена сообщениями и списки разрешений (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), настройки агента по умолчанию (обоснование, сжатие, человеческая задержка, часовой пояс, песочница), политики сброса сеанса, правила утверждения, TTS config, настройки браузера, настройки инструментов, тайм-аут выполнения, список разрешенных команд, конфигурация шлюза и ключи API из 3 источников.

Архивировано для проверки вручную: задания Cron, плагины, перехватчики/веб-перехватчики, серверная часть памяти (QMD), конфигурация реестра навыков, пользовательский интерфейс/идентификация, ведение журнала, настройка нескольких агентов, привязки каналов, IDENTITY.md, Tools.md, HEARTBEAT.md, BOOTSTRAP.md.

Разрешение ключа API проверяет три источника в порядке приоритета: значения конфигурации → ~/.openclaw/.env → auth-profiles.json. Все поля токенов обрабатывают простые строки, шаблоны env (${VAR}) и объекты SecretRef.

Полное сопоставление ключей конфигурации, подробности обработки SecretRef и контрольный список после миграции см. в полном руководстве по миграции.

Примеры

# Preview what would be migrated
hermes claw migrate --dry-run

# Full migration (all compatible settings, no secrets)
hermes claw migrate --preset full

# Full migration including API keys
hermes claw migrate --preset full --migrate-secrets

# Migrate user data only (no secrets), overwrite conflicts
hermes claw migrate --preset user-data --overwrite

# Migrate from a custom OpenClaw path
hermes claw migrate --source /home/user/old-openclaw

hermes dashboard

hermes dashboard [options]

Запустите веб-панель — пользовательский интерфейс на основе браузера для управления конфигурацией, ключами API и мониторингом сеансов. Требуется pip install hermes-agent[web] (FastAPI + Uvicorn). Полную документацию см. в Веб-панели.

Вариант По умолчанию Описание
--port 9119 Порт для запуска веб-сервера
--host 127.0.0.1 Привязать адрес
--no-open — Не открывать браузер автоматически 
# Default — opens browser to http://127.0.0.1:9119
hermes dashboard

# Custom port, no browser
hermes dashboard --port 8080 --no-open

hermes profile

hermes profile <subcommand>

Управление профилями — несколько изолированных экземпляров Hermes, каждый со своей собственной конфигурацией, сеансами, навыками и домашним каталогом.

Подкоманда Описание
list Перечислите все профили.
use <name> Установите закрепленный профиль по умолчанию.
create <name> [--clone] [--clone-all] [--clone-from <source>] [--no-alias] Создайте новый профиль. --clone копирует конфигурацию .env и SOUL.md из активного профиля. --clone-all копирует все состояние. --clone-from указывает исходный профиль.
delete <name> [-y] Удалить профиль.
show <name> Показать детали профиля (домашний каталог, конфигурация и т. д.).
alias <name> [--remove] [--name NAME] Управляйте сценариями-оболочками для быстрого доступа к профилю.
rename <old> <new> Переименуйте профиль.
export <name> [-o FILE] Экспортируйте профиль в архив .tar.gz.
import <archive> [--name NAME] Импортируйте профиль из архива .tar.gz.

Примеры:

hermes profile list
hermes profile create work --clone
hermes profile use work
hermes profile alias work --name h-work
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"

hermes completion

hermes completion [bash|zsh|fish]

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

Примеры:

# Bash
hermes completion bash >> ~/.bashrc

# Zsh
hermes completion zsh >> ~/.zshrc

# Fish
hermes completion fish > ~/.config/fish/completions/hermes.fish

hermes update

hermes update [--check] [--backup] [--restart-gateway]

Извлекает последний код hermes-agent и переустанавливает зависимости в вашем venv, затем повторно запускает перехватчики после установки (серверы MCP, синхронизация навыков, завершение установки). Безопасно работать при живой установке.

Вариант Описание
--check Распечатайте текущий коммит и последний коммит origin/main рядом и выйдите из 0, если синхронизированы, или 1, если они отстают. Ничего не тянет, не устанавливает и не перезапускает.
--backup Перед извлечением создайте помеченный снимок HERMES_HOME перед обновлением (конфигурация, аутентификация, сеансы, навыки, данные сопряжения). По умолчанию установлено значение выключено. Раньше при постоянном резервном копировании добавлялись минуты к каждому обновлению в больших домах. Включите его навсегда через update.backup: true в config.yaml.
--restart-gateway После успешного обновления перезапустите работающую службу шлюза. Подразумевает семантику --all, если установлено несколько профилей.

Дополнительное поведение:

hermes fallback

hermes fallback           # interactive manager

Управляйте цепочкой резервных поставщиков (используется, когда ваш основной поставщик достигает ограничения скорости или возвращает фатальную ошибку) без ручного редактирования config.yaml. Повторно использует средство выбора поставщика из hermes model — тот же список поставщиков, те же запросы учетных данных, та же проверка.

Типичная сессия:

  1. Нажмите a, чтобы добавить резервный вариант → выберите поставщика (поставщики на основе OAuth открывают браузер; поставщики ключей API запрашивают ключ), затем выберите конкретную модель.
  2. Используйте ↑/↓, чтобы изменить порядок резервных вариантов (в первую очередь проверяется первый в списке).
  3. Нажмите d, чтобы удалить его.

Все изменения сохраняются в fallback_providers: под model: в config.yaml. Взаимодействует с пулами учетных данных: пулы меняют ключи внутри поставщика, резервные варианты полностью переключаются на другого поставщика.

См. Резервные поставщики для получения подробной информации о поведении и взаимодействии с fallback_model (устаревший одинарный резервный ключ).

Команды обслуживания

Команда Описание
hermes version Информация о версии для печати.
hermes update Извлеките последние изменения и переустановите зависимости.
hermes uninstall [--full] [--yes] Удалите Hermes, при необходимости удалив все настройки/данные.

См. также