Ściąga do CLI agenta Hermes — polecenia, flagi i skróty z ukośnikiem
Polecenia Shell i TUI dla samodzielnie hostowanego agenta Hermes.
Hermes Agent od firmy Nous Research to asystent wykorzystujący narzędzia, niezależny od modelu, którego można uruchamiać lokalnie lub na serwerze VPS.
Hermes nie zmusza Cię do korzystania z jednego interfejsu. Możesz używać:
- klasycznego interfejsu CLI
hermes/hermes chat, - sesji pełnoekranowej
hermes --tui, - długotrwałego procesu
hermes gatewaydla platform komunikacyjnych takich jak Telegram, Discord, Slack i innych, hermes dashboarddla lokalnego interfejsu przeglądarkowego po zainstalowaniu dodatku web.
Te ścieżki wykorzystują tę samą konfigurację i dane przechowywane w katalogu ~/.hermes; niniejsza strona zawiera polecenia powłoki istotne dla wszystkich tych trybów.

Poniżej znajduje się zwięzła referencja poleceń pogrupowana według zadań.
Instalacja Hermes Agent i polecenia CLI przy pierwszym uruchomieniu
W przypadku instalacji i rozwiązywania problemów zacznij od Instalacja, konfiguracja, przepływ pracy i rozwiązywanie problemów asystenta AI Hermes.
Skrypt instalacyjny pobiera repozytorium, konfiguruje środowisko Pythona i łączy wykonywalny plik hermes. Po wykonaniu source ~/.bashrc lub ~/.zshrc, Twoim domyślnym punktem wejścia do interaktywnego czatu jest po prostu hermes (z tej samej rodziny co hermes chat).
| Polecenie | Opis |
|---|---|
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash |
Oficjalna jednolinijkowa instalacja (Linux, macOS, WSL2). |
hermes / hermes chat |
Uruchom interaktywny czat po instalacji (domyślne codzienne wejście). |
hermes --version / hermes version |
Wyświetl informacje o wersji. |
hermes completion bash | zsh | fish |
Wygeneruj skrypty autouzupełniania dla powłoki. |
hermes update [--check] [--backup] [--restart-gateway] |
Pobrany najnowszy kod, zainstaluj ponownie zależności, opcjonalne utworzenie kopii zapasowej katalogu domowego lub restart bramki przed aktualizacją. |
hermes uninstall [--full] [--yes] |
Usuń Hermes; opcjonalne pełne usunięcie danych. |
Natywny system Windows nie jest obsługiwany; użyj WSL2. Instalacje na Androidzie przez Termuxa mają dedykowaną ścieżkę w dokumentacji źródłowej.
Globalne flagi dla każdego wywołania hermes
Te flagi stosuje się przed podpoleceniami i zmieniają który profil, którą sesję lub jaką część konfiguracji użytkownika załadować.
| Flag | Opis |
|---|---|
--profile, -p |
Wybierz profil Hermes dla tego uruchomienia (następuje nadpisanie domyślnego profilu wybranego przez hermes profile use). |
--resume, -r |
Wznów sesję po ID lub tytule. |
--continue [name], -c |
Kontynuuj najnowszą sesję lub najnowszą pasującą do tytułu. |
--worktree, -w |
Rozpocznij w izolowanym drzewie roboczym Git dla równoległych agentów. |
--yolo |
Omijaj monity o zatwierdzenie niebezpiecznych poleceń (używaj ostrożnie). |
--pass-session-id |
Dołącz ID sesji do promptu systemowego. |
--ignore-user-config |
Pomiń ~/.hermes/config.yaml (tylko wartości domyślne); plik .env jest nadal ładowany. |
--ignore-rules |
Pomiń automatyczne wstrzykiwanie AGENTS.md, SOUL.md, .cursorrules, pamięci, wstępnie załadowanych umiejętności. |
--tui |
Uruchom interfejs TUI (równoważnik HERMES_TUI=1). |
--dev |
Przy --tui, uruchom źródła TS przez tsx w celu dewelopacji TUI. |
Izolowana automatyzacja często łączy hermes chat --ignore-user-config --ignore-rules z hermes -z dla powtarzalnych, jednorazowych uruchomień.
hermes chat, jednorazowe prompty i hermes -z
| Polecenie / wzorzec | Opis |
|---|---|
hermes chat |
Interaktywny lub skryptowy czat; główny interfejs dla -q, -m, --provider, zestawów narzędzi, wznowienia, drzewa roboczego, punktów kontrolnych. |
hermes chat -q "..." |
Jednorazowy prompt (nieinteraktywny); zachowuje bogatszą strukturę wyjścia niż -z przy uruchamianiu narzędzi. |
hermes -z "..." |
Skryptowa jednorazowa komenda — tylko ostateczna odpowiedź na stdout, bez nagłówków czy szumu sesyjnego. Ten sam agent i narzędzia; najlepsze do potoków i skryptów. |
hermes chat --quiet, -Q |
Cichszy tryb programowy (nagłówki i podglądy narzędzi są tłumione). |
-m / --model, --provider |
Nadpisanie modelu i dostawcy dla danego uruchomienia; zmienne środowiskowe HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER odzwierciedlają to zachowanie. |
-t / --toolsets |
Włącz zestawy narzędzi oddzielone przecinkami dla tego uruchomienia. |
-s / --skills |
Wstępnie załaduj umiejętności (można powtarzać lub oddzielać przecinkami). |
--image path |
Załącz lokalny obraz do pojedynczego zapytania. |
--checkpoints |
Włącz punkty kontrolne na systemie plików przed niszczycielskimi edycjami. |
--max-turns N |
Ogranicz liczbę iteracji wywołań narzędzi na turę (domyślnie z konfiguracji). |
--source |
Tag źródła sesji (cli vs tool dla integracji). |
Model Hermes poza sesją vs /model wewnątrz niej — Uruchamianie hermes model z powłoki to miejsce, gdzie dodajesz dostawców, klucze i OAuth. Używanie /model przyciskuSlash pozwala tylko przełączać się między już skonfigurowanymi dostawcami. Jeśli widzisz tylko OpenRouter w /model, opuść sesję i dokończ konfigurację przez hermes model.
Wybór modelu, puli uwierzytelniania i dostawców zapasowych
| Polecenie | Opis |
|---|---|
hermes model |
Interaktywny wybór dostawcy i modelu; klucze, OAuth, niestandardowe punkty końcowe. |
hermes auth |
Pule uwierzytelniania — add, list, remove, reset dla przyjaznych dla rotacji kluczy i OAuth. |
hermes fallback [list | add | remove | clear] |
Zarządzaj uporządkowanymi dostawcami zapasowymi, gdy główny zgłasza błędy lub ograniczenia przepustowości. |
hermes setup [model | tts | terminal | gateway | tools | agent] [...] |
Podzielona lub pełna interaktywna konfiguracja (--quick, --reset, --non-interactive). |
Przestarzałe hermes login / hermes logout — użyj zamiast tego hermes auth i hermes model.
Wybór lokalnych punktów końcowych kompatybilnych z OpenAI w przeciwieństwie do hostowanych API dla hermes model opiera się na tych samych kompromisach co ogólna infrastruktura hostowania LLM (opóźnienie, koszt, operacje).
Gdy Twój domyślny model kończy się na Qwen lub Gemma na czymś takim jak Ollama, domyślne ustawienia samplerze są równie ważne jak wybrany ID modelu; z agregatowymi ustawieniami temperatury i penalizacji dla agentów zapoznaj się w Parametry wnioskowania agencjalnego LLM dla Qwen i Gemma.
Pliki konfiguracyjne i polecenia hermes config
Konfiguracja rozwiązywana jest w kolejności: nadpisanie CLI → config.yaml → .env → wartości domyślne. Klucze API powinny znajdować się w .env, a strukturalne ustawienia w config.yaml.
| Polecenie | Opis |
|---|---|
hermes config show |
Wyświetl skuteczną konfigurację. |
hermes config edit |
Otwórz config.yaml w $EDITOR. |
hermes config set key value |
Ustaw wartości (sekrety trafiają do .env, pozostałe do YAML). |
hermes config path / hermes config env-path |
Wyświetl ścieżki do plików konfiguracyjnych i środowiskowych. |
hermes config check |
Wykryj brakujące lub przestarzałe ustawienia. |
hermes config migrate |
Zastosuj nowo wprowadzone opcje interaktywnie. |
Gdzie znajdują się pliki — Wszystko znajduje się pod HERMES_HOME (domyślnie ~/.hermes) dla konfiguracji, sekretów, pamięci, umiejętności, sesji, stanu bramki i dzienników.
Zarządzanie sesjami i hermes profile
| Polecenie | Opis |
|---|---|
hermes sessions list |
Wyświetl ostatnie sesje. |
hermes sessions browse |
Interaktywny wybór z wyszukiwaniem i wznowieniem. |
hermes sessions export |
Eksportuj sesje (np. JSONL). |
hermes sessions delete, prune, rename, stats |
Usuń jedną sesję, wyczyń stare, zmień tytuły, pokaż statystyki magazynu. |
hermes profile list | use | create | delete | show | rename |
Zarządzaj izolowanymi instancjami Hermes na jednej maszynie. |
hermes profile export / import |
Archiwizuj lub przywróć profil z archiwum tarball. |
hermes profile alias |
Krótkie skrypty opakowujące dla szybkiego przełączania profili. |
Użyj hermes -p work chat -q "..." dla ad hoc uruchomień bez zmiany domyślnego profilu.
Centrum umiejętności, zestawy narzędzi, haczyki powłoki i wtyczki
Dla konfiguracji opartej na profilach i umiejętnościach dostosowanych do rzeczywistych przepływów produkcyjnych według ról, zobacz Umiejętności asystenta AI Hermes dla rzeczywistych setupów produkcyjnych. Dla pisania i debugowania plików SKILL.md — metadanych, stopniowej ujawniania i warunkowej widoczności — zobacz Tworzenie umiejętności Hermes Agent — struktura SKILL.md i najlepsze praktyki.
| Polecenie | Opis |
|---|---|
hermes tools |
Interaktywne włączanie narzędzi dla platform; --summary drukuje aktualne wybory. |
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config |
Przepływy pracy centrum umiejętności, w tym rejestrów i instalacji z URL. |
hermes curator status, run, pause, pin, rollback, … |
Tłowe utrzymanie umiejętności i bezpieczne cofanie. |
hermes hooks list, test, revoke, doctor |
Deklarowane haczyki powłoki i listy dozwolonych w konfiguracji. |
hermes plugins |
Skompletowany interfejs UI lub podpolecenia do instalacji, włączania, wyłączania, usuwania wtyczek. |
Wbudowana pamięć i dostawcy hermes memory
Wbudowane MEMORY.md / USER.md pozostają aktywne; zewnętrzni dostawcy dodają opcjonalne warstwy wywoływania. Aby dowiedzieć się, jak ta architektura zachowuje się w praktyce, przeczytaj System pamięci Hermes Agent — jak naprawdę działa trwała pamięć AI. Aby porównać zewnętrzne bazy danych i kompromisy aktywacji, zobacz Porównanie dostawców pamięci agentów — Honcho, Mem0, Hindsight i pięć innych.
| Polecenie | Opis |
|---|---|
hermes memory setup |
Interaktywna konfiguracja zewnętrznego dostawcy pamięci. |
hermes memory status |
Pokaż aktywne ustawienia dostawcy. |
hermes memory off |
Wyłącz zewnętrznego dostawcę; wbudowane pliki pozostają. |
Gdy dostawca jest aktywny, może zarejestrować dodatkowe podpolecenia najwyższego poziomu specyficzne dla dostawcy — uruchom hermes --help, aby zobaczyć, co jest obecnie podłączone.
Brama komunikacyjna, parowanie DM i platformy
| Polecenie | Opis |
|---|---|
hermes gateway setup |
Interaktywna konfiguracja platform komunikacyjnych. |
hermes gateway run |
Brama na pierwszym planie (zalecane na WSL, Docker, Termux). |
hermes gateway start | stop | restart | status |
Kontrola usługi systemd / launchd (--all wpływa na bramkę każdego profilu). |
hermes gateway install | uninstall |
Zainstaluj lub usuń usługę tła na poziomie użytkownika. |
hermes pairing list | approve | revoke | clear-pending |
Zatwierdzenia parowania DM dla botów komunikacyjnych. |
hermes whatsapp |
Przepływ parowania mostu WhatsApp. |
hermes slack manifest |
Generuj manifest aplikacji Slack z parzystością slashów bramki. |
Na WSL, hermes gateway run wewnątrz tmux jest odpornym wzorcem, gdy gateway start zachowuje się nieprawidłowo. Dla przepływów pracy telefonów end-to-end wykorzystujących tę samą warstwę bramki, zobacz Kontrola głosowa Hermes z telefonu.
Dla działania na dedykowanym serwerze z osobnym klientem desktopowym, postępuj zgodnie z Konfiguracja bezgłowego serwera Hermes Agent i zdalnego pulpitu.
Harmonogram Cron, webhooki i Kanban
| Polecenie | Opis |
|---|---|
hermes cron … |
Twórz, edytuj, wstrzymuj, wznawiaj, uruchamiaj, usuwaj zaplanowane prompty (tick dla ręcznego przejścia harmonogramu). |
hermes webhook subscribe, list, remove, test |
Dynamiczne trasy webhooków dla uruchomień napędzanych zdarzeniami. |
hermes kanban … |
Tablica zadań wieloprofilowa wspierana przez SQLite; dispatch napędza workerów. |
Jeśli potrzebujesz praktycznych wzorców konkurencji dla hermes kanban na samodzielnie hostowanych bramkach, zobacz Kanban w Hermes Agent dla samodzielnie hostowanych przepływów LLM.
hermes doctor, logi, kopie zapasowe i analizy użycia
| Polecenie | Opis |
|---|---|
hermes doctor [--fix] |
Interaktywna diagnostyka i opcjonalna automatyczna naprawa. |
hermes status [--all] [--deep] |
Zwięzły status; głębsze sprawdzenia przy необходимости. |
hermes dump [--show-keys] |
Przyjazna dla wklejania podsumowanie setupu dla Discorda lub zgłoszeń GitHub. |
hermes debug share |
Prześlij zanonimizowaną paczkę debugową do usługi pastebin (lub --local). |
hermes logs [agent | errors | gateway | list] |
Śledź i filtruj logi w katalogu dzienników profilu. |
hermes backup, hermes import |
Archiwa Zip danych domowych i ścieżki przywracania. |
hermes insights [--days N] [--source …] |
Tokeny, koszty i analizy aktywności. |
Gdy coś się psuje po aktualizacji, hermes doctor, hermes status i hermes logs errors -f tworzą najszybszą pętlę triażu.
MCP, ACP, panel webowy i migracja OpenClaw
| Polecenie | Opis |
|---|---|
hermes mcp serve |
Uruchom Hermes jako serwer MCP. |
hermes mcp add, remove, list, test, configure |
Zarządzaj połączeniami klienta MCP z Hermes. |
hermes acp |
Serwer stdio protokołu Agent Client Protocol dla edytorów (może wymagać dodatkowej instalacji). |
hermes dashboard [--port …] [--host …] |
Lokalny panel webowy (pip install hermes-agent[web]). |
hermes claw migrate … |
Migruj konfiguracje w stylu OpenClaw do Hermes (--dry-run, preset, opcjonalne sekrety). |
Migracja OpenClaw — hermes claw migrate odczytuje legacy katalogi domowe OpenClaw; aby zobaczyć, jak wyglądał ten stos przed przeniesieniem, zobacz Studium przypadku OpenClaw.
Polecenia slash w sesji CLI Hermes
Wpisz / dla autouzupełniania. Polecenia są wielkość liter nieważna; umiejętności rejestrują dodatkowe trasy /skill-name. Poniższe tabele to skuratowany podzbiór; pełny rejestr znajdziesz w Oficjalnej dokumentacji Hermes Agent na końcu tego artykułu.
Przepływ sesji, zadania tła i cele
| Polecenie | Opis |
|---|---|
/new, /reset |
Nowe ID sesji i historia. |
/resume [name] |
Wznów nazwaną sesję. |
/compress [focus] |
Ręczna kompresja kontekstu z opcjonalnym tematem skupienia. |
/retry, /undo |
Powtórz ostatni turę lub odrzuć ostatnią wymianę. |
/title … |
Nazwij sesję dla późniejszego /resume. |
/background …, /queue …, /steer … |
Równoległe uruchomienie w tle, kolejka następnego promptu, korekta w pętli po następnym narzędziu. |
/goal … |
Trwały wieloturzeniowy cel z pętlą sędziego (status, pause, resume, clear). |
/branch, /fork |
Rozgałęź konwersację dla alternatywnej eksploracji. |
Modele, przełączniki narzędzi, umiejętności i ponowne ładowanie
| Polecenie | Opis |
|---|---|
/model … [--global] |
Przełączaj modele między skonfigurowanymi dostawcami; --global utrwal domyślny. |
/tools …, /toolsets |
Przełączniki narzędzi sesyjnych i lista zestawów narzędzi. |
/skills … |
Szukaj, instaluj i zarządzaj umiejętnościami z czatu. |
/cron … |
UI zadań harmonogramu z sesji CLI. |
/reload-mcp |
Ponownie załaduj serwery MCP z konfiguracji. |
/reload |
Ponownie załaduj .env do działającej sesji bez restartu. |
Użycie, pomoc i wyjście
| Polecenie | Opis |
|---|---|
/usage, /insights |
Widoczność tokenów i kosztów; migawka analityczna. |
/help, /quit |
Pomoc lub wyjście z CLI. |
Aplikacje komunikacyjne (Telegram, Discord, Slack i inne) eksponują nakładający się zestaw slashów plus /approve, /restart, /commands i powiązane pomocniki tylko dla bramki — różnice platformowe są udokumentowane w referencji poleceń slash pod Oficjalną dokumentacją Hermes Agent poniżej.
Więcej przydatnej lektury
Powiązane strony na tej witrynie (szerszy kontekst dla Hermes i agentów terminalowych):
- Systemy AI — Samohostowani asystenci, RAG i lokalna infrastruktura — przegląd klastra i jak asystenci wpisują się w stos
- Pamięć systemów AI — hub pamięci i powiązane przewodniki
- Narzędzia deweloperskie AI — krajobraz narzędzi terminalowych i IDE
- Szybki start OpenCode — kolejny agent terminalowy do ergonomicznego porównania
Oficjalna dokumentacja Hermes Agent
Dokumentacja źródłowa na hermes-agent.nousresearch.com:
Wskazówka. Trzymaj hermes dump i hermes doctor --fix w pamięci mięśniowej — zamieniają one niejasne raporty “coś się zepsuło” w działające diffy w stosunku do sprawdzonej konfiguracji.