Řešení potíží

U potíží s pluginem začněte v Nastavení → Pluginy → Nainstalované; u zamítnutých nástrojů zkontrolujte Účet → Modely → Oprávnění příkazů. Pokud je služba mimo provoz nebo tah přestal odpovídat, zužte příčinu pomocí níže uvedených kontrol v CLI.

Zkontrolujte, zda je Elowen připravená

Spusťte kontrolu stavu a připravenosti:

elowen doctor

Démon už musí běžet. V terminálu použije doctor přihlašovací údaj uložený příkazem elowen login; bez něj se zeptá na uživatelské jméno a heslo administrátora a u účtu chráněného dvoufázovým ověřením se přihlášení potvrdí v prohlížeči. Skripty mohou místo toho předat existující token:

ELOWEN_TOKEN='…' elowen doctor

Bez terminálu a bez tokenu doctor vypíše, co máte spustit, místo aby se dotazoval.

Pokud je démon zastavený, spusťte ho příkazem elowen up. Administrátoři si stejný ověřený přehled připravenosti přečtou na GET /system/readiness.

Služba není dostupná

Démon zajišťuje API, konverzace, úložiště, pluginy a práci na pozadí. Webová služba obsluhuje aplikaci v prohlížeči. Zkontrolujte obě:

elowen status

Služby spustíte nebo restartujete příkazem elowen up nebo elowen restart all. Zastavíte je příkazem elowen down; ten počká, až se běžící práce dokončí. elowen down --force použijte jen tehdy, když chcete tuto práci ukončit okamžitě.

U instalace se systemd zkontrolujte stav služeb a poslední záznamy v logu:

systemctl status elowen-daemon elowen-web
journalctl -u elowen-daemon -n 100 --no-pager
journalctl -u elowen-web -n 100 --no-pager

Démon se hned ukončí

Zkontrolujte porty, verzi Node.js a log démona:

ss -ltnp | grep -E ':(4400|4500)\b'
node --version
journalctl -u elowen-daemon -n 100 --no-pager

Časté příčiny: jiný proces obsadil nastavený port, nepodporovaná verze Node.js (Elowen vyžaduje Node.js 22.19.0 a novější), databáze a klíč tajemství pluginů z různých záloh, nebo build ze zdrojů bez samostatného webového buildu.

Tah neodpovídá

Nejprve zkontrolujte elowen doctor a elowen status. V chatu ukáže /stats model, spotřebu a podrobnosti o kontextu; v CLI otevře /context rozpis kontextu. Ověřený koncový bod GET /brain/status hlásí živý stav aktuální konverzace, práci ve frontě, čekající otázky a diagnostiku běhu. Log démona může ukázat chyby poskytovatele, limity požadavků, vypršelé přihlašovací údaje nebo obnovu po přerušení.

Pokud tah čeká na otázku nebo schválení, odpovězte ve stejném interaktivním rozhraní. Naplánované úlohy a delegovaná práce odpovědět interaktivně nemohou. Podporované pluginy kanálů umí některé výzvy zobrazit a vyřídit přímo v chatu.

U starého nebo plného kontextu použijte /compact ke shrnutí starších zpráv nebo /new pro novou konverzaci. Zkrácení kontextu je shrnutí, ne doslovná kopie; důležitá trvalá rozhodnutí ukládejte do paměti. Nekonečné načítání v prohlížeči může také znamenat, že je rozbitá reverzní proxy nebo datový tok událostí, proto před dalším pokusem zkontrolujte konzoli prohlížeče a log démona. Dokud se aplikace znovu připojuje k démonovi, zobrazuje jeden krátký řádek stavu, například „Připojuji se znovu 2/5 · další pokus za 2 s“.

Chybí nástroj nebo plugin

V Nastavení → Pluginy → Nainstalované ověřte, že je plugin zapnutý. Pak zkontrolujte, že má účet potřebné oprávnění k pluginu, že nastavení a přihlašovací údaje pluginu jsou úplné a že se v pohledech Schopnosti a Aktivita nezobrazuje chyba načtení.

V CLI mohou administrátoři spustit /tools a vypsat aktivní nástroje pluginů i plugin, kterému každý patří. Ostatní uživatelé si zkontrolují seznam dostupných příkazů a přidělené pluginy. Připojení serveru MCP se spravuje v části MCP; po opravě jeho koncového bodu nebo příkazu ho znovu připojte. Některé nástroje MCP se nejprve objeví jen názvem a podrobnosti načtou, až když je jich potřeba.

Změny pluginů se mohou zobrazovat jako čekající, dokud se běžící práce nedokončí. Nezadávejte stejnou změnu znovu: jakmile je restart ve frontě, projeví se při restartu démona. Úpravy skillu se projeví od další zprávy bez restartu.

Nástroj je zamítnutý

Projděte Účet → Modely → Oprávnění příkazů. Pravidla mohou nástroj nebo příkaz povolit, vyžádat dotaz nebo zakázat a rozhoduje poslední odpovídající pravidlo. /yolo ovlivní jen otázky na oprávnění, které přicházejí v aktuální relaci CLI. Nemůže přebít pravidlo zakazující ani blokaci běhů bez dozoru.

Delegovaná práce si drží hranici oprávnění, se kterou začala. Změna nastavení účtu nerozšíří oprávnění běžícího potomka a režim jen pro čtení je zábrana, ne sandbox souborového systému.

Delegovaná práce nebo workflow selhaly

Zkontrolujte pohled delegované práce v nadřazené konverzaci a log démona. Chyba runneru může postihnout delegovanou práci, aniž by zastavila běžný chat. Než spustíte stejný úkol znovu, zjistěte, zda potomek skončil, stále běží, nebo byl přerušen.

Workflow spouští nezávislé kroky paralelně a čeká na závislosti každého kroku. Po přerušení použijte WorkflowResume k opakování nedokončených kroků; hotové kroky se neopakují.

Projekt nebo adresář nesedí

V Projektech ověřte vybraný Projekt. V CLI přepne /project konverzaci do jiného Projektu a /cd vypíše a změní pracovní adresář samotného terminálu. Git worktree je běžný adresář; konverzace ho použije jen tehdy, když na něj ukazuje.

Delegovaná práce přebírá Projekt a pracovní adresář volajícího. Režim plánu a režim jen pro čtení přidávají limity provádění, ale hranici přístupu Projektu nenahrazují.

Paměť nebo sémantické hledání nic nevrací

Zkontrolujte, že vzpomínka existuje a má kategorii. V Nastavení → Modely ověřte, že je nastavený model pro embedding. Bez něj hledání podle významu nefunguje; hledání podle klíčových slov může dál fungovat.

Hledání v dokumentaci (nástroj DocsSearch a Zeptat se AI v paletě příkazů) se chová stejně: s nastaveným modelem hledá podle významu i klíčových slov zároveň, bez něj jen podle klíčových slov, a odpovídá okamžitě, protože na svůj index nečeká — ten se sestavuje a obnovuje na pozadí.

Paměť je soukromá pro účet, pokud nepatří do sdíleného fondu Projektu. Vzpomínky ze sdíleného fondu si vybaví jen oprávnění členové Projektu. Zkrácení kontextu mění kontext aktivní konverzace, ne uloženou paměť.

Integrace kanálu mlčí

Spusťte elowen doctor a pak zkontrolujte nastavení a pravidla přístupu pluginu kanálu:

• Plugin je zapnutý a jeho přihlašovací údaje platí.
• Odesílatel, server, chat nebo vlákno má povolený přístup.
• Nastavení odpovědí ve skupinách a zmínek je splněné.
• Odesílatel je propojený nebo přijatý podle pravidel pluginu.

U webhooku za reverzní proxy směrujte /hooks/ na démona. Funkční webová aplikace nedokazuje, že směrování webhooků je nastavené. Tokeny poskytovatelů nikdy nevkládejte do chatu ani do logů.

Objeví se varování o disku hostitele

Administrátoři dostanou varování, když je souborový systém s daty Elowen a spravovanými prostředími zaplněný z 80 %. Varování se změní na kritické, když zbývá méně než 2 GiB a 5 % místa. Na tomto souborovém systému uvolněte místo. Upozornění zmizí, jakmile je místa zase dost. Aktuální hodnoty disku najdete v měřidlech hostitele v Nastavení → Systém.

Aplikace hlásí Vyžadována licence

Démon nemá použitelnou licenci: odpovídají jen licenční cesty (GET /health, GET /setup, GET /licence, POST /licence/activate), všechno ostatní vrací licence_locked. Stránka uvede důvod; obvyklé opravy jsou:

• Licence není nainstalovaná — aktivujte příkazem elowen licence activate nebo zadejte klíč na stránce.
• Nedostupný licenční server po ochranné lhůtě — obnovte serveru přístup k internetu; démon se sám ozve a do několika minut odemkne, pokud je licence uložená.
• Odmítnutý nebo cizí server — licence byla odvolána, přesunuta, nebo patří jinému ID instance. Obraťte se na podporu nebo aktivujte klíč určený tomuto serveru.
• Vypršelá platnost — prodlužte licenci a pak aktivujte nový klíč.
• Poškozený licence.json — démon nenastartuje a aktivace soubor neopraví. Obnovte jej ze zálohy stejné instalace, nebo se obraťte na podporu; nikdy jej nemažte.

Instalaci může uzamknout i čas serveru výrazně odlišný od skutečného; udržujte hodiny serveru synchronizované. Úplný přehled najdete v článku Licence.

Webová aplikace se nenačte

Zkontrolujte stav služeb a log webu:

elowen status
journalctl -u elowen-web -n 100 --no-pager

Pak zkontrolujte nastavený port webu, ELOWEN_DAEMON_URL, směrování streamovacích cest v reverzní proxy a jestli má prohlížeč aktuální soubory. Démon naslouchá ve výchozím nastavení na localhostu; nevystavujte port 4400 přímo do internetu.

Po aktualizaci ověřte, že jsou obě služby aktivní a že koncový bod stavu démona odpovídá:

systemctl is-active elowen-daemon elowen-web
curl -fsS http://127.0.0.1:4400/health

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

Pomocí /stats nebo /context prohlédněte spotřebu; /compact vyžádá shrnutí. Shrnutí nezachová každou dřívější zprávu slovo od slova. Trvalá rozhodnutí ukládejte do paměti nebo použijte /new pro čisté vyšetřování.

Pokud automatické zkracování opakovaně selhává, zkontrolujte log démona a model pro zkrácení kontextu zvolený u účtu. Limit neúspěšných zkrácení kontextu u asistenta zastaví automatické pokusy ve výchozím nastavení po třech neúspěších za sebou, ruční /compact ale zůstává dostupný. Konverzace může přestat zkracovat i tehdy, když její kontext po shrnutí zůstane na prahu nebo nad ním; /compact tam funguje dál a spolehlivým řešením je nová konverzace.

Kde najít logy a trvalá data

Nastavení, účty a historie konverzací jsou v databázi PostgreSQL, na kterou ukazuje ELOWEN_DATABASE_URL. Soubory instance jsou v ELOWEN_INSTANCE_ROOT, ve výchozím nastavení ~/.config/elowen, a adresář logů lze přepsat proměnnou ELOWEN_LOG_DIR.

~/.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/

Databáze není celá instalace. Pokud je to možné, zálohujte celý konfigurační adresář a databázi uchovávejte spolu s odpovídajícím plugin-secrets.key. Chcete-li dočasně sbírat podrobnější záznamy, nastavte ELOWEN_LOG_LEVEL=debug a potom vraťte info.

Aktualizace, verze a migrace

Nainstalovanou instanci aktualizujete příkazem:

elowen update

Příkaz se zeptá licenčního serveru na nejnovější verzi jádra, kterou licence instalace pokrývá, stáhne ji, ověří a nainstaluje, zatímco Elowen běží dál; spravované služby se zastaví jen krátce kvůli výměně balíčků a restartu. Kanál vydání přes npm neexistuje. Odmítnutá kontrola uvede důvod licenčního serveru, obvykle odvolanou licenci. Kopie ze zdrojů může být novější než jakákoli vydaná verze, proto ji Elowen licencovanou verzí nenahradí. Automatické aktualizace se zapínají v Nastavení → Systém.

Pokud se aktualizace přeruší, elowen update --recover odstraní připravené soubory, které se nikdy nevyměnily, vrátí změnu přerušenou před ověřením, nebo dokončí publikování ověřeného commitu. Spusťte jej před dalším pokusem o aktualizaci.

Migrace databáze proběhnou při startu novější verze démona. Před skokem na jinou verzi si pořiďte obnovitelnou zálohu. Pokud démon potom nenastartuje, uchovejte logy a projděte journal, než zkusíte další aktualizaci. Nesnažte se problém obejít smazáním migračních souborů nebo zámků.

Obnovení a reset stavu

• Novou konverzaci zahájíte příkazem /new, aktuální vyčistíte příkazem /clear.
• Jednotlivé vzpomínky nebo kategorie odstraníte na stránce Paměť.
• Příkazem elowen setup doplníte chybějící nastavení.
• Pro úplný reset Elowen zastavte a nejprve si pořiďte ověřenou zálohu. Smazání složky instance nebo zahození databáze zničí uložená data. Databáze a složka instance s plugin-secrets.key patří k sobě; zálohujte je a obnovujte jako pár. Logy zůstávají ve složce instance, nebo v ELOWEN_LOG_DIR, pokud je nastavený.

Další: Slovník pojmů