Riešenie problémov

Pri problémoch s pluginom začnite v Nastavenia → Pluginy → Nainštalované; pri zamietnutých nástrojoch skontrolujte Účet → Modely → Oprávnenia príkazov. Ak je služba mimo prevádzky alebo ťah prestal odpovedať, zúžte príčinu pomocou nižšie uvedených kontrol v CLI.

Skontrolujte, či je Elowen pripravená

Spustite kontrolu stavu a pripravenosti:

elowen doctor

Démon už musí bežať. V termináli použije doctor prihlasovací údaj uložený príkazom elowen login; bez neho sa opýta na používateľské meno a heslo administrátora a pri účte chránenom dvojfázovým overením sa prihlásenie potvrdí v prehliadači. Skripty môžu namiesto toho odovzdať existujúci token:

ELOWEN_TOKEN='…' elowen doctor

Bez terminálu a bez tokenu doctor vypíše, čo máte spustiť, namiesto toho, aby sa pýtal.

Ak je démon zastavený, spustite ho príkazom elowen up. Administrátori si rovnaký overený prehľad pripravenosti prečítajú na GET /system/readiness.

Služba nie je dostupná

Démon zabezpečuje API, konverzácie, úložisko, pluginy a prácu na pozadí. Webová služba obsluhuje aplikáciu v prehliadači. Skontrolujte obe:

elowen status

Služby spustíte alebo reštartujete príkazom elowen up alebo elowen restart all. Zastavíte ich príkazom elowen down; ten počká, kým sa bežiaca práca dokončí. elowen down --force použite len vtedy, keď chcete túto prácu ukončiť okamžite.

Pri inštalácii so systemd skontrolujte stav služieb 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 sa hneď ukončí

Skontrolujte porty, verziu Node.js a log démona:

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

Časté príčiny: iný proces obsadil nastavený port, nepodporovaná verzia Node.js (Elowen vyžaduje Node.js 22.19.0 a novšiu), databáza a kľúč tajomstiev pluginov z rôznych záloh, alebo build zo zdrojov bez samostatného webového buildu.

Ťah neodpovedá

Najprv skontrolujte elowen doctor a elowen status. V chate ukáže /stats model, spotrebu a podrobnosti o kontexte; v CLI otvorí /context rozpis kontextu. Overený koncový bod GET /brain/status hlási živý stav aktuálnej konverzácie, prácu vo fronte, čakajúce otázky a diagnostiku behu. Log démona môže ukázať chyby poskytovateľa, limity požiadaviek, vypršané prihlasovacie údaje alebo obnovu po prerušení.

Ak ťah čaká na otázku alebo schválenie, odpovedzte v tom istom interaktívnom rozhraní. Naplánované úlohy a delegovaná práca odpovedať interaktívne nemôžu. Podporované pluginy kanálov vedia niektoré výzvy zobraziť a vybaviť priamo v chate.

Pri starom alebo plnom kontexte použite /compact na zhrnutie starších správ alebo /new na novú konverzáciu. Skrátenie kontextu je zhrnutie, nie doslovná kópia; dôležité trvalé rozhodnutia ukladajte do pamäte. Nekonečné načítavanie v prehliadači môže tiež znamenať, že je pokazená reverzná proxy alebo dátový tok udalostí, preto pred ďalším pokusom skontrolujte konzolu prehliadača a log démona. Kým sa aplikácia znova pripája k démonovi, zobrazuje jeden krátky riadok stavu, napríklad „Pripájam sa znova 2/5 · ďalší pokus o 2 s“.

Chýba nástroj alebo plugin

V Nastavenia → Pluginy → Nainštalované overte, že je plugin zapnutý. Potom skontrolujte, či má účet potrebné oprávnenie k pluginu, či sú nastavenia a prihlasovacie údaje pluginu úplné a či sa v pohľadoch Schopnosti a Aktivita nezobrazuje chyba načítania.

V CLI môžu administrátori spustiť /tools a vypísať aktívne nástroje pluginov aj plugin, ktorému každý patrí. Ostatní používatelia si skontrolujú zoznam dostupných príkazov a pridelené pluginy. Pripojenie servera MCP sa spravuje v časti MCP; po oprave jeho koncového bodu alebo príkazu ho znova pripojte. Niektoré nástroje MCP sa najprv objavia len názvom a podrobnosti načítajú, až keď sú potrebné.

Zmeny pluginov sa môžu zobrazovať ako čakajúce, kým sa bežiaca práca dokončí. Nezadávajte rovnakú zmenu znova: keď je reštart vo fronte, prejaví sa pri reštarte démona. Úpravy skillu sa prejavia od ďalšej správy bez reštartu.

Nástroj je zamietnutý

Prejdite Účet → Modely → Oprávnenia príkazov. Pravidlá môžu nástroj alebo príkaz povoliť, vyžiadať otázku alebo zakázať a rozhoduje posledné zodpovedajúce pravidlo. /yolo ovplyvní len otázky na oprávnenia, ktoré prichádzajú v aktuálnej relácii CLI. Nemôže prebiť pravidlo zakazujúce ani blokáciu behov bez dozoru.

Delegovaná práca si drží hranicu oprávnení, s ktorou začala. Zmena nastavení účtu nerozšíri oprávnenia bežiaceho potomka a režim iba na čítanie je zábrana, nie sandbox súborového systému.

Delegovaná práca alebo workflow zlyhali

Skontrolujte pohľad delegovanej práce v nadradenej konverzácii a log démona. Chyba runneru môže postihnúť delegovanú prácu bez toho, aby zastavila bežný chat. Kým spustíte rovnakú úlohu znova, zistite, či potomok skončil, stále beží alebo bol prerušený.

Workflow spúšťa nezávislé kroky paralelne a čaká na závislosti každého kroku. Po prerušení použite WorkflowResume na zopakovanie nedokončených krokov; hotové kroky sa neopakujú.

Projekt alebo adresár nesedí

V Projektoch overte vybraný Projekt. V CLI prepne /project konverzáciu do iného Projektu a /cd vypíše a zmení pracovný adresár samotného terminálu. Git worktree je bežný adresár; konverzácia ho použije len vtedy, keď naň ukazuje.

Delegovaná práca preberá Projekt a pracovný adresár volajúceho. Režim plánu a režim iba na čítanie pridávajú limity vykonávania, ale hranicu prístupu Projektu nenahrádzajú.

Pamäť alebo sémantické vyhľadávanie nič nevracia

Skontrolujte, že spomienka existuje a má kategóriu. V Nastavenia → Modely overte, že je nastavený model pre embedding. Bez neho vyhľadávanie podľa významu nefunguje; vyhľadávanie podľa kľúčových slov môže ďalej fungovať.

Vyhľadávanie v dokumentácii (nástroj DocsSearch a Opýtať sa AI v palete príkazov) sa správa rovnako: s nastaveným modelom hľadá podľa významu aj kľúčových slov zároveň, bez neho len podľa kľúčových slov, a odpovedá okamžite, pretože na svoj index nečaká — ten sa zostavuje a obnovuje na pozadí.

Pamäť je súkromná pre účet, ak nepatrí do zdieľaného fondu Projektu. Spomienky zo zdieľaného fondu si vybavia len oprávnení členovia Projektu. Skrátenie kontextu mení kontext aktívnej konverzácie, nie uloženú pamäť.

Integrácia kanála mlčí

Spustite elowen doctor a potom skontrolujte nastavenia a pravidlá prístupu pluginu kanála:

• Plugin je zapnutý a jeho prihlasovacie údaje platia.
• Odosielateľ, server, chat alebo vlákno majú povolený prístup.
• Nastavenie odpovedí v skupinách a zmienok je splnené.
• Odosielateľ je prepojený alebo prijatý podľa pravidiel pluginu.

Pri webhooku za reverznou proxy smerujte /hooks/ na démona. Fungujúca webová aplikácia nedokazuje, že smerovanie webhookov je nastavené. Tokeny poskytovateľov nikdy nevkladajte do chatu ani do logov.

Objaví sa varovanie o disku hostiteľa

Administrátori dostanú varovanie, keď je súborový systém s dátami Elowen a spravovanými prostrediami zaplnený na 80 %. Varovanie sa zmení na kritické, keď zostáva menej ako 2 GiB a 5 % miesta. Na tomto súborovom systéme uvoľnite miesto. Upozornenia zmiznú, keď je miesta zase dosť. Aktuálne hodnoty disku nájdete v meradlách hostiteľa v Nastavenia → Systém.

Aplikácia hlási Vyžaduje sa licencia

Démon nemá použiteľnú licenciu: odpovedajú len licenčné cesty (GET /health, GET /setup, GET /licence, POST /licence/activate), všetko ostatné vracia licence_locked. Stránka uvedie dôvod; bežné opravy sú:

• Licencia nie je nainštalovaná — aktivujte príkazom elowen licence activate alebo zadajte kľúč na stránke.
• Nedostupný licenčný server po ochrannej lehote — obnovte serveru prístup na internet; démon sa sám ozve a do niekoľkých minút odomkne, ak je licencia uložená.
• Zamietnutý alebo cudzí server — licencia bola odvolaná, presunutá alebo patrí inému ID inštancie. Obráťte sa na podporu alebo aktivujte kľúč určený tomuto serveru.
• Vypršaná platnosť — predĺžte licenciu a potom aktivujte nový kľúč.
• Poškodený licence.json — démon nenastartuje a aktivácia súbor neopraví. Obnovte ho zo zálohy tej istej inštalácie alebo sa obráťte na podporu; nikdy ho nemažte.

Inštaláciu môže uzamknúť aj čas servera výrazne odlišný od skutočného; udržujte hodiny servera synchronizované. Úplný prehľad nájdete v článku Licencia.

Webová aplikácia sa nenačíta

Skontrolujte stav služieb a log webu:

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

Potom skontrolujte nastavený port webu, ELOWEN_DAEMON_URL, smerovanie streamovacích ciest v reverznej proxy a či má prehliadač aktuálne súbory. Démon načúva v predvolenom nastavení na localhoste; nevystavujte port 4400 priamo do internetu.

Po aktualizácii overte, že sú obe služby aktívne a že koncový bod stavu démona odpovedá:

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

Skrátenie kontextu stráca súvislosti alebo stále zlyháva

Pomocou /stats alebo /context si prezrite spotrebu; /compact vyžiada zhrnutie. Zhrnutie nezachová každú predchádzajúcu správu slovo po slove. Trvalé rozhodnutia ukladajte do pamäte alebo použite /new na čisté vyšetrovanie.

Ak automatické skracovanie opakovane zlyháva, skontrolujte log démona a model pre skrátenie kontextu zvolený pri účte. Limit neúspešných skrátení kontextu pri asistentovi zastaví automatické pokusy v predvolenom nastavení po troch neúspechoch za sebou, ručný /compact však zostáva dostupný. Konverzácia môže prestať skracovať aj vtedy, keď jej kontext po zhrnutí zostane na prahu alebo nad ním; /compact tam funguje ďalej a spoľahlivým riešením je nová konverzácia.

Kde nájsť logy a trvalé dáta

Nastavenia, účty a história konverzácií sú v databáze PostgreSQL, na ktorú ukazuje ELOWEN_DATABASE_URL. Súbory inštancie sú v ELOWEN_INSTANCE_ROOT, v predvolenom nastavení ~/.config/elowen, a adresár logov možno prepísať premennou 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áza nie je celá inštalácia. Ak je to možné, zálohujte celý konfiguračný adresár a databázu uchovávajte spolu so zodpovedajúcim plugin-secrets.key. Ak chcete dočasne zbierať podrobnejšie záznamy, nastavte ELOWEN_LOG_LEVEL=debug a potom vráťte info.

Aktualizácie, verzie a migrácie

Nainštalovanú inštanciu aktualizujete príkazom:

elowen update

Príkaz sa opýta licenčného servera na najnovšiu verziu jadra, ktorú licencia inštalácie pokrýva, stiahne ju, overí a nainštaluje, zatiaľ čo Elowen beží ďalej; spravované služby sa zastavia len krátko kvôli výmene balíčkov a reštartu. Kanál vydania cez npm neexistuje. Zamietnutá kontrola uvedie dôvod licenčného servera, zvyčajne odvolanú licenciu. Kópia zo zdrojov môže byť novšia než akákoľvek vydaná verzia, preto ju Elowen licencovanou verziou nenahradí. Automatické aktualizácie sa zapínajú v Nastavenia → Systém.

Ak sa aktualizácia preruší, elowen update --recover odstráni pripravené súbory, ktoré sa nikdy nevymenili, vráti zmenu prerušenú pred overením alebo dokončí publikovanie overeného commitu. Spustite ho pred ďalším pokusom o aktualizáciu.

Migrácie databázy prebehnú pri štarte novšej verzie démona. Pred skokom na inú verziu si vytvorte obnoviteľnú zálohu. Ak démon potom nenastartuje, uchovajte logy a prejdite journal, kým skúsite ďalšiu aktualizáciu. Nesnažte sa problém obísť zmazaním migračných súborov alebo zámkov.

Obnovenie a reset stavu

• Novú konverzáciu začnete príkazom /new, aktuálnu vyčistíte príkazom /clear.
• Jednotlivé spomienky alebo kategórie odstránite na stránke Pamäť.
• Príkazom elowen setup doplníte chýbajúce nastavenia.
• Na úplný reset Elowen zastavte a najprv si vytvorte overenú zálohu. Zmazanie priečinka inštancie alebo zrušenie databázy zničí uložené dáta. Databáza a priečinok inštancie s plugin-secrets.key patria k sebe; zálohujte ich a obnovujte ako pár. Logy zostávajú v priečinku inštancie alebo v ELOWEN_LOG_DIR, ak je nastavený.

Ďalej: Slovník pojmov