macOS / Linux одной строкой · hermes doctor · LLM · Gateway 7×24 · приёмка на удалённом Mac
Для кого: вы смотрите на Hermes Agent от Nous Research (~170k звёзд GitHub, июнь 2026) и хотите CLI, LLM и Telegram с телефона — но застряли на PATH, API-ключах или молчащем Gateway в группе. Итог: официальный curl | bash, hermes doctor, LLM в ~/.hermes/.env, hermes gateway install для настоящего 7×24. Читайте зачем Hermes нужен Mac без сна и аренду Mac Mini M4. План: требования → установка → doctor/LLM → Telegram → Skills → ошибки → платформа → FAQ.
Hermes Agent — «самоэволюционирующий» агент Nous Research с лицензией MIT: После успешной задачи он сохраняет траекторию как переиспользуемый Skill unter ~/.hermes/skills/. Бенчмарки сообщества в начале 2026 года при росте библиотеки Skill дают примерно 38 % меньше токенов на повторяющихся workflow (Beispiel: 3→19 Skills in 30 Tagen Daily Use). Процесс Gateway подключает Telegram, Discord, Slack, WhatsApp и ещё более двадцати каналов; MCP-Server расширяют инструменты без форка основного репозитория.
По сравнению с OpenClaw (более богатыми IM-сценариями на этом сайте) oder CrewAI / LangGraph (фреймворками оркестрации, которые вы собираете сами) Hermes — устанавливаемый продукт: CLI, Doctor-Checks, адаптерами каналов и файлами памяти (SESSION → MEMORY.md → USER.md). Wer unseren статьёй о трёхслойной памяти и аренде Mac Mini прочитал ту статью, используйте этот материал как практическое дополнение: установить, проверить и держать демон постоянно активным.
В июне 2026 года в тикетах чаще всего три темы: действительно ли установщик ставит Python и Node, переживает ли Gateway перезагрузку через launchd/systemd, und ob der Telegram-режим конфиденциальности группы игнорируются обычные сообщения. Мы следуем реальному порядку тикетов — а не копируем README. Официальная документация: hermes-agent.nousresearch.com/docs/getting-started/installation; Источник версий: github.com/NousResearch/hermes-agent.
Недооценённые требования: Многие думают, что Python 3.11, Node 22, ripgrep и ffmpeg нужно ставить вручную — скрипт делает это сам.
Нет «мозга» LLM: CLI запускается, но инференс падает, потому что hermes setup oder ~/.hermes/.env fehlt.
Gateway только на переднем плане: закрытие SSH убивает Telegram; hermes gateway install wurde nie ausgeführt.
Конфиденциальность группы: Bot antwortet in Gruppen nur auf /-Befehle, bis BotFather-Privacy aus ist und der Bot neu eingeladen wurde.
Установщик проверяет ОС и подтягивает зависимости. Die Tabelle hilft bei der Entscheidung, ob die Maschine tragfähig ist und ob Cloud-APIs oder lokale Modelle geplant werden sollten.
В русскоязычных командах частая ошибка, выбрать слишком маленький VPS und gleichzeitig Ollama plus Browser-Automation zu erwarten — das endet in Swap und instabilen Telegram-Long-Polls. Планируйте RAM до первого hermes doctor, nicht nach dem ersten Produktions-Ausfall.
| Параметр | Минимум | Рекомендуется |
|---|---|---|
| OS | macOS 12+, Ubuntu 20.04+, WSL2 | macOS 14+ (Apple Silicon) / Ubuntu 24.04 LTS |
| Python / Node | Installer provides 3.11 / Node 18+ | Installer defaults to Node 22; no sudo required |
| ОЗУ | 4 GB (nur Gateway + Cloud-APIs) | 16 GB (Ollama oder Browser-Automation) |
| Диск | ~1,5 GB inkl. Skill-Cache | 20 GB+ SSD bei lokalen Modellgewichten |
| Сеть | GitHub raw + LLM-API erreichbar | Stabile, latenzarme Leitung für Telegram Long Polling |
Кратко: (1) Python, Node, ripgrep und ffmpeg sind bei Standard-Install nicht manuell nötig. (2) Headless Linux-VPS: --skip-browser. (3) Windows nativ ist Beta — WSL2 + Linux-Installer ist der unterstützte Weg.
Im Terminal das offizielle Skript vom main-Branch ausführen (URL in der Nous-Doku vor Produktion erneut prüfen):
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Das Skript macht typischerweise: uv → Python 3.11 → Node.js 22 → ripgrep und ffmpeg → Clone nach ~/.hermes/hermes-agent/ → globaler hermes-Befehl → Standard-Skill-Registry. Erfolg: ✅ Hermes Agent installed at ~/.hermes in der Installer-Ausgabe.
source ~/.zshrc (macOS) oder source ~/.bashrc (Linux), damit PATH den Shim sieht.
Ohne GUI: curl -fsSL .../install.sh | bash -s -- --skip-browser.
hermes doctor — Health-Checkliste muss grün sein (Abschnitt 04).
hermes setup für den LLM-Anbieter (Tabelle Abschnitt 04).
Auf einem арендованный удалённый Mac erste Installation per VNC, wenn macOS Bildschirmaufnahme oder Bedienungshilfen verlangt — reines SSH klickt keine TCC-Dialoge.
Windows: iex (irm .../install.ps1), Dateien unter %LOCALAPPDATA%\hermes\; für Dashboard-Terminal WSL2, wenn die Doku eine Unix-Shell verlangt. Termux auf Android nutzt denselben curl | bash-Flow mit Umgebungserkennung.
VNC-Login → Terminal → Installer → Screenshot von hermes doctor fürs Runbook → hermes setup für API-Keys → danach SSH für Day-2. Unter ~/.hermes/ liegen Skills, SQLite-Sessions und .env. Vor Rückgabe der Hardware: tar czf hermes-backup.tgz ~/.hermes und auf dem nächsten Knoten wiederherstellen.
hermes doctor hermes --version hermes setup # полный мастер; лучше при первом запуске # oder: hermes model
hermes doctor — ваши ворота приёмки: virtualenv, CLI-Shim, Konfiguration, optionaler Browser-Stack und Channel-Voraussetzungen. Ein grüner Doctor-Lauf ist wie eine CI-Pipeline — nicht überspringen, bevor Telegram-Traffic auf die Box zeigt.
| Провайдер | Сильная сторона | Настройка |
|---|---|---|
| Nous Portal | Abo; 300+ Modelle | hermes setup --portal (OAuth) |
| OpenRouter | Multi-Modell-Experimente | API-Key in ~/.hermes/.env |
| Anthropic / OpenAI | Claude / GPT | API-Key oder OAuth per Assistent |
| Ollama / vLLM | Lokale Inferenz | Base URL + Key; 16 GB+ RAM einplanen |
Keys explizit setzen: hermes config set OPENROUTER_API_KEY sk-or-xxxx oder in ~/.hermes/.env. Smoke-Test mit hermes interaktiv — z. B. „Fasse heutige KI-Schlagzeilen zusammen“ und prüfen, dass keine 401 kommen.
Zweites Merkpaket: Doctor vor Gateway-Install; Versionsstring hilft im Support; Ollama auf 8-GB-Hosts swappt bei paralleler Skill-Suche — RAM wie im Speicher-Artikel: 16 GB Untergrenze / 24 GB komfortabel.
In Telegram @BotFather öffnen, /newbot, Bot-Token sicher speichern.
@userinfobot (oder gleichwertig) für die numerische User-ID.
hermes gateway setup, Telegram wählen, Token + ID — oder TELEGRAM_BOT_TOKEN und TELEGRAM_ALLOWED_USERS in .env.
Test mit hermes gateway im Vordergrund; Bot per DM vom Handy.
Produktion: hermes gateway install && hermes gateway start. macOS: launchd; Linux: sudo hermes gateway install --system für systemd.
Gruppenchats: Standard-Bots laufen im Privatsphäre-Modus und sehen nur Slash-Befehle. In BotFather Group Privacy deaktivieren, Bot aus der Gruppe entfernen und erneut einladen — sonst debuggen Sie die falsche Schicht.
15-Minuten-Abnahme: (1) DM-Antwort OK. (2) hermes gateway status = running. (3) Nach Reboot Auto-Start. (4) Keine wiederholten 401 (Key) oder 429 (Kontingent). Linux: journalctl -u hermes-gateway -f; gemieteter Mac: Konsole per VNC auf hermes filtern.
| Команда | Назначение |
|---|---|
| hermes | Interaktive Chat-CLI |
| hermes tools | Tool-Oberflächen ein/aus |
| hermes gateway status | Daemon-Gesundheit |
| hermes update | Neueste Version |
| hermes config check | Konfig nach Upgrades prüfen |
Skill-Evolution wirkt nur bei dauerhaft online gehosteten Maschinen: erfolgreiche Läufe werden zu Markdown-Prozeduren unter ~/.hermes/skills/. Wer das MacBook jede Nacht schlafen legt, stoppt das Flywheel — auch wenn Dateien auf der Platte bleiben.
MCP-Server in ~/.hermes/config.yaml unter mcp_servers (z. B. GitHub). Tokens mit Minimalrechten. Browser-MCP ist auf macOS am vollständigsten; headless Linux fehlen oft Abhängigkeiten — ein Grund, Gateway nach der POC-Phase auf einen Mac Mini zu verlagern.
| Symptom | Wahrscheinliche Ursache | Fix |
|---|---|---|
| hermes: command not found | PATH nicht aktualisiert | source ~/.zshrc oder neues Terminal |
| API key not set | LLM nicht konfiguriert | hermes model oder .env |
| Missing config after update | Schema-Drift | hermes config migrate |
| ModuleNotFoundError: dotenv | Falsches Python | ~/.hermes/.../venv/bin/hermes |
| Telegram-Gruppe schweigt | Privatsphäre-Modus | BotFather aus + Bot neu einladen |
| Plattform | 7×24-Verfügbarkeit | Skill-Zinseszins | Ideal für |
|---|---|---|---|
| Privates MacBook | ~60 % (Sleep killt Gateway) | Unterbrochen | Nur Wochenend-POC |
| x86-VPS (4 GB) | ~99,5 % Uptime | Stabil, keine macOS-only Tools | Reine Linux-Betreiber |
| Mac Mini M4 Miete | Rechenzentrum-SLA | launchd + Unified Memory | Telegram-Produktion |
Ein neuer Mac Mini M4 mit 16 GB kostet in der EU oft rund 650–750 € (Stand Juni 2026 — vor Budgetierung prüfen). Über 24 Monate amortisiert das etwa 27–31 €/Monat plus Strom, Kühlung und Ausfallrisiko in eigener Verantwortung. VNCMac-Monatsmiete wandelt CapEx in OpEx, während Sie prüfen, ob Hermes wirklich zwei Stunden pro Tag spart. Unified Memory hält Gateway (~4,2 GB in typischen Traces), Browser-CDP und SQLite-WAL in einem Pool — 4-GB-x86-VPS swappen oft bei Skill-FTS-Wartung.
Dritte Kennzahl fürs Deck: ~170k GitHub-Stars (Juni 2026), ~38 % Token-Reduktion bei Wiederholungsaufgaben in Skill-Benchmarks, 12+ Doctor-Checks vor Produktionsfreigabe, 15-Minuten-Telegram-Abnahme.
Nein. Das offizielle install.sh installiert per uv Python 3.11, Node 22, ripgrep und ffmpeg und registriert die hermes-CLI.
Die meisten Install- und Gateway-Schritte gehen per SSH. Erstmalige macOS-Datenschutz-Dialoge und manche OAuth-Browser-Callbacks brauchen VNC — wie in unseren OpenClaw-Remote-Mac-Leitfäden.
Einstieg bleibt das offizielle Install-Skript. Upgrade mit hermes update; bei Config-Drift hermes config check && hermes config migrate.
Der Speicher-Artikel erklärt, warum 7×24-Disk für SOUL, Skills und SQLite zählt. Dieser Leitfaden deckt Installation und Kanäle ab. Erst installieren, dann Host-Stufe wählen.
Ja, mit getrennten Verzeichnissen und Ports. RAM entsprechend budgetieren — Isolation siehe Multi-Agent auf einem gemieteten Mini.
Hermes installieren ist absichtlich langweilig: ein offizielles Skript, ein hermes doctor, eine .env, ein Gateway-Dienst. Zwischen Demo und Produktion liegt Uptime — Skills compounden, Telegram bleibt erreichbar, Memory-Dateien schreiben nur, solange Maschine und Daemon laufen.
Schlafendes Laptop, wackeliges Heim-WLAN oder ein zum Peak gedrosselter 5-$-VPS verwandeln „wird mit der Zeit klüger“ in „neuer Mitarbeiter jeden Montag“. Kauf eines Mac Mini M4 lohnt bei gemessener Jahreslast. Solange Sie Wert beweisen, physischen M4 mieten, Hermes per SSH installieren, Berechtigungen per VNC, ~/.hermes/ vor Lease-Ende tarballen.
Установить Hermes — шаг первый; держать его запущенным — это продукт. месячные тарифы Mac Mini M4 — ein Host, der um 18 Uhr nicht Feierabend macht.