Navigácia
ELOWEN · Dokumentácia

Posledná aktualizácia: 27. októbra 2026

Prechádzať dokumentáciu · Keď nefunguje server alebo služba
Prevádzka a aktualizácie

Keď nefunguje server alebo služba

Nájdite nižšie svoj príznak, skontrolujte pravdepodobnú príčinu a prejdite očíslované kroky. Tento návod sa týka inštalácie; čo vidí človek v prehliadači, začína v návode Keď niečo nejde.

Nič nefunguje a potrebujete kontrolu stavu

Prečo: jeden príkaz ukáže, či sú pripravené démon, poskytovatelia, pamäť a pluginy.

  1. Zastaveného démona spustite príkazom elowen up.
  2. Spustite elowen doctor; skript môže namiesto prihlásenia odovzdať existujúci token: ELOWEN_TOKEN='…' elowen doctor.
  3. Bez uloženého prihlásenia CLI sa opýta na používateľské meno a heslo administrátora; bez terminálu vypíše, čo máte spustiť.

Tip: Pri dvojfázovom overení potvrďte prihlásenie CLI v prehliadači. elowen setup spúšťa rovnaké kontroly.

Služba nebeží

Prečo: démon obsluhuje API, konverzácie, úložisko, pluginy a prácu na pozadí; webová služba dodáva aplikáciu.

  1. Spustite elowen status.
  2. Spustite ich alebo reštartujte pomocou elowen up alebo elowen restart all.
  3. elowen down obe zastaví a počká, kým sa aktívna práca upokojí; --force túto prácu zastaví hneď.
  4. Na hostiteľovi so systemd si prečítajte jednotky a ich 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čí hneď po štarte

Prečo: obsadený port, staré Node.js, nezodpovedajúce zálohy alebo zdrojové zostavenie bez webového buldu.

  1. Skontrolujte porty, verziu Node.js a protokol:
ss -ltnp | grep -E ':(4400|4500)\b'
node --version
journalctl -u elowen-daemon -n 100 --no-pager
  1. Uvoľnite port, ak ho drží iný proces.
  2. Prejdite na Node.js 22.19.0 alebo novší.
  3. Obnovte databázu a jej plugin-secrets.key z tej istej zálohy.
  4. Pri zdrojovom checkoutu zostavte aj webovú aplikáciu.

Odpoveď nikdy nepríde

Prečo: ťah môže čakať na odpoveď, poskytovateľ môže zlyhávať alebo je kontext plný.

  1. Spustite elowen doctor a elowen status.
  2. /stats v chate ukáže model, spotrebu a kontext; /context v CLI kontext rozpíše.
  3. Protokol démona môže uviesť chyby poskytovateľa, limity rýchlosti, prepadnuté prihlasovacie údaje a obnovu po prerušení.
  4. Čakajúcu otázku alebo schválenie zodpovedzte na tej istej ploche; naplánované úlohy a delegovaná práca to nevedia, aj keď niektoré kanály ponuky vybavia.
  5. /compact zhrnie staršie správy; /new začne znova.

Zhrnutie nie je doslovná kópia, preto si trvalé rozhodnutia ukladajte do pamäte.

Spinner môže tiež znamenať, že je rozbitá proxy alebo prúd udalostí: skontrolujte konzolu prehliadača a protokol démona. Pri obnove spojenia sa zobrazí jeden riadok, napríklad „Obnova spojenia 2/5 · ďalší pokus o 2 s“.

Chýba nástroj alebo plugin

Prečo: plugin môže byť vypnutý, nepridelený, alebo mu chýbajú prihlasovacie údaje.

  1. Otvorte Nastavenia → Pluginy a overte, že je plugin zapnutý.
  2. Overte, že účet má plugin pridelený.
  3. Doplňte nastavenia a prihlasovacie údaje a potom skontrolujte Schopnosti a Aktivita, či neukazujú chybu načítania.
  4. Spustite /tools a vypíšte aktívne nástroje pluginov aj s ich vlastníkmi; každý účet vidí svoje príkazy a pridelené pluginy.

Server MCP sa spravuje v časti MCP: opravte jeho adresu alebo príkaz a potom ho znova pripojte. Zmena sa môže zobrazovať ako čakajúca, kým sa práca neupokojí, preto ju nezadávajte dvakrát; úpravy skillov reštart nepotrebujú.

Nástroj alebo príkaz je zakázaný

Prečo: zakazuje ho pravidlo oprávnenia, alebo práca beží tam, kde ju nikto nemôže schváliť.

  1. Otvorte Účet → Modely a nájdite Oprávnenia príkazov a Pravidlá nástrojov.
  2. Prečítajte pravidlá pre daný príkaz: každé povolí, opýta sa alebo zakáže a platí posledná zhoda.
  3. Zmeňte zakazujúce pravidlo, alebo zaň pridajte konkrétnejšie povoľovacie pravidlo.
  4. /yolo v CLI schváli oprávnené otázky len pre túto reláciu; nikdy neprebije zákaz ani striktné blokovanie behov bez obsluhy.

Delegovaná práca si drží hranicu, s ktorou začala, takže zmeny účtu bežiaci potomok nerozšíria. Režim len na čítanie je zábrana, nie sandbox.

Delegovaná práca alebo workflow zlyhá

Prečo: chyba runnera môže ovplyvniť delegovanú prácu bez toho, aby zastavila bežný chat, a prerušené workflow nechá nedokončené kroky.

  1. Otvorte prehľad delegovanej práce v nadradenej konverzácii a prečítajte protokol démona.
  2. Kým rovnakú úlohu spustíte znova, zistite, či potomok skončil, beží alebo bol prerušený.
  3. Obnovte workflow pomocou WorkflowResume; dokončené kroky sa neopakujú.

Projekt alebo adresár je nesprávny

Prečo: konverzácia beží v jednom Projekte a jednom pracovnom adresári a Git worktree sa použije len vtedy, keď naň konverzácia ukazuje.

  1. Overte zvolený Projekt v časti Projekty.
  2. V CLI /project prepne konverzáciu na iný Projekt. /cd vypíše alebo zmení vlastný pracovný adresár terminálu.
  3. Namierte konverzáciu na adresár worktree.

Delegovaná práca dedí Projekt a adresár volajúceho; režimy plánu a len na čítanie pridávajú limity, ale hranicu Projektu zachovávajú.

Pamäť alebo hľadanie nič nevracia

Prečo: pamäť môže chýbať alebo byť nezaradená, alebo nie je nakonfigurovaný embedding model.

  1. Overte, že pamäť existuje a má kategóriu; pamäte bez kategórie sa zvyčajne nepripomínajú.
  2. V Nastavenia → Modely overte, že je nakonfigurovaný embedding model. Bez neho hľadanie podľa významu nefunguje, aj keď kľúčové hľadanie môže ďalej fungovať.

Pamäť je súkromná pre účet, ak nepatrí do zdieľaného fondu Projektu, a pamäte z fondu si vybavia len oprávnení členovia Projektu.

Hľadanie v dokumentácii (nástroj DocsSearch a voľba Opýtať sa AI v palete príkazov) funguje rovnako: porovnáva význam aj kľúčové slová, alebo bez modelu len kľúčové slová, a odpovedá okamžite, pretože sa jeho index zostavuje na pozadí.

Skrátenie kontextu mení bežiaci kontext, nie uloženú pamäť.

Kanál mlčí

Prečo: správu blokuje plugin, jeho prístupové pravidlá alebo cesta platformy.

  1. Spustite elowen doctor a potom otvorte nastavenia pluginu kanála.
  2. Skontrolujte, že je plugin zapnutý a jeho prihlasovacie údaje platné.
  3. Skontrolujte, že odosielateľ, server, chat alebo vlákno sú povolené a že sú splnené nastavenia odpovedí v skupine a zmienok.
  4. Skontrolujte, že odosielateľ je prepojený alebo prijatý podľa pravidiel pluginu.
  5. Za reverznou proxy smerujte /hooks/ na démona; funkčná webová aplikácia nepreukazuje, že smerovanie webhookov funguje.

Upozornenie: Tokeny poskytovateľov nikdy nevkladajte do chatu ani do protokolov.

Zobrazí sa upozornenie na disk

Prečo: súborový systém s dátami Chettyho a spravovanými prostrediami je zaplnený na 80 %.

  1. Prečítajte aktuálne hodnoty v meradlách hostiteľa v Nastavenia → Systém.
  2. Uvoľnite miesto na tomto súborovom systéme; upozornenie zmizne, keď bude miesta dosť.
  3. Upozornenie sa zmení na kritické, keď zostáva menej ako 2 GiB a 5 % miesta.

Aplikácia zobrazuje Vyžaduje sa licencia

Prečo: démon nemá použiteľnú licenciu, takže odpovedá len licenčná stránka.

  1. Prečítajte dôvod, ktorý stránka uvádza.
  2. Zadajte kľúč na stránke, alebo spustite elowen licence activate.
  3. Po výpadku obnovte prístup k internetu; démon sa ozve sám a do niekoľkých minút odomkne.

Upozornenie: Poškodený súbor s licenciou zastaví démona a iný kľúč ho nespraví. Obnovte ho zo zálohy tej istej inštalácie a nikdy ho nemažte.

Hodiny výrazne mimo skutočného času tiež môžu inštanciu zamknúť; udržujte ich synchronizované. Licencia a aktivácia vysvetľuje všetky dôvody a opravu každého z nich.

Webová aplikácia sa nenačíta

Prečo: je nesprávna webová služba, jej port, adresa démona alebo cesta proxy pre streamovanie.

  1. Spustite elowen status a prečítajte protokol webu:
elowen status
journalctl -u elowen-web -n 100 --no-pager
  1. Skontrolujte webový port, ELOWEN_DAEMON_URL a cesty proxy pre streamovanie, potom obnovte stránku, aby si prehliadač načítal aktuálne súbory.
  2. Po aktualizácii overte, že obe služby bežia a démon odpovedá:
systemctl is-active elowen-daemon elowen-web
curl -fsS http://127.0.0.1:4400/health

Démon predvolene počúva na localhoste; nevystavujte port 4400 do internetu.

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

Prečo: zhrnutie zachováva podstatu, nie každú správu, a automatické pokusy sa po opakovaných zlyhaniach zastavia.

  1. Rozhodnutia, ktoré musia vydržať, ukladajte do pamäte, alebo začnite čisté vyšetrovanie cez /new.
  2. Keď automatické skrátenie stále zlyháva, prečítajte protokol démona a skontrolujte Model na skrátenie kontextu účtu.
  3. Spustite /compact ručne; Limit neúspešných skrátení kontextu zastaví automatické pokusy po troch zlyhaniach za sebou.

Konverzácia môže prestať skracovať aj vtedy, keď jej kontext po zhrnutí zostane na prahu alebo nad ním; /compact tam stále funguje a spoľahlivým riešením je nová konverzácia.

Potrebujete protokoly alebo súbory inštancie

Prečo: nastavenia, účty a história konverzácií sú v PostgreSQL, zatiaľ čo súbory inštancie ležia v priečinku inštancie.

  1. Umiestnenie zistíte z ELOWEN_DATABASE_URL, ELOWEN_INSTANCE_ROOT (predvolene ~/.config/elowen) a ELOWEN_LOG_DIR.
  2. Hľadajte tieto súbory:
~/.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. Pre dočasné podrobnosti nastavte ELOWEN_LOG_LEVEL=debug a potom vráťte info.

Databáza nie je celá inštalácia: zálohujte celý konfiguračný priečinok a databázu uchovávajte so zodpovedajúcim plugin-secrets.key.

Aktualizácia zlyhá alebo nová verzia nenastartuje

Prečo: aktualizátor overí vydanie proti licencii a migrácie bežia pri štarte novšej verzie.

  1. Spustite elowen update, a po prerušení spustite elowen update --recover, kým skúsite ďalšiu aktualizáciu.
  2. Ponechajte protokoly a obnovte zálohu, keď nová verzia nenastartuje; nikdy nemažte migračné ani zámkové súbory.

Obnova prerušenej aktualizácie vysvetľuje, čo príkaz na obnovu robí a ako vyriešiť odmietnutú alebo neúspešnú aktualizáciu.

Chcete obnoviť alebo resetovať stav

Prečo: rôzne problémy potrebujú rôzny reset a úplný reset zničí uložené dáta.

  1. Začnite novú konverzáciu cez /new, alebo aktuálnu vyprázdnite cez /clear.
  2. Odoberte pamäte alebo kategórie na stránke Pamäť.
  3. Spustite elowen setup a doplňte chýbajúcu konfiguráciu.
  4. Pred úplným resetom Chetty zastavte a vytvorte overenú zálohu.

Upozornenie: Databáza a priečinok inštancie s plugin-secrets.key patria k sebe: zálohujte ich a obnovujte ako pár. Odstránenie priečinka inštancie alebo zahozenie databázy zničí uložené dáta. Protokoly zostávajú v priečinku inštancie, alebo v ELOWEN_LOG_DIR, ak je nastavený.