diff --git a/docs/guide/sl/install/controlplane-install.md b/docs/guide/sl/install/controlplane-install.md new file mode 100644 index 0000000..cda105c --- /dev/null +++ b/docs/guide/sl/install/controlplane-install.md @@ -0,0 +1,24 @@ +--- +title: 'Namestitev krmilne ravnine' +description: Namestite krmilno ravnino Clawdie s standardnim orkestratorjem. +--- + +Krmilno ravnino namesti standardni orkestrator: + +```bash +just install +``` + +Korenska namestitev poganja krmilno ravnino kot storitev Clawdie, ki jo upravlja +gostitelj. Orkestrator skupaj nastavi PF, delovne ječe, PostgreSQL, hostd, +namestitev storitve, kontrolne točke in stanje za nadaljevanje. + +Če namestitev ne uspe, nadaljujte od neuspelega koraka: + +```bash +just install-from-db +just install-from hosts +just install -- --dry-run +``` + +Kanonično ime mostu Bastille/Warden je `warden0`. diff --git a/docs/guide/sl/install/iso.md b/docs/guide/sl/install/iso.md new file mode 100644 index 0000000..88a2d8e --- /dev/null +++ b/docs/guide/sl/install/iso.md @@ -0,0 +1,45 @@ +--- +title: Namestitev z ISO +description: Zagonske slike USB za fizično strojno opremo in namestitve brez povezave. +--- + +**Repozitorij:** `https://codeberg.org/Clawdie/Clawdie-ISO` +**Oznake:** `https://codeberg.org/Clawdie/Clawdie-ISO/tags` + +Ta stran pokriva izbiro slike in zapis na USB. Za nastavitev ob prvem zagonu +(`setup.txt`, zahtevane vrstice in kaj pričakovati) glejte +[Prvi zagon](../first-boot/). + +## Prenos + +Izberite sliko, ki ustreza vašemu cilju: + +- **Fizična strojna oprema:** namizje + paketi brez povezave za krajevne + namestitve +- **Oblak:** slika brez zaslona za postavitve v slogu VPS + +## Zapis na USB + +`/dev/daX` zamenjajte s pravo napravo. Pred zapisom cilj potrdite z +`camcontrol devlist` na FreeBSD ali `lsblk` na Linuxu. + +```bash +sudo dd if=clawdie-iso-baremetal-DD.mmm.YYYY.img of=/dev/daX bs=1M status=progress +``` + +Po zapisu lahko bodisi: + +- neposredno uredite nastavitev ob prvem zagonu (`setup.txt`) ali +- najprej zaženete neobvezni korak pregleda, da v `system.txt`, `system.env`, + `inspect-facts.env` in `suggested-setup.txt` zberete podatke o disku/omrežju +- neobvezno pustite, da pregled prazne vrednosti namestitve/shrambe vpiše nazaj + v `setup.txt` +- neobvezno pustite, da pregled prazna polja strojne opreme vpiše nazaj v + `system.env` + +Nato zaženite. Za ostalo glejte [Prvi zagon](../first-boot/). + +## Prilagoditev ali ponovna izgradnja + +Če potrebujete prilagojen nabor paketov ali želite vgraditi določeno različico +Clawdie, sledite navodilom za izgradnjo v repozitoriju Clawdie-ISO. diff --git a/docs/guide/sl/install/requirements.md b/docs/guide/sl/install/requirements.md new file mode 100644 index 0000000..8ddbf4c --- /dev/null +++ b/docs/guide/sl/install/requirements.md @@ -0,0 +1,68 @@ +--- +title: 'Zahteve' +description: Zahteve glede gostitelja, izvajalnega okolja in orodjarne za Clawdie. +--- + +Kaj potrebujete na gostitelju pred namestitvijo Clawdie. Namestitveni program z +ISO večino tega samodejno pripravi; namestitve na obstoječem gostitelju naj te +zahteve preverijo pred zagonom `just install`. + +## Gostitelj + +- **OS:** FreeBSD 15.x (ječe so edino podprto izvajalno okolje). +- **Pravice:** root ali uporabnik s `sudo` in dostopom do ZFS. +- **ZFS:** zahtevan za ječe Bastille. Posnetki se zajamejo ob mejnikih + namestitve, če obstaja `zroot/bastille`; sicer se tiho preskočijo. +- **Omrežje:** odhodni HTTPS za namestitev paketov, ponudnika LLM in Telegram. + Odhodni NAT prek PF nastavi namestitveni program. + +## Orodjarna + +- **Rust** prek rustup, nameščen pod `/opt/clawdie/rustup`. Potreben za domorodne + odvisnosti (SWC, tree-sitter). ISO ga namesti; namestitve na obstoječem + gostitelju ga zaženejo iz + [`Namestitvenega orkestratorja`](./install/). +- **Node.js + tsx** za namestitvene skripte in izvajalno okolje. +- **Bastille** za upravljanje ječ. + +## Filozofija izvajalnega okolja + +Clawdie je en sam proces Node.js, ki orkestrira agente v ječah. Oblikovne +zaveze, ki določajo, kaj potrebujete: + +- **Varnost prek izolacije na ravni OS.** Agenti tečejo znotraj ječ FreeBSD. + Dostop do lupine je varen, ker se izvaja znotraj ječe, ne na gostitelju. + Dostop do datotečnega sistema je omejen na izrecno priklopljene poti. +- **Dovolj majhno, da se prebere.** Brez mikrostoritev, brez čakalnih vrst + sporočil, brez abstrakcijskih plasti. En proces, peščica izvornih datotek. +- **Delovanje, prirojeno UI.** Koda predpostavlja, da imate sodelavca UI. + Operaterska orodja (nadzorna plošča, spremljanje) so tanka; pomočnik dopolni + vrzel s tem, da neposredno odgovarja na vprašanja o dnevnikih, stanju in + nastavitvah. +- **Prilagajanje = spremembe kode.** Sprožilna beseda in nekaj osnovnih + nastavitev živijo v `.env`. Vse drugo: uredite kodo. Koda je dovolj majhna, + da je to varno. + +## Stične površine za povezovanje + +- **Telegram** prek Bot API (`grammy`). Glavni vhodno-izhodni kanal. +- **PostgreSQL** za baze za delovanje, pomnilnik in vgrajeno znanje. Privzeto je + izvajanje na gostitelju (`DB_RUNTIME=host`); nastavite `DB_RUNTIME=jail`, da se + namesto tega pripravi namenska ječa db. +- **Ponudnik LLM** po vaši izbiri. OpenRouter je priporočena zagonska pot; po + namestitvi preklopite na neposredne ključe ponudnikov (zAI, Anthropic, OpenAI, + Gemini) ali na lokalni Ollama, tako da uredite `.env`. Glejte + [Preklop ponudnika ob napaki](../operate/provider-fallback/) za vedenje glede + zaznave omejitev in preklopa. + +## Model razširitev z veščinami + +Veščine so način, kako operaterji dodajajo zmožnosti brez razvejanja jedra. +Pogoste oblike veščin: + +- **Komunikacijski kanali** (`/add-slack`, `/add-discord` itd.) za razširitev + onkraj Telegrama. +- **Avtomatizacija brskalnika** prek `agent-browser`, ki teče znotraj ječe. +- **Načrtovana opravila**, registrirana glede na kontekst posamezne skupine. + +Veščine se namestijo v `data/skills/` in se naložijo ob zagonu.