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

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

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

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

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

Global options

Option Description
--version, -V Show version and exit.
--profile <name>, -p <name> Select which Hermes profile to use for this invocation. Overrides the sticky default set by hermes profile use.
--resume <session>, -r <session> Resume a previous session by ID or title. The keyword latest resumes the most recent session (workspace-scoped, same lookup as -c).
--continue [name], -c [name] Resume the most recent session, or the most recent session matching a title.
--in <dir> Change into <dir> before starting or resuming. Scopes --resume latest / -c lookups to that directory's workspace and keeps the session there (skips the recorded-cwd restore).
--worktree, -w Start in an isolated git worktree for parallel-agent workflows.
--yolo Bypass dangerous-command approval prompts.
--pass-session-id Include the session ID in the agent's system prompt.
--ignore-user-config Ignore ~/.hermes/config.yaml and fall back to built-in defaults. Credentials in .env are still loaded.
--ignore-rules Skip auto-injection of AGENTS.md, SOUL.md, .cursorrules, memory, and preloaded skills.
--tui Launch the TUI instead of the classic CLI. Equivalent to HERMES_TUI=1. Always wins over display.interface.
--cli Force the classic prompt_toolkit REPL. Use this to override display.interface: tui for a single invocation.
--dev With --tui: run the TypeScript sources directly via tsx instead of the prebuilt bundle (for TUI contributors).

Top-level commands

Command Purpose
hermes chat Interactive or one-shot chat with the agent.
hermes model Interactively choose the default provider and model.
hermes moa Configure named Mixture of Agents presets selectable from the model picker.
hermes fallback Manage fallback providers tried when the primary model errors.
hermes gateway Run or manage the messaging gateway service.
hermes proxy Local OpenAI-compatible proxy that attaches OAuth provider credentials. See Subscription Proxy.
hermes egress Outbound credential-injection firewall for remote terminal sandboxes (iron-proxy). Disabled by default. See Egress proxy.
hermes lsp Manage Language Server Protocol integration (semantic diagnostics for write_file/patch).
hermes setup Interactive setup wizard for all or part of the configuration.
hermes whatsapp Configure and pair the WhatsApp bridge.
hermes whatsapp-cloud Configure the official Meta WhatsApp Business Cloud API adapter (Business account + public webhook required). Distinct from hermes whatsapp (Baileys personal-account bridge).
hermes slack Slack helpers (currently: generate the app manifest with every command as a native slash).
hermes auth Manage credentials — add, list, remove, reset, status, logout. Handles OAuth flows for Codex/Nous/Anthropic.
hermes login / logout Deprecated — use hermes auth instead.
hermes send Send a one-shot message to a configured messaging platform (Telegram, Discord, Slack, Signal, SMS, …). Useful from shell scripts, cron jobs, CI hooks, and monitoring daemons — no agent loop, no LLM.
hermes secrets Manage external secret sources (currently Bitwarden Secrets Manager) for pulling API keys at process startup instead of from ~/.hermes/.env.
hermes migrate Diagnose and (optionally) rewrite config.yaml to replace references to retired models or deprecated settings (e.g. migrate xai).
hermes status Show agent, auth, and platform status.
hermes cron Inspect and tick the cron scheduler.
hermes kanban Multi-profile collaboration board (tasks, links, dispatcher).
hermes project Manage named, multi-folder workspaces (projects). Anchors desktop session grouping and, when bound to a kanban board, gives tasks a deterministic worktree + branch convention. State is per-profile.
hermes webhook Manage dynamic webhook subscriptions for event-driven activation.
hermes hooks Inspect, approve, or remove shell-script hooks declared in config.yaml.
hermes doctor Diagnose config and dependency issues.
hermes security audit On-demand supply-chain audit (OSV.dev) for the venv, plugin requirements, and pinned MCP servers.
hermes approvals Approval-prompt tools — mine approval history into allowlist proposals.
hermes dump Copy-pasteable setup summary for support/debugging.
hermes prompt-size Show a byte breakdown of the system prompt + tool schemas (skills index, memory, profile). Runs offline.
hermes debug Debug tools — upload logs and system info for support.
hermes backup Back up Hermes home directory to a zip file.
hermes checkpoints Inspect / prune / clear ~/.hermes/checkpoints/ (the shadow store used by /rollback). Run with no args for a status overview.
hermes import Restore a Hermes backup from a zip file.
hermes logs View, tail, and filter agent/gateway/error log files.
hermes config Show, edit, migrate, and query configuration files.
hermes skin List, switch, and tweak display skins.
hermes console Open the safe Hermes command console.
hermes pairing Approve or revoke messaging pairing codes.
hermes skills Browse, install, publish, audit, and configure skills.
hermes bundles Group several skills under a single /<name> slash command. See Skill Bundles.
hermes curator Background skill maintenance — status, run, pause, pin. See Curator.
hermes journey (aliases learning, memory-graph) Timeline of learned skills + memories over time.
hermes memory Configure external memory provider. Plugin-specific subcommands (e.g. hermes honcho) register automatically when their provider is active.
hermes acp Run Hermes as an ACP server for editor integration.
hermes mcp Manage MCP server configurations and run Hermes as an MCP server.
hermes plugins Manage Hermes Agent plugins (install, enable, disable, remove).
hermes portal Nous Portal status, subscription link, and Tool Gateway routing. See Tool Gateway.
hermes tools Configure enabled tools per platform.
hermes computer-use Install or check the Computer Use (cua-driver) backend (macOS/Windows/Linux).
hermes pets Browse, install, and select petdex animated pets shown across the CLI, TUI, and desktop app. Subcommands: list, install, select, show, off, scale, remove, doctor.
hermes sessions Browse, export, prune, rename, and delete sessions.
hermes insights Show token/cost/activity analytics.
hermes claw OpenClaw migration helpers.
hermes import-agent Import a Claude Code (~/.claude) or Codex CLI (~/.codex) setup.
hermes dashboard Launch the web dashboard for managing config, API keys, and sessions.
hermes serve Start the Hermes backend server (headless; powers the desktop app and remote backends).
hermes desktop (alias gui) Build and launch the native Electron desktop app.
hermes profile Manage profiles — multiple isolated Hermes instances.
hermes completion Print shell completion scripts (bash/zsh/fish).
hermes version Show version information.
hermes update Pull latest code and reinstall dependencies. --check previews without installing; --backup takes a pre-pull HERMES_HOME snapshot.
hermes uninstall Remove Hermes from the system.

hermes chat

hermes chat [options]

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

Вариант Описание
-q, --query "..." Однократная неинтерактивная подсказка.
-m, --model <модель> Переопределите модель для этого прогона.
-t, --toolsets <csv> Включите набор наборов инструментов, разделенных запятыми.
--provider <провайдер> Принудительно использовать провайдера: auto, openrouter, nous, openai-codex, copilot-acp, copilot, anthropic, gemini, huggingface, novita (псевдонимы novita-ai, novitaai), openai-api, zai, kimi-coding, kimi-coding-cn, minimax, minimax-cn, minimax-oauth, kilocode, xiaomi, arcee, gmi, upstage (псевдоним solar), alibaba, alibaba-coding-plan (псевдоним alibaba_coding), deepseek, nvidia, ollama-cloud, xai (псевдоним grok), xai-oauth (псевдоним grok-oauth), qwen-oauth, bedrock, opencode-zen, opencode-go, ai-gateway, azure-foundry, lmstudio, stepfun, tencent-tokenhub (псевдоним tencent, tokenhub).
-s, --skills <имя> Предварительно загрузите один или несколько навыков для сеанса (можно повторять или разделять запятыми).
-v, --verbose Подробный вывод.
-Q, --тихо Программный режим: запретить предварительный просмотр баннера/спиннера/инструмента.
--image <путь> Прикрепите локальное изображение к одному запросу.
--resume <сеанс> / --continue [имя] Возобновите сеанс прямо из чата.
--рабочее дерево Создайте изолированное рабочее дерево git для этого запуска.
--контрольные точки Включите контрольные точки файловой системы перед деструктивными изменениями файлов.
--йоло Пропустить запросы на одобрение.
--pass-session-id Передайте идентификатор сеанса в системную подсказку.
--ignore-user-config Игнорируйте ~/.hermes/config.yaml и используйте встроенные значения по умолчанию. Учетные данные в .env все еще загружаются. Полезно для изолированных запусков CI, воспроизводимых отчетов об ошибках и сторонних интеграций.
--игнорировать-правила Пропустить автоматическое внедрение AGENTS.md, SOUL.md, .cursorrules, постоянной памяти и предварительно загруженных навыков. Объедините его с --ignore-user-config для полностью изолированного запуска.
--безопасный-режим Режим устранения неполадок: отключите ВСЕ настройки — пользовательскую конфигурацию, правила/внедрение памяти, плагины, перехватчики оболочки и серверы MCP (подразумевается --ignore-user-config и --ignore-rules). Используйте, чтобы определить, связана ли проблема с вашей настройкой или с самим Гермесом.
--source <тег> Тег источника сеанса для фильтрации (по умолчанию: cli). Используйте «инструмент» для сторонних интеграций, которые не должны отображаться в списках сеансов пользователей.
--max-turns <N> Максимальное количество итераций вызова инструмента за ход разговора (по умолчанию: 500 или «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 chat --safe-mode -q "Is this bug mine or Hermes'?"

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 <модель> HERMES_INFERENCE_MODEL Переопределить модель для этого прогона
--provider <провайдер> (нет) Переопределить поставщика для этого запуска
--usage-file <путь> (нет) Напишите отчет об использовании JSON после запуска (см. ниже)
hermes -z "…" --provider openrouter --model openai/gpt-5.5
# or:
HERMES_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 hermes -z "…"

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

--usage-file — отчет об использовании JSON для конвейеров

hermes -z "…" --usage-file /path/report.json записывает машиночитаемый отчет об использовании после запуска: estimated_cost_usd, input_tokens / output_tokens / cache_read_tokens / cache_write_tokens / reasoning_tokens / total_tokens, api_calls, model, Флаги «provider», «session_id», «service_tier» и «completed» / «failed». Отчет составляется даже в случае сбоя, поэтому пакетные конвейеры всегда могут учитывать расходы. Он не имеет никакого эффекта за пределами -z/--oneshot, и нарушение записи использования никогда не маскирует собственный результат выполнения.

hermes -z "summarize this repo" --usage-file /tmp/usage.json
jq.estimated_cost_usd /tmp/usage.json

модель Гермеса

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

hermes model

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

⚠️ Warning

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

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

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

Команда /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.persist_switch_by_default: true, чтобы сохранить каждый переключатель):

/model claude-sonnet-4 --global     # Switch and save as new default
```<div class="admonition admonition-info"><p class="admonition-title">ℹ️ Info</p> Что делать, если я вижу только модели OpenRouter?
Если вы настроили только OpenRouter, `/model` будет отображать только модели OpenRouter. Чтобы добавить другого провайдера (Anthropic, DeepSeek, Copilot и т. д.), выйдите из сеанса и запустите «модель Hermes» с терминала.</div>
При переключателе `--global` изменения поставщика и базового URL-адреса сохраняются в `config.yaml` вместе с моделью. При переключении с пользовательской конечной точки устаревший базовый URL-адрес очищается, чтобы предотвратить его утечку к другим поставщикам.

## `ворота Гермеса`
```bash
hermes gateway <subcommand>

Подкоманды:

Подкоманда Описание
бежать Запустите шлюз на переднем плане. Рекомендуется для WSL, Docker и Termux.
старт Запустите установленную фоновую службу systemd/launchd.
стоп Остановите службу (или приоритетный процесс).
перезапустить Перезапустите службу.
статус Показать статус услуги.
список Перечислите все профили и укажите, работает ли в данный момент шлюз каждого профиля (с указанием PID, если он доступен). Удобно, когда вы запускаете несколько профилей одновременно и хотите получить единый обзор.
установить Установите как фоновую службу systemd (Linux) или launchd (macOS).
удалить Удалите установленную службу.
настройка Настройка интерактивной платформы обмена сообщениями.
миграционное наследие Удалите устаревшие модули hermes.service, оставшиеся от установок до переименования. Единицы профиля («hermes-gateway-.service») и несвязанные сервисы никогда не затрагиваются. Флаги: --dry-run, -y/--yes.
зарегистрироваться Экспериментально: зарегистрируйте этот шлюз с помощью соединителя ретрансляции и сохраните учетные данные ретранслятора для платформ с поддержкой соединителя. См. Hermes Relay.

Опции:

Вариант Описание
--все При «старте» / «перезапуске» / «остановке»: действуйте на шлюзе каждого профиля, а не только на активном «HERMES_HOME». Полезно, если вы запускаете несколько профилей одновременно и хотите перезапустить их все после «обновления Hermes».
--без надзора При запуске: внутри образа Docker с наложением s6 отключите автоматический контроль и используйте семантику переднего плана до s6 — шлюз запускается как основной процесс контейнера без автоматического перезапуска. Никаких операций за пределами изображения 6-го сезона. Эквивалентно настройке HERMES_GATEWAY_NO_SUPERVISE=1.
--external-supervisor При запуске: объявите, что диспетчер процессов, предоставленный оболочкой, владеет шлюзом переднего плана. Используйте это, когда sudo, env -i или другая оболочка удаляет собственный маркер среды launchd/systemd. Перезапуск чата и обновление возвращаются к этому менеджеру вместо создания отдельной замены.

--external-supervisor — это контракт политики перезапуска: перезапуск в чате или Обновление service-restart завершается со статусом 75, поэтому супервизор оболочки должен перезапустить шлюз после этого ненулевого выхода. Для systemd используйте Restart=on-failure или Restart=always и не включайте 75 в RestartPreventExitStatus; для launchd настройте KeepAlive для перезапуска после неудачные выходы. Без этой политики запрошенный перезапуск покидает шлюз. остановился.

hermes Gateway Enroll принимает --token, --connector-url, --gateway-id и --wake-url. Он обменивается токеном регистрации с соединителем и записывает полученные значения GATEWAY_RELAY_ID, GATEWAY_RELAY_SECRET, GATEWAY_RELAY_DELIVERY_KEY, необязательный GATEWAY_RELAY_URL и (если задан --wake-url) значения GATEWAY_RELAY_WAKE_URL в активный профиль. .env.

💡 Tip

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

гермес лсп

hermes lsp <subcommand>

Управляйте интеграцией протокола языкового сервера. ЛСП работает реально языковые серверы (pyright, gopls,rust-analyzer,...) в фон и передает свою диагностику в проверку после записи используется write_file и patch. Закрыто при обнаружении рабочей области git — LSP запускается только тогда, когда cwd или отредактированный файл находится внутри git. рабочее дерево.

Подкоманды:

Подкоманда Описание
статус Показать состояние службы, настроенные серверы, статус установки.
список Распечатайте реестр поддерживаемых серверов. Передайте --installed-only, чтобы пропустить недостающие.
установить <id> С радостью установите двоичный файл одного сервера.
установить-все Установите каждый сервер по известному рецепту автоматической установки.
перезапустить Уничтожьте запущенные клиенты, чтобы возобновить следующее редактирование.
который <id> Выведите разрешенный двоичный путь для одного сервера.

См. LSP — Семантическая диагностика для получения более подробной информации. полное руководство, поддерживаемые языки и ручки настройки.

настройка Гермеса

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

Самый простой путь: hermes setup --portal — OAuth для входа на Nous Portal и выбор Tool Gateway за один раз.

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

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

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

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

Опции:

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

портал Гермеса

hermes portal [status|open|tools]

Проверьте аутентификацию Nous Portal, маршрутизацию Tool Gateway и перейдите на страницу подписки. Вызов без подкоманды запускает status.

Подкоманда Описание
статус (по умолчанию) Состояние аутентификации портала + сводка маршрутизации Tool Gateway для каждого инструмента. Также отображается, когда подкоманда не указана.
открытый Откройте «portal.nousresearch.com/manage-subscription» в браузере по умолчанию.
инструменты Перечислите всех партнеров Tool Gateway (Firecrawl, FAL, OpenAI TTS, Browser Use, Modal), которые маршрутизируются через Nous.

Для настройки самого шлюза см. Tool Gateway. Чтобы узнать о однократном пути установки, см. hermes setup --portal выше.

гермес WhatsApp

hermes whatsapp

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

гермес слабый

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

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

Флаг По умолчанию Цель
--напишите [ПУТЬ] стандартный вывод Запись в файл вместо стандартного вывода. Пустой --write записывает $HERMES_HOME/slack-manifest.json.
--имя ИМЯ Гермес Отображаемое имя бота в Slack.
--описание DESC аннотация по умолчанию Описание бота отображается в каталоге приложения Slack.
--длинное описание ТЕКСТ не установлен Установите display_information.long_description встроенным (175–4000 символов). Несовместимо с --slashes-only.
--long-description-file PATH не установлен Прочтите длинное описание текстового файла UTF-8, точно сохранив его содержимое. Взаимоисключающие с --long-description и несовместимые с --slashes-only.
--только слеши выключен Выдавайте только features.slash_commands для слияния с манифестом, поддерживаемым вручную.

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

гермес отправить

hermes send --to <target> "message text"
hermes send --to <target> --file <path>
echo "message" | hermes send --to <target>
hermes send --list [platform]

Отправьте одноразовое сообщение на настроенную платформу обмена сообщениями, не запуская цикл агента или шлюза. Повторно использует уже настроенные учетные данные шлюза (~/.hermes/.env + ~/.hermes/config.yaml), поэтому сценарии эксплуатации, задания cron, перехватчики CI и демоны мониторинга могут публиковать обновления статуса без повторной реализации клиента REST каждой платформы.

Для платформ бот-токенов (Telegram, Discord, Slack, Signal, SMS, WhatsApp-CloudAPI) работающий шлюз не требуется — «hermes send» обращается непосредственно к конечной точке REST платформы. Платформам подключаемых модулей, которым требуется постоянный адаптер, по-прежнему требуется работающий шлюз.

Вариант Описание
-t, --to <TARGET> Цель доставки. Форматы: platform (использует домашний канал), platform:chat_id, platform:chat_id:thread_id или platform:#channel-name. Примеры: Telegram, Telegram:-1001234567890, Discord:#ops, Slack:C0123ABCD, Signal:+15551234567.
-f, --file <PATH> Прочитайте тело сообщения из PATH (только текстовые файлы — журналы, отчеты, уценка). Передайте - для принудительного чтения со стандартного ввода. Чтобы отправить изображение или другой двоичный файл, используйте MEDIA: (см. ниже).
-s, --subject <LINE> Добавьте строку темы/заголовка перед телом сообщения.
-l, --list [платформа] Перечислите настроенные цели на всех платформах (или только на данной платформе).
-q, --тихо Подавлять стандартный вывод в случае успеха — полезно в сценариях (полагайтесь только на код выхода).
--json Выдавать необработанный результат JSON вместо удобочитаемого вывода.

Если не указан ни позиционный аргумент message, ни --file, hermes send считывает из стандартного ввода, если это не TTY. Коды выхода: 0 в случае успеха, 1 при доставке/сбое серверной части, 2 при ошибках использования.

Отправка изображений и других медиафайлов

--file предназначен только для текстовых тел. Чтобы доставить изображение, документ, видео или аудиофайл в виде вложения собственной платформы, укажите его в тексте сообщения с помощью директивы MEDIA::

hermes send --to telegram "MEDIA:/tmp/screenshot.png"
hermes send --to telegram "Build chart for today MEDIA:/tmp/chart.png"   # with caption
hermes send --to discord:#ops "MEDIA:/tmp/report.pdf"

По умолчанию файлы изображений отправляются в виде фотографий (такие платформы, как Telegram, повторно сжимают их). Добавьте [[as_document]] в сообщение, чтобы доставить его в виде несжатых вложенных файлов:

hermes send --to telegram "[[as_document]] MEDIA:/tmp/screenshot.png"

Примеры:

hermes send --to telegram "deploy finished"
echo "RAM 92%" | hermes send --to telegram:-1001234567890
hermes send --to discord:#ops --file /tmp/report.md
hermes send --to slack:#eng --subject "[CI]" --file build.log
hermes send --list                  # all platforms
hermes send --list telegram         # filter by platform

секреты Гермеса

hermes secrets bitwarden <subcommand>
hermes secrets bw <subcommand>          # short alias

Извлекайте ключи API из внешнего диспетчера секретов при запуске процесса вместо того, чтобы сохранять их в ~/.hermes/.env. В настоящее время поддерживает Bitwarden Secrets Manager. См. полное руководство: Интеграция Bitwarden.

Подкоманды bitwarden (псевдоним bw):

Подкоманда Описание
настройка Интерактивный мастер: установите закрепленный двоичный файл bws, сохраните токен доступа и выберите проект. Принимает --project-id, --access-token и --server-url для неинтерактивного использования.
статус Показать текущую конфигурацию, двоичный путь/версию и статус проверки токена.
жетон Ротация токена доступа: проверяет новый токен на соответствие Bitwarden перед сохранением его в .env (отклоненный токен ничего не меняет). Принимает --access-tokenдля неинтерактивного использования и--no-verify` для пропуска проверки.
синхронизировать Получите секреты сейчас и сообщите, что изменилось. Добавьте --apply, чтобы фактически экспортировать секреты в среду текущей оболочки (по умолчанию — пробный запуск).
установить Загрузите и проверьте прикрепленный двоичный файл bws. --force выполняет повторную загрузку, даже если управляемая копия уже существует.
отключить Отключите интеграцию Bitwarden.

гермес мигрирует

hermes migrate <type>

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

Подкоманда Описание
ксай Отсканируйте config.yaml на предмет ссылок на модели xAI, которые планируется прекратить 15 мая 2026 года, и (с помощью --apply) перепишите их на место в официальные замены в соответствии с руководством по миграции xAI. По умолчанию используется сухой прогон.

Общие флаги для подкоманд миграции:

Флаг Описание
--применить Перепишите config.yaml на месте (по умолчанию: пробный запуск, без записи).
--no-backup При применении пропустите резервное копирование config.yaml с отметкой времени.

Не путать с hermes clawmigrate (однократный импорт конфигурации OpenClaw в Hermes) — hermesmigration — это команда перезаписи конфигурации верхнего уровня.

прокси Гермеса

hermes proxy <subcommand>

Запустите локальный HTTP-сервер, совместимый с OpenAI, который пересылает запросы вышестоящему поставщику с аутентификацией OAuth (например, Nous Portal, xAI). Внешние приложения могут указывать на прокси-сервер с помощью любого токена-носителя; на выходе прокси-сервер прикрепляет ваши настоящие учетные данные OAuth. Полное руководство см. в разделе Прокси-сервер подписки.

Подкоманда Описание
старт Запустите прокси на переднем плане. Флаги: --provider <nous\|xai> (по умолчанию nous), --host <addr> (по умолчанию 127.0.0.1; используйте 0.0.0.0 для предоставления доступа к локальной сети), --port <int> (по умолчанию 8645).
статус Покажите, какие восходящие прокси-серверы готовы (учетные данные присутствуют, OAuth действителен).
провайдеры Список доступных поставщиков прокси-серверов.

гермес безопасность

hermes security <subcommand>

Сканирование уязвимостей по требованию для OSV.dev. Охватывает Hermes venv (установленные дистрибутивы PyPI), зависимости Python, объявленные плагинами в ~/.hermes/plugins/, и закрепленные серверы MCP npx/uvx в config.yaml. НЕ сканирует глобально установленные пакеты или расширения редактора/браузера.

Подкоманда Описание
аудит Проведите разовый аудит цепочки поставок.

флаги аудита:

Флаг По умолчанию Описание
--json выключен Генерируйте машиночитаемый JSON вместо удобочитаемого текста.
--fail-on <уровень> критический Выйдите из ненулевого значения, если какой-либо результат соответствует этому уровню серьезности («низкий», «умеренный», «высокий», «критический»).
--skip-venv выключен Пропустите сканирование venv Hermes Python.
--skip-plugins выключен Пропустить сканирование файлов требований к плагину.
--skip-mcp выключен Пропустить сканирование закрепленных серверов MCP в config.yaml.

Вход в Hermes / Выход из Hermes (Устарело)

⚠️ Warning

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

гермес авт

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

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
hermes auth status anthropic                             # Show auth status for a provider
hermes auth logout anthropic                             # Log out and clear stored auth state
hermes auth spotify                                      # Authenticate Hermes with Spotify via PKCE

Подкоманды: «добавить», «список», «удалить», «сбросить», «статус», «выйти», «spotify». При вызове без подкоманды запускает мастер интерактивного управления.

статус Гермеса

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

гермес крон

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

Триггер cron можно подключить с помощью конфигурационного ключа cron.provider. Пустой (по умолчанию) использует встроенный внутрипроцессный тикер. Установите значение «chronos» (значок Поставщик, управляемый NAS, для размещенных шлюзов с масштабированием до нуля) — настраивается через Ключи cron.chronos.* (portal_url, callback_url, expected_audience, nas_jwks_url) — или назовите собственный поставщик в plugins/cron/<name>/ или $HERMES_HOME/plugins/<имя>/. Неизвестный или недоступный провайдер возвращается к встроенный, поэтому cron никогда не остается без триггера. См. внутренние функции cron doc.

гермес канбан

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

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

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

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

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

Действие Цель
инит Создайте kanban.db, ​​если он отсутствует. Идемпотент.
список досок / boards ls Перечислите все доски с количеством задач. --json, --all (включить в архив).
доски создают <slug> Создайте новую доску. Флаги: --name, --description, --icon, --color, --switch (сделать активными). Слизень шашлычный, автоопускаемый.
переключатель плат <slug> / использование плат Сохранять <slug> в качестве активной доски (записывать ~/.hermes/kanban/current).
показ досок / текущие доски Распечатайте имя активной в данный момент доски, путь к базе данных и количество задач.
доски переименовывают <slug> "<name>" Измените отображаемое имя доски. Слизень неизменен.
доски rm <slug> Архивировать (по умолчанию) или принудительно удалить доску. --delete пропускает этап архивирования. Архивированные доски перемещаются в boards/_archived/<slug>-<ts>/. Отказано по умолчанию.
создать "<title>" Создайте новую задачу на активной доске. Флаги: --body, --assignee, --parent (повторяемый), --workspace Scratch\|worktree\|dir:<path>, --tenant, --priority, --triage, --idempotency-key, --max-runtime, --max-retries, --skill (повторяемый).
список / ls Перечислите задачи на активной доске. Фильтруйте с помощью --mine, --assignee, --status, --tenant, --archived, --json.
показать <id> Показать задачу с комментариями и событиями. --json для машинного вывода.
назначить <id> <профиль> Назначить или переназначить. Используйте none, чтобы отменить назначение. Отказано во время выполнения задачи.
ссылка <родительский> <дочерний> Добавьте зависимость. Обнаружен цикл. Обе задачи должны находиться на одной доске.
отменить связь <родительский> <дочерний> Удалить зависимость.
претензия <id> Атомарно заявите готовую задачу. Печатает разрешенный путь к рабочей области.
комментарий <id> "<текст>" Добавить комментарий. Следующий работник, заявивший о задаче, читает ее как часть своего ответа kanban_show().
полный <id> Отметить задачу как выполненную. Флаги: --result, --summary, --metadata.
блокировать <id> "<причина>" Отметить задачу, заблокированную из-за вмешательства человека. Также добавляет причину в виде комментария.
расписание <id> "<причина>" Парковка с задержкой/отслеживанием работает по расписанию, поэтому она не отображается как блокирующая человек.
разблокировать <id> Верните заблокированную или запланированную задачу в состояние готовности (или «todo», если зависимости все еще открыты).
архив <id> Скрыть из списка по умолчанию. gc удалит рабочие области.
хвост <id> Следите за потоком событий задачи.
отправка На активном табло проходит один диспетчер. Флаги: --dry-run, --max N, --failure-limit N, --json.
контекст <id> Распечатайте полный контекст, который увидит работник (заголовок + текст + родительские результаты + комментарии).
указать <id> / указать --all Конкретизируйте задачу сортировки столбцов в конкретную спецификацию (заголовок + тело с целью, подходом, критериями приемки) с помощью вспомогательного LLM, а затем переместите ее в «todo». Флаги: --tenant (область --all для одного клиента), --author, --json. Настройте модель в разделе «auxiliary.triage_specifier» в «config.yaml».
decompose <id> / decompose --all Распределите задачу в виде столбца сортировки в график дочерних задач, перенаправленных по профилям специалистов по описанию. Возвращается к продвижению одной задачи в стиле указания, когда LLM решает, что задача не выиграет от разветвления. Те же флаги, что и specify. Настройте модель декомпозера в разделе auxiliary.kanban_decomposer в config.yaml; kanban.orchestrator_profile контролирует только то, кому принадлежит корневая задача/задача оркестрации после разветвления. Также автоматически запускается при каждом тике диспетчера, если kanban.auto_decompose: true (по умолчанию). См. Автоматическая и ручная оркестровка.
гк Удалите временные рабочие области для заархивированных задач.

Примеры:

# 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_BOARDenv var → файл~/.hermes/kanban/currentdefault`.

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

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

выход гермеса

Брандмауэр с внедрением исходящих учетных данных для изолированных программных сред удаленных терминалов. Обертывает демон iron-proxy — прокси-сервер, перехватывающий TLS, который заменяет непрозрачные токены прокси-сервера реальными учетными данными восходящего API на границе сети, поэтому песочницы никогда не содержат реальных ключей. По умолчанию отключено; см. полную страницу Выходной прокси для настройки и архитектуры.

hermes egress install                  # download the pinned iron-proxy binary
hermes egress install --force          # re-download even if already installed

hermes egress setup                    # interactive wizard: CA, mappings, config
hermes egress setup --tunnel-port N    # override the tunnel listener port (default 9090)
hermes egress setup --from-bitwarden   # use Bitwarden Secrets Manager as credential source
hermes egress setup --no-bitwarden     # explicitly switch back to env-based credentials
hermes egress setup --rotate-tokens    # mint fresh proxy tokens (default preserves existing)

hermes egress start                    # spawn the managed proxy daemon
hermes egress stop                     # SIGTERM (then SIGKILL after 5s grace)
hermes egress restart                  # stop (if running) then start — needed for secret changes
hermes egress reload                   # hot-reload the ruleset in-place (no restart, no dropped
                                       #   connections) via the loopback management API

hermes egress status                   # binary + config + pid + listening + mappings
hermes egress status --show-tokens     # print proxy tokens in full (default: redacted)

hermes egress disable                  # flip proxy.enabled = false (does not stop a running proxy)
hermes egress config                   # print the path to proxy.yaml for inspection

Общие потоки

# First-time setup
export OPENROUTER_API_KEY=…
hermes egress setup && hermes egress start
hermes config set terminal.backend docker   # if not already

# Switching credential source after the fact
hermes egress setup --from-bitwarden       # env → bitwarden
hermes egress setup --no-bitwarden         # bitwarden → env
# (just `setup` without either flag preserves the existing mode)

# Rotating all tokens (e.g. after a suspected token leak)
hermes egress setup --rotate-tokens    # setup offers to restart the running daemon for you
# (running sandboxes still hold old tokens; restart them too)

# Adding a new upstream
# Edit ~/.hermes/config.yaml proxy.extra_allowed_hosts: [api.example.com]
hermes egress setup
hermes egress restart                  # one-command apply (stop + start)

Ярлыки диагностики

hermes egress status                     # current state in one view
cat ~/.hermes/proxy/proxy.yaml           # the rendered iron-proxy config
tail -20 ~/.hermes/proxy/iron-proxy.log  # daemon-level diagnostics
tail -f ~/.hermes/proxy/iron-proxy.log | jq  # daemon + per-request log (line-delimited JSON; v0.39 combines both streams)

Распространенные режимы сбоя и восстановления описаны в Выходной прокси → Устранение неполадок.

проект Гермес

hermes project <create|list|show|add-folder|remove-folder|rename|set-primary|use|archive|restore|bind-board>

Проекты — это рабочие области с человеческими именами, которые могут охватывать несколько папок/репозиториев. Они привязывают группировку сеансов рабочего стола и, привязываясь к канбан-доске, задают задачам детерминированное рабочее дерево + соглашение о ветках. Состояние указывается для каждого профиля.

Подкоманда Описание
создать Создайте новый проект.
список (псевдоним ls) Перечислите проекты.
шоу Показать детали проекта.
добавить-папку Добавьте папку/репозиторий в проект.
удалить папку Удалить папку из проекта.
переименовать Переименуйте проект.
set-primary Установите основную папку.
использовать Установите активный проект.
архив Архивировать проект (с возможностью восстановления).
восстановить Восстановить архивный проект.
переплетная доска Привяжите канбан-доску к этому проекту.

вебхук Гермеса

hermes webhook <subscribe|list|remove|test>

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

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

hermes webhook подписаться

hermes webhook subscribe <name> [options]
Вариант Описание
--подсказка Шаблон запроса со ссылками на полезную нагрузку {dot.notation}.
--события Типы событий, разделенные запятыми, которые можно принять (например, issues,pull_request). Пусто = все.
--описание Читабельное описание.
--навыки Имена навыков, разделенные запятыми, которые необходимо загрузить для запуска агента.
--доставить Цель доставки: log (по умолчанию), Telegram, Discord, Slack, github_comment.
--deliver-chat-id Целевой идентификатор чата/канала для кросс-платформенной доставки.
--секрет Пользовательский секрет HMAC. Генерируется автоматически, если опущено.
--только доставка Пропустите агента — доставьте визуализированное --prompt как буквальное сообщение. Нулевая стоимость LLM, доставка за доли секунды. Требуется, чтобы --deliver был реальной целью (а не log).
--скрипт Сценарий фильтрации/преобразования в ~/.hermes/scripts/. Полезная нагрузка веб-перехватчика передается в формате JSON на стандартный ввод; Стандартный вывод JSON заменяет полезную нагрузку, а пустой стандартный вывод, [SILENT] или ненулевой код выхода игнорирует веб-перехватчик. См. Фильтры и преобразования сценариев.

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

доктор Гермес

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

свалка Гермеса

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 debug share [options]

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

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

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

При загрузке по умолчанию используются общедоступные службы вставки, которые опробованы по порядку: Paste.rs, dpaste.com. --nous вместо этого загружает тот же пакет отладки в частное хранилище диагностики Nous; возвращенная ссылка для просмотра предназначена для команды Nous и автоматически удаляется через 14 дней.

Примеры

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 --nous       # Upload a private diagnostics bundle for Nous support
hermes debug share --local      # Print report to terminal (no upload)

резервная копия Гермеса

hermes backup [options]

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

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

Резервное копирование использует API backup() 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 checkpoints [COMMAND]

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

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

Опции

Вариант Подкоманда Описание
--предел N статус, список Максимальное количество проектов в списке (по умолчанию 20).
--дней хранения N чернослив Удалить проекты, чей last_touch старше N дней (по умолчанию 7).
--max-size-mb N чернослив После прохода «сиротский/устаревший» удаляйте самую старую фиксацию для каждого проекта до тех пор, пока общий размер хранилища не станет ≤ N МБ (по умолчанию 500).
--держать-сирот чернослив Пропустить удаление проектов, рабочий каталог которых больше не существует.
-f, --force ясно, ясно-наследие Пропустите запрос подтверждения.

Примеры

hermes checkpoints                                  # status overview
hermes checkpoints prune --retention-days 3         # aggressive cleanup
hermes checkpoints prune --max-size-mb 200          # tighten size cap once
hermes checkpoints clear-legacy -f                  # drop v1 archive dirs
hermes checkpoints clear -f                         # wipe everything

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

импорт Гермеса

hermes import <zipfile> [options]

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

Вариант Описание
-f, --force Пропустите запрос на подтверждение существующей установки.
Остановите шлюз перед импортом, чтобы избежать конфликтов с запущенными процессами.
### Примеры
hermes import ~/hermes-backup-20260423.zip           # Prompts before overwriting existing config
hermes import ~/hermes-backup-20260423.zip --force   # Overwrite without prompting

журналы Гермеса

hermes logs [log_name] [options]

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

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

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

Опции

Вариант Описание
имя_журнала Какой журнал просматривать: «агент» (по умолчанию), «ошибки», «шлюз» или «список», чтобы показать доступные файлы с указанием размеров.
-n, --lines <N> Количество отображаемых строк (по умолчанию: 50).
-f, --follow Следите за журналом в режиме реального времени, например «tail -f». Нажмите Ctrl+C, чтобы остановить.
--level <УРОВЕНЬ> Минимальный уровень журнала для отображения: DEBUG, INFO, WARNING, ERROR, CRITICAL.
--session <ID> Фильтровать строки, содержащие подстроку идентификатора сеанса.
--с <TIME> Показывать строки относительного времени назад: 30m, 1h, 2d и т. д. Поддерживает s (секунды), m (минуты), h (часы), d (дни).
--компонент <ИМЯ> Фильтровать по компонентам: «шлюз», «агент», «инструменты», «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 Prompt-size

hermes prompt-size [--platform <name>] [--json]

Сообщает фиксированный оперативный бюджет для нового сеанса — то, что отправляется каждый раз. Вызов API перед любым содержимым разговора. Полезно, когда нисходящий адаптер или прокси имеет более ограниченный бюджет, чем контекстное окно модели, или когда вы хочу увидеть, какой блок (индекс навыков, память, профиль) доминирует.

Он создает ту же системную подсказку, что и агент, а затем разбивает ее на части:

Работает полностью автономно — без вызова API, работает без настроенных учетных данных.

# Human-readable breakdown for the CLI platform (default)
hermes prompt-size

# Simulate a messaging platform's prompt (different platform hint)
hermes prompt-size --platform telegram

# Machine-readable output for scripts
hermes prompt-size --json
```<div class="admonition admonition-tip"><p class="admonition-title">💡 Tip</p>
Индекс навыков и схемы инструментов масштабируются в зависимости от количества имеющихся у вас навыков и инструментов.
включен. Чтобы уменьшить приглашение, отключите неиспользуемые наборы инструментов («инструменты Гермеса») или
удалите ненужные вам навыки («навыки Гермеса»). Контекстные файлы (AGENTS.md,.cursorrules) в вашем текущем каталоге также учитываются в общей сумме.</div>
## `конфигурация Гермеса`
```bash
hermes config <subcommand>

Подкоманды:

Подкоманда Описание
шоу Показать текущие значения конфигурации.
редактировать Откройте config.yaml в вашем редакторе.
получить <ключ> [--json] Выведите одно значение конфигурации, используя пунктирный ключ (например, hermes config get model.default). --json выдает машиночитаемый вывод.
set <ключ> <значение> Установите значение конфигурации.
сбросить <ключ> Удалите ключ конфигурации, вернув его к встроенному значению по умолчанию.
путь Распечатайте путь к файлу конфигурации.
окружающий-путь Распечатайте путь к файлу .env.
проверить Проверьте отсутствующую или устаревшую конфигурацию.
мигрировать Добавление новых опций в интерактивном режиме.

спаривание Гермеса

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

навыки Гермеса

hermes skills <subcommand>

Подкоманды:

Подкоманда Описание
просмотреть Постраничный браузер для реестров навыков.
поиск Поиск реестров навыков.
установить Установите навык.
проверить Предварительный просмотр навыка без его установки.
список Перечислите установленные навыки.
проверить Проверьте установленные навыки концентратора на предмет обновлений исходной версии.
обновить Переустановите навыки концентратора с изменениями, внесенными в исходную версию, если они доступны.
аудит Повторное сканирование установленных навыков хаба.
удалить Удаление навыка, установленного в хабе.
сброс Отключите связанный навык, помеченный как user_modified, очистив его запись в манифесте. При --restore также заменяется пользовательская копия на версию из комплекта.
отказ Не допускайте добавления объединенных навыков в активный профиль. Записывает маркер .no-bundled-skills, поэтому установщик, hermes update и любая синхронизация пропускают заполнение связанных навыков. Безопасно по умолчанию — ничего на диске не трогается. С помощью --remove также удаляются уже существующие связанные навыки, которые немодифицированы (навыки, отредактированные пользователем, установленные в хабе и написанные от руки, никогда не удаляются; сначала выполняется предварительный просмотр и подтверждение, --yes, чтобы пропустить).
согласие Отмените «отказ», удалив маркер «.no-bundled-skills», чтобы объединенные навыки снова были использованы при следующем «обновлении Hermes». С помощью --sync немедленно выполните повторное заполнение.
опубликовать Опубликовать навык в реестре.
снимок Экспорт/импорт конфигураций навыков.
нажать Управляйте пользовательскими источниками навыков.
конфигурация Интерактивная настройка включения/выключения навыков в зависимости от платформы.

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

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 (+ referenced support files)
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
hermes skills reset google-workspace
hermes skills reset google-workspace --restore --yes
hermes skills opt-out                  # stop future bundled-skill seeding (nothing deleted)
hermes skills opt-out --remove --yes   # also delete UNMODIFIED bundled skills
hermes skills opt-in --sync            # undo: remove marker and re-seed now

Примечания: - --force может переопределить неопасные блокировки политики для сторонних/общественных навыков. - --force не отменяет опасный вердикт сканирования. - --source assets-sh выполняет поиск в общедоступном каталоге skills.sh. - --source wellknown позволяет указать Hermes на сайт, раскрывающий /.well-known/skills/index.json. - --source Browse-sh ищет в каталоге browse.sh более 200 навыков автоматизации браузера, специфичных для конкретного сайта. Идентификаторы выглядят так: «browse-sh/airbnb.com/search-listings-ddgioa». - При передаче URL-адреса http(s)://…/*.md устанавливается SKILL.md, а также файлы с явными ссылками в references/, templates/, scripts/,assets/и ``examples/. Если у frontmatter нет name: ​​и фрагмент URL-адреса не является допустимым идентификатором, интерактивный терминал запрашивает имя; неинтерактивные поверхности (/skills install внутри TUI, шлюзовые платформы) вместо этого требуют --name <x>.

пакеты Гермеса

hermes bundles <subcommand>

Пакеты навыков группируют несколько навыков под одной косой чертой /<bundle-name>. При вызове пакета каждый указанный навык загружается в одно объединенное пользовательское сообщение. Хранение: ~/.hermes/skill-bundles/<slug>.yaml. См. Наборы навыков для получения информации о схеме и поведении YAML.

Подкоманды:

Подкоманда Описание
список Список установленных пакетов (по умолчанию, если подкоманда не указана)
показать <имя> Показать имя, описание, навыки и путь к файлу одного пакета
создать <имя> Создайте новый пакет. Передайте --skill <id> (повторите) или опустите для интерактивного ввода. Доступны --description, --instruction, --force.
удалить <имя> Удалить файл пакета
перезагрузить Повторно просканировать ~/.hermes/skill-bundles/ и сообщить о добавленных/удаленных пакетах

Примеры:

hermes bundles create backend-dev \
  --skill github-code-review \
  --skill test-driven-development \
  --skill github-pr-workflow \
  -d "Backend feature work"

hermes bundles list
hermes bundles show backend-dev
hermes bundles delete backend-dev

В сеансе чата /bundles перечисляет установленные пакеты, а /<bundle-name> загружает один.

куратор Гермеса

hermes curator <subcommand>

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

Подкоманда Описание
статус Показать статус куратора и статистику навыков
бежать Запустить проверку куратора прямо сейчас (блокируется до завершения прохождения LLM)
запустить --background Запустите проход LLM в фоновом потоке и немедленно вернитесь
запустить --dry-run Только предварительный просмотр — создание отчета о проверке без изменений
резервное копирование Сделайте вручную снимок tar.gz ~/.hermes/skills/ (куратор также делает снимки автоматически перед каждым реальным запуском)
откат Восстановить ~/.hermes/skills/ из снимка (по умолчанию — самый новый)
откат --list Список доступных снимков
откат --id <ts> Восстановить конкретный снимок по id
откат -y Пропустить запрос подтверждения
пауза Приостановить работу куратора до возобновления
резюме Резюме приостановленного куратора
закрепить <навык> Закрепите навык, чтобы куратор никогда не переключал его автоматически
открепить <навык> Открепить навык
восстановить <навык> Восстановить заархивированный навык
архив <навык> Архивировать навык вручную
чернослив Вручную сокращайте навыки, которые куратор обычно подчищает
список в архиве Список заархивированных навыков (можно восстановить с помощью «восстановления»)

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

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

гермес моа

Настройте именованные пресеты смеси агентов. Предустановки отображаются в виде выбираемых моделей в разделе поставщика «Смесь агентов» в каждом средстве выбора модели; /moa <prompt> запускает одно приглашение с использованием настроек по умолчанию.

hermes moa list
hermes moa configure [name]
hermes moa delete <name>

hermes moa configure повторно использует поставщика Hermes → средство выбора модели для каждой эталонной модели и агрегатора. Предустановка — это конфигурация режима выполнения, а не основная модель или поставщик.

резервный вариант Гермеса

hermes fallback <subcommand>

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

Подкоманда Описание
список (псевдоним: ls) Показать текущую резервную цепочку (по умолчанию, если нет подкоманды)
добавить Выберите поставщика + модель (тот же выбор, что и «модель Гермеса») и добавьте в цепочку
удалить (псевдоним: rm) Выберите запись, которую хотите удалить из цепочки
ясно Удалить все резервные записи

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

крючки Гермеса

hermes hooks <subcommand>

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

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

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

память Гермеса

hermes memory <subcommand>

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

Подкоманды:

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

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

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

hermes-acp
python -m acp_adapter

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

cd ~/.hermes/hermes-agent && uv pip install -e '.[acp]'

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

гермес mcp

hermes mcp <subcommand>

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

Подкоманда Описание
(нет) или выборщик Интерактивный выбор каталога — просмотрите одобренные Nous MCP и установите/включите/отключите.
каталог Перечислите одобренные Nous MCP (обычный текст, с возможностью использования скриптов).
установить <имя> Установите запись каталога (например, «hermes mcp install n8n»).
обслуживать [-v\|--verbose] Запустите Hermes в качестве сервера MCP — откройте доступ к разговорам другим агентам.
add <имя> [--url URL] [--command CMD] [--auth oauth\|header] [--args...] Добавьте собственный сервер MCP с автоматическим обнаружением инструментов. --args передает оставшийся аргумент команде stdio, поэтому помещайте его последним.
remove <имя> (псевдоним: rm) Удалите сервер MCP из конфигурации.
список (псевдоним: ls) Список настроенных серверов MCP.
тест <имя> Проверьте подключение к серверу MCP.
configure <имя> (псевдоним: config) Переключить выбор инструментов для сервера.
логин <имя> Принудительная повторная аутентификация для сервера MCP на основе OAuth.

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

Плагины Гермеса

hermes plugins [subcommand]

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

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

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

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

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

инструменты Гермеса

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

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

hermes для использования на компьютере

hermes computer-use <subcommand>

Подкоманды:

Подкоманда Описание
установить Запустите установщик драйвера cua (macOS, Windows и Linux).
установить --обновить Перезапустите установщик, даже если драйвер cua уже находится в PATH. Восходящий сценарий всегда извлекает последнюю версию, поэтому выполняется обновление на месте.
статус Выведите информацию о том, находится ли cua-driver в $PATH и какая версия установлена.

hermes Computer-Use Install — это стабильная точка входа для установки cua-driver двоичный файл, используемый набор инструментов computer_use. Он запускает тот же установщик, что и hermestools вызывается, когда вы впервые включаете использование компьютера, поэтому это безопасно. использовать для повторного запуска установки, если переключатель набора инструментов не сработал это (например, при настройках вернувшегося пользователя).

hermes update автоматически перезапускает исходный установщик в конце обновления, если драйвер cua находится в PATH, поэтому большинству пользователей не потребуется вызовите --upgrade вручную. Используйте его, когда вышестоящая компания отправляет нужное вам исправление. прямо сейчас, не дожидаясь следующего обновления Hermes.

гермес домашние животные

hermes pets <list|install|select|show|off|scale|remove|doctor>

Petdex — это общедоступная галерея анимированных спрайтов-питомцев для агентов кодирования. Установите его, и Hermes покажет, как он реагирует на активность агента в CLI, TUI и настольном приложении.

Подкоманда Описание
список Просмотрите галерею Petdex.
установить Установите питомца из галереи.
выбрать Устанавливаем активного питомца (пишет display.pet.*).
шоу Анимируйте активного питомца в терминале.
disabled Отключите отображение домашних животных.
масштаб Измените размер питомца везде (display.pet.scale).
удалить Удаление установленного питомца.
доктор Проверьте настройки домашних животных + поддержку графики терминала.

Вы также можете создать нового питомца из текстового описания с помощью косой черты /hatch. См. Домашние животные.

сеансы Гермеса

hermes sessions <subcommand>

Подкоманды:

Подкоманда Описание
список Перечислите последние сеансы.
просмотреть Интерактивный выбор сеансов с поиском и возобновлением.
export <выходные данные> [--session-id ID] Экспортируйте сеансы в JSONL.
удалить <идентификатор сеанса> Удалить одну сессию.
чернослив Удалить сеансы, соответствующие фильтрам: временные рамки --older-than/--newer-than/--before/--after (длительность типа 5h/2d, дни или временные метки ISO); атрибуты --source, --title, --model, --provider, --branch, --end-reason, --user, --chat-id, --chat-type, --cwd; числовые границы --min/--max-messages, --min/--max-tokens, --min/--max-cost, --min/--max-tool-calls; плюс --include-archived, --dry-run, --yes. По умолчанию: старше 90 дней.
архив Массовое архивирование (мягкое скрытие, без удаления) сеансов, соответствующих тем же фильтрам, что и «удаление». Требуется хотя бы один фильтр.
статистика Показать статистику хранилища сеансов.
rename <session-id> <title> Установите или измените заголовок сеанса.
оптимизировать Освободите дисковое пространство: объедините сегменты индекса FTS5 + ВАКУУМ. Неразрушающий — данные сеанса не изменяются.
оптимизировать-хранилище Перенесите индекс полнотекстового поиска в компактный макет внешнего контента версии 23; в больших базах данных при этом освобождается большая часть state.db.
ремонт Исправить неверную схему state.db (например, таблица messages_fts уже существует), чтобы скрытые сеансы появились снова; резервная копия делается в первую очередь.
ремонт-маршрутизация Повторно подключите разговоры шлюза, застрявшие в строках сеанса, которые потеряли свою маршрутизацию (чат «перепрыгивает во времени» после перезапуска). По умолчанию пробный запуск; --apply выполняет принятие (сначала остановите шлюз); --max-gap-секунды N настраивает окно смежности. Ремонтируются только однозначные случаи. См. раздел Сессии → Восстановление зависших сеансов шлюза.
выздороветь Автономное неразрушающее восстановление поврежденного state.db в отдельную чистую базу данных.
навыки переименования Восстановить заголовки для сессий, открытых с помощью /skill, используя то, что на самом деле ввел пользователь; перечисляет изменения, если не передан --apply.

информация Гермеса

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

коготь Гермеса

hermes claw migrate [options]

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

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

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

Миграция охватывает более 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/.envauth-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 import-agent [claude-code|codex] [options]

Импортируйте настройку Claude Code (~/.claude) или OpenAI Codex CLI (~/.codex) в Hermes. Сопоставляет инструкции CLAUDE.md/AGENTS.md с записями памяти, правила разрешения/запрета Bash(...) с command_allowlist/approvals.deny, серверы MCP с mcp_servers в config.yaml, а каталоги навыков в ~/.hermes/skills/. Всегда предварительный просмотр перед применением; Ключи API и учетные данные никогда не импортируются.

Вариант Описание
агент claude-code или codex (по умолчанию: автоматическое определение).
--source <путь> Пользовательский исходный каталог (по умолчанию: ~/.claude или ~/.codex).
--пробный прогон Только предварительный просмотр — ничего не пишите.
--перезаписать Заменить конфликтующие серверы/навыки MCP (по умолчанию: пропустить).
--да, -y Пропустить запросы подтверждения.

Полные таблицы сопоставления см. в руководстве по импорту.

гермес служит

hermes serve [options]

Запустите внутренний сервер Hermes — шлюз JSON-RPC/WebSocket, к которому подключаются настольное приложение и удаленные клиенты. Это тот же сервер, на котором работает «панель управления Hermes», но безголовый: он никогда не открывает пользовательский интерфейс браузера. Настольное приложение запускает собственный бэкэнд Hermes Serve; используйте эту команду напрямую, если вам нужен автономный сервер на удаленном хосте. Принимает те же параметры --host / --port / --insecure / --skip-build / --stop / --status, что и hermes Dashboard ниже (привязка без обратной связи использует тот же шлюз аутентификации). Требуется дополнительный [web]; встроенному сокету Chat дополнительно требуется [pty] на хосте POSIX.

приборная панель Гермеса

hermes dashboard [options]

Запустите веб-панель — пользовательский интерфейс на основе браузера для управления конфигурацией, ключами API и мониторингом сеансов. (Для автономного бэкэнда без пользовательского интерфейса браузера — например, того, что создает настольное приложение — используйте hermes Serve выше.) Требуется cd ~/.hermes/hermes-agent && uv pip install -e ".[web]" (FastAPI + Uvicorn). Вкладка «Чат» встроенного браузера всегда доступна и дополнительно требует наличия дополнительного pty (cd ~/.hermes/hermes-agent && uv pip install -e ".[web,pty]"), а также среды POSIX PTY, такой как Linux, macOS или WSL2. Полную документацию см. в Веб-панели.

Вариант По умолчанию Описание
--порт 9119 Порт для запуска веб-сервера
--хост 127.0.0.1 Привязать адрес
--no-open Не открывать браузер автоматически
--небезопасно выключен Устарело/не работает. Ранее аутентификация обходилася при привязке без обратной связи. С июня 2026 года для усиления публичной привязки всегда требуется поставщик аутентификации (пароль или OAuth). Привяжите 127.0.0.1 и туннелируйте, чтобы сохранить его локальным.
--skip-build выключен Пропустите этап сборки веб-интерфейса и напрямую обслуживайте существующий dist. Полезно для неинтерактивных контекстов (запланированные задачи Windows, CI), где npm недоступен. Предварительная сборка с помощью cd web && npm run build.
--изолированный выключен При запуске из именованного профиля («рабочая панель») запустите выделенный сервер для каждого профиля вместо маршрутизации на панель управления компьютера.
--стоп Остановите запуск процессов «приборной панели Hermes» и выйдите.
--статус Выведите список запущенных процессов «приборной панели Hermes» и выйдите.

регистр приборной панели Hermes

Зарегистрируйте эту установку как отдельную панель управления в своей учетной записи Nous Portal. Создает клиент OAuth, записывает HERMES_DASHBOARD_OAUTH_CLIENT_ID в ~/.hermes/.env и выводит информацию о том, как задействовать шлюз входа. Требуется вход в систему («настройка Hermes»).

Вариант Описание
--имя Читаемая человеком метка для информационной панели (по умолчанию: создается автоматически).
--redirect-uri Публичный URI перенаправления HTTPS OAuth (например, https://hermes.example.com/auth/callback). Опустите для использования только на локальном хосте.
--portal-url Переопределить базовый URL-адрес Nous Portal для регистрации (по умолчанию: портал, на который вы вошли). Также можно настроить через HERMES_DASHBOARD_PORTAL_URL.
# Default — opens browser to http://127.0.0.1:9119
hermes dashboard

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

# From a profile alias — routes to the machine dashboard with the
# profile preselected in the sidebar switcher (attach if running)
worker dashboard

профиль Гермеса

hermes profile <subcommand>

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

Подкоманда Описание
список Перечислите все профили.
использовать <имя> Установите закрепленный профиль по умолчанию.
create <имя> [--clone] [--clone-all] [--clone-from <источник>] [--no-alias] Создайте новый профиль. --clone копирует конфигурацию, .env, SOUL.md и навыки из активного профиля. --clone-all копирует все состояние. --clone-from указывает исходный профиль и подразумевает клонирование конфигурации, если только он не связан с --clone-all.
удалить <имя> [-y] Удалить профиль.
показать <имя> Показать детали профиля (домашний каталог, конфигурация и т. д.).
alias <имя> [--remove] [--имя ИМЯ] Управляйте сценариями-оболочками для быстрого доступа к профилю.
переименовать <старый> <новый> Переименуйте профиль.
экспорт <имя> [-o ФАЙЛ] Экспортируйте профиль в архив .tar.gz (локальная резервная копия).
import <архив> [--имя ИМЯ] Импортируйте профиль из архива.tar.gz (локальное восстановление).
install <источник> [--name N] [--alias] [--force] [-y] Установите дистрибутив профиля из URL-адреса git или локального каталога.
update <имя> [--force-config] [-y] Повторно вытащить раздачу; сохраняет пользовательские данные (память, сеансы, аутентификация).
информация <имя> Показать манифест распространения профиля (версия, требования, источник).

Примеры:

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 [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 [--gateway] [--check] [--no-backup] [--backup] [--yes]

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

hermes update извлекает настроенную ветку обновления (по умолчанию: main). Если ваша проверка находится в другой ветке, Hermes может проверить ветку обновления перед извлечением. Зафиксируйте работу ветки перед обновлением, если вы хотите оставить ее вне потока автоматического хранения обновлений.

Вариант Описание
--шлюз Внутренний режим, используемый командой обмена сообщениями /update. Использует файловый IPC для подсказок и потоковой передачи хода выполнения вместо чтения из стандартного ввода терминала. Не флаг перезапуска шлюза.
--проверить Проверьте, доступно ли обновление, не извлекая, не устанавливая зависимости и не перезапуская что-либо.
--no-backup Пропустите все резервные копии перед обновлением для этого запуска (как быстрый снимок состояния, так и полный zip-архив), независимо от updates.pre_update_backup.
--резервное копирование Создайте полную резервную копию перед обновлением для этого запуска: быстрый снимок состояния и полный архив HERMES_HOME (конфигурация, аутентификация, сеансы, навыки, данные сопряжения). Режим по умолчанию — «быстрый» — только упрощенный снимок состояния. Установите постоянный режим через updates.pre_update_backup: fast | полный | off в config.yaml.
--да, -y Предположим, что да, для интерактивных подсказок, таких как миграция конфигурации и восстановление тайника. Ввод API-ключа пропускается; для них запустите hermes configmigrate отдельно.

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

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

Команда Описание
версия Гермеса Информация о версии для печати.
обновление Гермеса Извлеките последние изменения и переустановите зависимости.

| hermes uninstall [--full] [--gui] [--dry-run] [--yes] | Удалите Hermes, при необходимости удалив все настройки/данные. --gui удаляет только графический интерфейс чата на рабочем столе, оставляя агента нетронутым; --full также удаляет конфигурацию/данные; --dry-run печатает то, что будет удалено, ничего не меняя; --yes пропускает подсказки. |

См. также