docs(sl): translate stable install pages (requirements, iso, controlplane)
Some checks are pending
CI / rust (pull_request) Waiting to run
CI / markdown (pull_request) Waiting to run
CI / port (pull_request) Waiting to run
CI / agent-jail-pkgs (pull_request) Waiting to run

Slovenian batch 2 (install/, stable subset): requirements.md, iso.md,
controlplane-install.md. Deliberately skips first-boot.md and install.md —
both carry in-repo "will be rewritten after live ISO validation" notes, so
translating them now would be wasted effort. Commands/URLs/env-vars kept in
English; prose + frontmatter + tables translated. prettier-clean, no IPs.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Sam & Claude 2026-06-26 10:04:50 +02:00
parent ba19a5e2ca
commit 331456b11c
3 changed files with 137 additions and 0 deletions

View file

@ -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`.

View file

@ -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.

View file

@ -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.