clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 48
colibri/docs/guide/sl/install/requirements.md
Sam & Claude ca087846ec
Some checks are pending
CI / rust (pull_request) Waiting to run
Details
CI / markdown (pull_request) Waiting to run
Details
CI / port (pull_request) Waiting to run
Details
CI / agent-jail-pkgs (pull_request) Waiting to run
Details
docs(sl): add glossary of abbreviations + link from all pages 
- New page: docs/guide/sl/reference/okrajsave.md (15 abbreviations
  explained in plain Slovenian — LLM, JSON, JSONL, ACL, PF, NAT,
  ZFS, API, HTTPS, TCP, SHA, BCP, ISO, UI, VPS)
- Linked from reference index
- First occurrence of each abbreviation in every Slovenian page
  now links to the glossary
- Fix broken ./install/ link (English + Slovenian)
- requirements title: 'Zahteve' → 'Osnovne zahteve'
- prettier-clean
2026-06-26 10:29:23 +02:00

3.3 KiB
Raw Blame History

title description
Osnovne zahteve 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.
  • 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 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.