Navigace
ELOWEN · Dokumentace

Poslední aktualizace: 27. října 2026

Procházet dokumentaci · Když nefunguje server nebo služba
Provoz a aktualizace

Když nefunguje server nebo služba

Najděte níže svůj symptom, zkontrolujte pravděpodobnou příčinu a projděte očíslované kroky. Tento návod se týká instalace; co vidí člověk v prohlížeči, začíná v návodu Když něco nejde.

Nic nefunguje a potřebujete kontrolu stavu

Proč: jeden příkaz ukáže, zda jsou připravené démon, poskytovatelé, paměť a pluginy.

  1. Zastaveného démona spusťte příkazem elowen up.
  2. Spusťte elowen doctor; skript může místo přihlášení předat existující token: ELOWEN_TOKEN='…' elowen doctor.
  3. Bez uloženého přihlášení CLI se zeptá na uživatelské jméno a heslo administrátora; bez terminálu vypíše, co máte spustit.

Tip: Při dvoufázovém ověření potvrďte přihlášení CLI v prohlížeči. elowen setup spouští stejné kontroly.

Služba neběží

Proč: démon obsluhuje API, konverzace, úložiště, pluginy a práci na pozadí; webová služba dodává aplikaci.

  1. Spusťte elowen status.
  2. Spusťte je nebo restartujte pomocí elowen up nebo elowen restart all.
  3. elowen down obě zastaví a počká, až se aktivní práce uklidí; --force tuto práci zastaví hned.
  4. Na hostiteli se systemd si přečtěte jednotky a jejich poslední protokol:
systemctl status elowen-daemon elowen-web
journalctl -u elowen-daemon -n 100 --no-pager
journalctl -u elowen-web -n 100 --no-pager

Démon skončí hned po startu

Proč: obsazený port, staré Node.js, neodpovídající zálohy nebo zdrojové sestavení bez webového buildu.

  1. Zkontrolujte porty, verzi Node.js a protokol:
ss -ltnp | grep -E ':(4400|4500)\b'
node --version
journalctl -u elowen-daemon -n 100 --no-pager
  1. Uvolněte port, pokud jej drží jiný proces.
  2. Přejděte na Node.js 22.19.0 nebo novější.
  3. Obnovte databázi a její plugin-secrets.key ze stejné zálohy.
  4. U zdrojového checkoutu sestavte i webovou aplikaci.

Odpověď nikdy nedorazí

Proč: tah může čekat na odpověď, poskytovatel může selhávat nebo je kontext plný.

  1. Spusťte elowen doctor a elowen status.
  2. /stats v chatu ukáže model, spotřebu a kontext; /context v CLI kontext rozepíše.
  3. Protokol démona může uvést chyby poskytovatele, limity rychlosti, propadlé přihlašovací údaje a obnovu po přerušení.
  4. Čekající otázku nebo schválení zodpovězte na stejné ploše; plánované úlohy a delegovaná práce to neumí, i když některé kanály nabídky vyřídí.
  5. /compact shrne starší zprávy; /new začne znovu.

Shrnutí není doslovná kopie, proto si trvalá rozhodnutí ukládejte do paměti.

Spinner může také znamenat, že je rozbitá proxy nebo proud událostí: zkontrolujte konzoli prohlížeče a protokol démona. Při obnově spojení se zobrazí jeden řádek, například „Obnova spojení 2/5 · další pokus za 2 s“.

Chybí nástroj nebo plugin

Proč: plugin může být vypnutý, nepřidělený, nebo mu chybí přihlašovací údaje.

  1. Otevřete Nastavení → Pluginy a ověřte, že je plugin zapnutý.
  2. Ověřte, že účet má plugin přidělený.
  3. Doplňte nastavení a přihlašovací údaje a potom zkontrolujte Schopnosti a Aktivita, zda neukazují chybu načtení.
  4. Spusťte /tools a vypište aktivní nástroje pluginů i s jejich vlastníky; každý účet vidí své příkazy a přidělené pluginy.

Server MCP se spravuje v části MCP: opravte jeho adresu nebo příkaz a potom jej znovu připojte. Změna se může zobrazovat jako čekající, dokud se práce neuklidí, proto ji nezadávejte dvakrát; úpravy skillů restart nepotřebují.

Nástroj nebo příkaz je zakázán

Proč: zakazuje jej pravidlo oprávnění, nebo práce běží tam, kde ji nikdo nemůže schválit.

  1. Otevřete Účet → Modely a najděte Oprávnění příkazů a Pravidla nástrojů.
  2. Přečtěte pravidla pro daný příkaz: každé povolí, zeptá se nebo zakáže a platí poslední shoda.
  3. Změňte zakazující pravidlo, nebo za něj přidejte konkrétnější povolovací pravidlo.
  4. /yolo v CLI schválí oprávněné otázky jen pro tuto relaci; nikdy nepřebije zákaz ani striktní blokování neobsluhovaných běhů.

Delegovaná práce si drží hranici, se kterou začala, takže změny účtu běžící potomek nerozšíří. Režim jen pro čtení je zábrana, ne sandbox.

Delegovaná práce nebo workflow selže

Proč: chyba runneru může ovlivnit delegovanou práci, aniž by zastavila běžný chat, a přerušené workflow nechá nedokončené kroky.

  1. Otevřete přehled delegované práce v nadřazené konverzaci a přečtěte protokol démona.
  2. Než stejnou úlohu spustíte znovu, zjistěte, zda potomek skončil, běží nebo byl přerušen.
  3. Obnovte workflow pomocí WorkflowResume; dokončené kroky se neopakují.

Projekt nebo adresář je špatně

Proč: konverzace běží v jednom Projektu a jednom pracovním adresáři a Git worktree se použije jen tehdy, když na něj konverzace ukazuje.

  1. Ověřte zvolený Projekt v části Projekty.
  2. V CLI /project přepne konverzaci na jiný Projekt. /cd vypíše nebo změní vlastní pracovní adresář terminálu.
  3. Namiřte konverzaci na adresář worktree.

Delegovaná práce dědí Projekt a adresář volajícího; režimy plánu a jen pro čtení přidávají limity, ale hranici Projektu zachovávají.

Paměť nebo hledání nic nevrací

Proč: paměť může chybět nebo být nezařazená, nebo není nakonfigurovaný embedding model.

  1. Ověřte, že paměť existuje a má kategorii; paměti bez kategorie se obvykle nepřipomínají.
  2. V Nastavení → Modely ověřte, že je nakonfigurovaný embedding model. Bez něj hledání podle významu nefunguje, i když klíčové hledání může dál fungovat.

Paměť je soukromá pro účet, pokud nepatří do sdíleného fondu Projektu, a paměti z fondu si vybaví jen oprávnění členové Projektu.

Hledání v dokumentaci (nástroj DocsSearch a volba Zeptat se AI v paletě příkazů) funguje stejně: porovnává význam i klíčová slova, nebo bez modelu jen klíčová slova, a odpovídá okamžitě, protože se jeho index sestavuje na pozadí.

Zkrácení kontextu mění běžící kontext, ne uloženou paměť.

Kanál mlčí

Proč: zprávu blokuje plugin, jeho přístupová pravidla nebo cesta platformy.

  1. Spusťte elowen doctor a potom otevřete nastavení pluginu kanálu.
  2. Zkontrolujte, že je plugin zapnutý a jeho přihlašovací údaje platné.
  3. Zkontrolujte, že odesílatel, server, chat nebo vlákno jsou povolené a že jsou splněná nastavení odpovědí ve skupině a zmínek.
  4. Zkontrolujte, že odesílatel je propojený nebo přijatý podle pravidel pluginu.
  5. Za reverzní proxy směrujte /hooks/ na démona; funkční webová aplikace neprokazuje, že směrování webhooků funguje.

Upozornění: Tokeny poskytovatelů nikdy nevkládejte do chatu ani do protokolů.

Zobrazí se upozornění na disk

Proč: souborový systém s daty Chettyho a spravovanými prostředími je zaplněný z 80 %.

  1. Přečtěte aktuální hodnoty v měřidlech hostitele v Nastavení → Systém.
  2. Uvolněte místo na tomto souborovém systému; upozornění zmizí, až bude místa dost.
  3. Upozornění se změní na kritické, když zbývá méně než 2 GiB a 5 % místa.

Aplikace zobrazuje Vyžadována licence

Proč: démon nemá použitelnou licenci, takže odpovídá jen licenční stránka.

  1. Přečtěte důvod, který stránka uvádí.
  2. Zadejte klíč na stránce, nebo spusťte elowen licence activate.
  3. Po výpadku obnovte přístup k internetu; démon se ozve sám a do několika minut odemkne.

Upozornění: Poškozený soubor s licencí zastaví démona a jiný klíč jej nespraví. Obnovte jej ze zálohy stejné instalace a nikdy jej nemažte.

Hodiny výrazně mimo skutečný čas také mohou instanci zamknout; udržujte je synchronizované. Licence a aktivace vysvětluje všechny důvody a opravu každého z nich.

Webová aplikace se nenačte

Proč: je špatně webová služba, její port, adresa démona nebo cesta proxy pro streamování.

  1. Spusťte elowen status a přečtěte protokol webu:
elowen status
journalctl -u elowen-web -n 100 --no-pager
  1. Zkontrolujte webový port, ELOWEN_DAEMON_URL a cesty proxy pro streamování, potom obnovte stránku, aby si prohlížeč načetl aktuální soubory.
  2. Po aktualizaci ověřte, že obě služby běží a démon odpovídá:
systemctl is-active elowen-daemon elowen-web
curl -fsS http://127.0.0.1:4400/health

Démon ve výchozím nastavení poslouchá na localhostu; nevystavujte port 4400 do internetu.

Zkrácení kontextu ztrácí souvislosti nebo stále selhává

Proč: shrnutí zachovává podstatu, ne každou zprávu, a automatické pokusy se po opakovaných selháních zastaví.

  1. Rozhodnutí, která musí vydržet, ukládejte do paměti, nebo začněte čisté vyšetřování přes /new.
  2. Když automatické zkrácení stále selhává, přečtěte protokol démona a zkontrolujte Model pro zkrácení kontextu účtu.
  3. Spusťte /compact ručně; Limit neúspěšných zkrácení kontextu zastaví automatické pokusy po třech selháních v řadě.

Konverzace může přestat zkracovat i tehdy, když její kontext po shrnutí zůstane na prahu nebo nad ním; /compact tam stále funguje a spolehlivým řešením je nová konverzace.

Potřebujete protokoly nebo soubory instance

Proč: nastavení, účty a historie konverzací jsou v PostgreSQL, zatímco soubory instance leží ve složce instance.

  1. Umístění zjistíte z ELOWEN_DATABASE_URL, ELOWEN_INSTANCE_ROOT (výchozí ~/.config/elowen) a ELOWEN_LOG_DIR.
  2. Hledejte tyto soubory:
~/.config/elowen/licence.json
~/.config/elowen/plugin-secrets.key
~/.config/elowen/logs/daemon-YYYY-MM-DD.log
~/.config/elowen/logs/web-YYYY-MM-DD.log
~/.config/elowen/brain/
~/.config/elowen/plugins/
~/.config/elowen/plugins-data/
~/.config/elowen/plans/
~/.config/elowen/tool-results/
  1. Pro dočasné podrobnosti nastavte ELOWEN_LOG_LEVEL=debug a potom vraťte info.

Databáze není celá instalace: zálohujte celou konfigurační složku a databázi uchovávejte s odpovídajícím plugin-secrets.key.

Aktualizace selže nebo nová verze nenastartuje

Proč: aktualizátor ověří vydání proti licenci a migrace běží při startu novější verze.

  1. Spusťte elowen update, a po přerušení spusťte elowen update --recover, než zkusíte další aktualizaci.
  2. Ponechte protokoly a obnovte zálohu, když nová verze nenastartuje; nikdy nemažte migrační ani zámkové soubory.

Obnova přerušené aktualizace vysvětluje, co příkaz pro obnovu dělá a jak vyřešit odmítnutou nebo neúspěšnou aktualizaci.

Chcete obnovit nebo resetovat stav

Proč: různé problémy potřebují různý reset a úplný reset zničí uložená data.

  1. Začněte novou konverzaci přes /new, nebo aktuální vyprázdněte přes /clear.
  2. Odeberte paměti nebo kategorie na stránce Paměť.
  3. Spusťte elowen setup a doplňte chybějící konfiguraci.
  4. Před úplným resetem Chetty zastavte a udělejte ověřenou zálohu.

Upozornění: Databáze a složka instance s plugin-secrets.key patří k sobě: zálohujte je a obnovujte jako pár. Odstranění složky instance nebo zahození databáze zničí uložená data. Protokoly zůstávají ve složce instance, nebo v ELOWEN_LOG_DIR, pokud je nastavená.