🏠 Главная › Документация › Справочник

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

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

Для команд внутри чата (slash-commands) см. Справочник Slash-команд.

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

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

Глобальные опции

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

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

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

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, lmstudio, stepfun, tencent-tokenhub (алиас tencent, tokenhub).
-s, --skills <name> Предзагрузить один или несколько навыков для сессии (можно повторять или разделять запятыми).
-v, --verbose Подробный вывод.
-Q, --quiet Программный режим: подавить баннер/спиннер/предпросмотр инструментов.
--image <path> Прикрепить локальное изображение к одному запросу.
--resume <session> / --continue [name] Возобновить сессию напрямую из chat.
--worktree Создать изолированный git worktree для этого запуска.
--checkpoints Включить файловые контрольные точки перед деструктивными изменениями файлов.
--yolo Пропустить запросы подтверждения.
--pass-session-id Передать 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> — сценарный одноразовый запрос

Для программных вызывающих (shell-скрипты, CI, cron, родительские процессы, передающие запрос через pipe), hermes -z — самая чистая точка входа для одноразовых запросов: один запрос на входе, текст ответа на выходе, ничего лишнего в stdout или stderr. Ни баннера, ни спиннера, ни предпросмотра инструментов, ни строки 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

Используйте эту команду, когда хотите:

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

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

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

/model — slash-команда (внутри сессии)

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

/model                              # Показать текущую модель и доступные варианты
/model claude-sonnet-4              # Переключить модель (автоопределение провайдера)
/model zai:glm-5                    # Переключить провайдера и модель
/model custom:qwen-2.5              # Использовать модель на пользовательской конечной точке
/model custom                       # Автоопределение модели с пользовательской конечной точки
/model custom:local:qwen-2.5        # Использовать именованного пользовательского провайдера
/model openrouter:anthropic/claude-sonnet-4  # Вернуться к облачной модели

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

/model claude-sonnet-4 --global     # Переключить и сохранить как новое значение по умолчанию

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.

tip Пользователям WSL Используйте hermes gateway run вместо hermes gateway start — поддержка systemd в WSL ненадёжна. Оберните в tmux для сохранения: tmux new -s hermes 'hermes gateway run'. См. WSL FAQ для подробностей.

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              # вывести манифест в stdout
hermes slack manifest --write      # записать в ~/.hermes/slack-manifest.json
hermes slack manifest --slashes-only  # только массив features.slash_commands

Генерирует манифест приложения Slack, который регистрирует каждую команду шлюза из COMMAND_REGISTRY (/btw, /stop, /model, …) как первоклассную Slack slash-команду — обеспечивая паритет с Discord и Telegram. Вставьте вывод в конфигурацию вашего приложения Slack на https://api.slack.com/apps → ваше приложение → Features → App Manifest → Edit, затем Save. Slack запросит переустановку, если изменились области видимости или slash-команды.

Флаг По умолчанию Назначение
--write [PATH] stdout Записать в файл вместо stdout. Без аргумента --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                                              # Интерактивный мастер
hermes auth list                                         # Показать все пулы
hermes auth list openrouter                              # Показать конкретного провайдера
hermes auth add openrouter --api-key sk-or-v1-xxx        # Добавить API-ключ
hermes auth add anthropic --type oauth                   # Добавить OAuth-учётные данные
hermes auth remove openrouter 2                          # Удалить по индексу
hermes auth reset openrouter                             # Очистить задержки
hermes auth status anthropic                             # Показать статус аутентификации для провайдера
hermes auth logout anthropic                             # Выйти и очистить сохранённое состояние аутентификации
hermes auth spotify                                      # Аутентифицировать Hermes в Spotify через PKCE

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

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 или 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 (сделать активной). Slug в kebab-case, автоматически в нижний регистр.
boards switch <slug> / boards use Сохранить <slug> как активную доску (записывает в ~/.hermes/kanban/current).
boards show / boards current Вывести имя, путь к БД и количество задач текущей активной доски.
boards rename <slug> "<name>" Изменить отображаемое имя доски. Slug неизменяем.
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 удалит scratch-рабочие области.
tail <id> Отслеживать поток событий задачи.
dispatch Один проход диспетчера по активной доске. Флаги: --dry-run, --max N, --json.
context <id> Вывести полный контекст, который увидит работник (название + тело + результаты родительских задач + комментарии).
specify <id> / specify --all Преобразовать задачу из колонки triage в конкретную спецификацию (название + тело с целью, подходом, критериями приёмки) через вспомогательный LLM, затем переместить её в todo. Флаги: --tenant (ограничить --all одним тенантом), --author, --json. Настройте модель в auxiliary.triage_specifier в config.yaml.
gc Удалить scratch-рабочие области для архивированных задач.

Примеры:

# Создать вторую доску и поместить задачу без переключения
hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
hermes kanban --board atm10-server create "Restart server" --assignee ops

# Переключить активную доску для последующих вызовов
hermes kanban boards switch atm10-server
hermes kanban list                  # показывает задачи atm10-server

# Архивировать доску (восстанавливаемо) или жёстко удалить
hermes kanban boards rm atm10-server
hermes kanban boards rm atm10-server --delete

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

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

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

hermes webhook

hermes webhook <subscribe|list|remove|test>

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

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

hermes webhook subscribe

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

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

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-коммита
Окружение ОС, версия Python, версия OpenAI SDK
Идентификация Имя активного профиля, путь HERMES_HOME
Модель Настроенная модель и провайдер по умолчанию
Терминал Тип бэкенда (local, docker, 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]

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

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

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

Paste-сервисы используются в порядке: paste.rs, dpaste.com.

Примеры

hermes debug share              # Загрузить отладочный отчёт, вывести URL
hermes debug share --lines 500  # Включить больше строк лога
hermes debug share --expire 30  # Хранить paste 30 дней
hermes debug share --local      # Вывести отчёт в терминал (без загрузки)

hermes backup

hermes backup [options]

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

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

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

Что исключено из zip:

Примеры

hermes backup                           # Полная копия в ~/hermes-backup-*.zip
hermes backup -o /tmp/hermes.zip        # Полная копия в указанный путь
hermes backup --quick                   # Быстрый снимок только состояния
hermes backup --quick --label "pre-upgrade"  # Быстрый снимок с меткой

hermes checkpoints

hermes checkpoints [COMMAND]

Просмотр и управление теневым git-хранилищем в ~/.hermes/checkpoints/ — слоем хранения, стоящим за командой /rollback в сессии. Безопасно запускать в любое время; не требует запущенного агента.

Подкоманда Описание
status (по умолчанию) Показать общий размер, количество проектов и разбивку по проектам. Просто hermes checkpoints эквивалентно.
list Алиас для status.
prune Принудительная очистка — удаление потерянных и устаревших проектов, GC хранилища, применение лимита размера. Игнорирует 24-часовой маркер идемпотентности.
clear Удалить всю базу контрольных точек. Необратимо; запрашивает подтверждение, если не указан -f.
clear-legacy Удалить только архивы legacy-<timestamp>/, созданные миграцией v1→v2.

Опции

Опция Подкоманда Описание
--limit N status, list Максимум проектов для отображения (по умолчанию 20).
--retention-days N prune Удалять проекты, чей last_touch старше N дней (по умолчанию 7).
--max-size-mb N prune После этапа очистки удалять самые старые коммиты в каждом проекте, пока общий размер хранилища не станет ≤ N МБ (по умолчанию 500).
--keep-orphans prune Не удалять проекты, чья рабочая директория больше не существует.
-f, --force clear, clear-legacy Пропустить запрос подтверждения.

Примеры

hermes checkpoints                                  # Обзор состояния
hermes checkpoints prune --retention-days 3         # Агрессивная очистка
hermes checkpoints prune --max-size-mb 200          # Ужесточить лимит размера
hermes checkpoints clear-legacy -f                  # Удалить архивы v1
hermes checkpoints clear -f                         # Удалить всё

См. Контрольные точки и /rollback для полной архитектуры и команд внутри сессии.

hermes import

hermes import <zipfile> [options]

Восстановить ранее созданную резервную копию Hermes в ваш домашний каталог Hermes. Все файлы в архиве перезаписывают существующие файлы; --force пропускает запрос подтверждения, который появляется, если в целевой директории уже есть установка Hermes.

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

Примеры

hermes import ~/hermes-backup-20260423.zip           # Запрос перед перезаписью
hermes import ~/hermes-backup-20260423.zip --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 Активность шлюза обмена сообщениями — подключения платформ, отправка сообщений, события webhook

Опции

Опция Описание
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> Фильтр строк, содержащих подстроку ID сессии.
--since <TIME> Показать строки с указанного относительного времени: 30m, 1h, 2d и т.д. Поддерживает s (секунды), m (минуты), h (часы), d (дни).
--component <NAME> Фильтр по компоненту: gateway, agent, tools, cli, cron.

Примеры

# Просмотр последних 50 строк agent.log (по умолчанию)
hermes logs

# Отслеживание agent.log в реальном времени
hermes logs -f

# Просмотр последних 100 строк gateway.log
hermes logs gateway -n 100

# Показать только предупреждения и ошибки за последний час
hermes logs --level WARNING --since 1h

# Фильтр по конкретной сессии
hermes logs --session abc123

# Отслеживать errors.log, начиная с 30 минут назад
hermes logs errors --since 30m -f

# Список всех файлов логов с размерами
hermes logs list

Фильтрация

Фильтры можно комбинировать. Когда активно несколько фильтров, строка лога должна пройти все фильтры, чтобы быть показанной:

# WARNING+ строки за последние 2 часа, содержащие сессию "tg-12345"
hermes logs --level WARNING --since 2h --session tg-12345

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

Ротация логов

Hermes использует 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 Удалить навык, установленный из хаба.
reset Снять пометку user_modified с встроенного навыка, очистив его запись в манифесте. С --restore также заменяет пользовательскую копию встроенной версией.
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                     # Прямой URL (однофайловый SKILL.md)
hermes skills install https://example.com/SKILL.md --name my-skill        # Переопределить имя, если в frontmatter его нет
hermes skills check
hermes skills update
hermes skills config
hermes skills reset google-workspace
hermes skills reset google-workspace --restore --yes

Примечания:

hermes curator

hermes curator <subcommand>

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

Подкоманда Описание
status Показать статус куратора и статистику навыков
run Запустить проверку куратора сейчас (блокируется до завершения прохода LLM)
run --background Запустить проход 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> Восстановить архивированный навык
archive <skill> Архивировать навык вручную
prune Вручную удалить навыки, которые куратор обычно очищает
list-archived Список архивированных навыков (восстанавливаются через restore)

На новой установке первый запланированный проход откладывается на полный 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>

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

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

См. Хуки для сигнатур событий и форм payload.

hermes memory

hermes memory <subcommand>

Настройка и управление плагинами внешнего провайдера памяти. Доступные провайдеры: honcho, openviking, mem0, hindsight, holographic, retaindb, byterover, supermemory. Одновременно может быть активен только один внешний провайдер. Встроенная память (MEMORY.md/USER.md) всегда активна.

Подкоманды:

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

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

hermes acp

hermes acp

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

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

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) Переключить выбор инструментов для сервера.
login <name> Принудительная повторная аутентификация для OAuth-основанного MCP-сервера.

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

hermes plugins

hermes plugins [subcommand]

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

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

Выбор плагинов-провайдеров сохраняется в config.yaml:

Список отключённых обычных плагинов хранится в config.yaml в plugins.disabled.

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

hermes tools

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

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

hermes computer-use

hermes computer-use <subcommand>

Подкоманды:

Подкоманда Описание
install Запустить установщик cua-driver (только macOS).
status Вывести, находится ли cua-driver в $PATH.

hermes computer-use install — стабильная точка входа для установки cua-driver, используемого набором инструментов computer_use. Он запускает тот же установщик, что и hermes tools при первом включении Computer Use, так что его безопасно использовать для повторного запуска установки, если переключатель набора инструментов не сработал (например, при настройках возвращающихся пользователей).

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, настройки браузера, настройки инструментов, таймаут выполнения, белый список команд, конфигурация шлюза и API-ключи из 3 источников.

Архивируются для ручного просмотра: Задания cron, плагины, хуки/webhook, бэкенд памяти (QMD), конфигурация реестра навыков, UI/идентификация, логирование, многопользовательская настройка, привязки каналов, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.

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

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

Примеры

# Предпросмотр того, что будет мигрировано
hermes claw migrate --dry-run

# Полная миграция (все совместимые настройки, без секретов)
hermes claw migrate --preset full

# Полная миграция с API-ключами
hermes claw migrate --preset full --migrate-secrets

# Миграция только пользовательских данных (без секретов), перезапись конфликтов
hermes claw migrate --preset user-data --overwrite

# Миграция из пользовательского пути OpenClaw
hermes claw migrate --source /home/user/old-openclaw

hermes dashboard

hermes dashboard [options]

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

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

# Пользовательский порт, без браузера
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 копирует config, .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 (локальное восстановление).
install <source> [--name N] [--alias] [--force] [-y] Установить дистрибутив профиля из git URL или локального каталога.
update <name> [--force-config] [-y] Повторно загрузить дистрибутив; сохраняет пользовательские данные (память, сессии, аутентификацию).
info <name> Показать манифест дистрибутива профиля (версия, требования, источник).

Примеры:

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 profile install github.com/user/my-distro --alias
hermes profile update work
hermes -p work chat -q "Hello from work profile"

hermes completion

hermes completion [bash|zsh|fish]

Вывести скрипт автодополнения для оболочки в stdout. Добавьте вывод в ваш профиль оболочки для автодополнения команд 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 version Вывести информацию о версии.
hermes update Загрузить последние изменения и переустановить зависимости.
hermes uninstall [--full] [--yes] Удалить Hermes, опционально удалив все конфигурации/данные.

См. также