<p align="center">
<img src="../../frontend/src/assets/images/logo-floatingball.png" width="150" height="150">
</p>

<h1 align="center">ChatClaw</h1>

<p align="center">
  <strong>5 minutah dobite osebnega agenta AI, kot je OpenClaw. Varnost Sandbox, majhen in hiter</strong>
</p>

<p align="center">
  <a href="README.md">English</a> |
  <a href="README_zh-CN.md">简体中文</a> |
  <a href="README_zh-TW.md">繁體中文</a> |
  <a href="README_ja-JP.md">日本語</a> |
  <a href="README_ko-KR.md">한국어</a> |
  <a href="README_ar-SA.md">العربية</a> |
  <a href="README_bn-BD.md">বাংলা</a> |
  <a href="README_de-DE.md">Deutsch</a> |
  <a href="README_es-ES.md">Español</a> |
  <a href="README_fr-FR.md">Français</a> |
  <a href="README_hi-IN.md">हिन्दी</a> |
  <a href="README_it-IT.md">Italiano</a> |
  <a href="README_pt-BR.md">Português</a> |
  <a href="README_sl-SI.md">Slovenščina</a> |
  <a href="README_tr-TR.md">Türkçe</a> |
  <a href="README_vi-VN.md">Tiếng Việt</a>
</p>

ChatClaw je odprtokodna lokalna baza znanja in grafična namizna pomočnica.
Brez programiranja — namestitev na lokalni računalnik z enim klikom. Povežite se s WeChat, DingTalk, WeCom, QQ, Feishu, WhatsApp in drugimi priljubljenimi messaging aplikacijami.
Pošljite ukaze in pustite, da umetna inteligenca izvaja naloge za vas. Vgrajena knjižnica spletnih več kot 5000 spretnosti, s podporo za upravljanje lokalne baze znanja v slogu IMA.

## Predogledi

### AI Chatbot Assistant

Postavite vprašanje svojemu AI pomočniku; inteligentno bo preiskal vašo zbirko znanja in ustvaril ustrezne odgovore. Z vgrajenim trgom spretnosti delujejo AI agenti avtonomno — brez potrebe po ročnem nadzoru. Od načrtovanja zapletenih projektov in organiziranja dokumentov do ustvarjanja PowerPointov ter izvajanja večstopenjskih nalog lahko AI agenti avtonomno analizirajo, učinkovito napredujejo in končno dostavijo popolne rezultate.

![](../../images/previews/en/image1.png)

![](../../images/previews/en/image2.png)

### Multi-Agent Mode, Tailored for Different Scenarios

Ustvarite več neodvisnih AI agentov, vsak s svojo osebnostjo, spominom in spretnostmi. Preklapljajte med njimi po potrebi brez motenj. Vsakemu agentu je mogoče dodeliti različne vloge (npr. "Služba za stranke", "Analitik podatkov", "Pomočnik za pisanje") ter konfigurirati različne spretnosti, zbirke znanja in sloge odgovorov.

![](../../images/previews/en/image3.png)

### Local Knowledge Base Management

Naložite svoje dokumente (TXT, PDF, Word, Excel, CSV, HTML, Markdown). Sistem samodejno razčleni, razdeli in pretvori v vektorske vložke, shranjene v vaši zasebni zbirki znanja za natančno pridobivanje in uporabo s strani AI. Podpira organiziranje dokumentov po mapah in zbirki znanja.

![](../../images/previews/en/image4.png)

### Skill Manager — AI Responds at Command

5000+ takoj uporabnih AI spretnosti pokriva produktivnost, razvojna orodja, multimedije, pametni dom in še več — AI naj dela za vas brez programiranja. Uporabite ukaze, da robot poišče nameščene funkcije ali namesti nove razširitvene vtičnike. Trg spretnosti — prosto brskajte in nameščajte spretnosti.

![](../../images/previews/en/image5.png)

### Memory — Natural & Smarter Interactions

Omogočite kontekstualne pogovore, prilagojene storitve, dokončanje zapletenih nalog ter stalno učenje in evolucijo. Robot postaja rastni spremljevalec, ki nudi vse bolj preudarno in inteligentno storitev.

![](../../images/previews/en/image6.png)

### Free Model Trial

En klik za avtorizacijo povezave s ChatWiki, sinhronizacijo kreditov, podporo merilom po meri. Vgrajeni visokokakovostni LLM: Ollama, Google Gemini, OpenAI in drugi — uporabite svoj priljubljeni AI model za pisarniško delo ali profesionalne scenarije.

![](../../images/previews/en/image7.png)

### Multi-Channel Remote Control via WeChat/QQ/WhatsApp

ChatClaw podpira več komunikacijskih kanalov ter pošilja rezultate analiz, opozorila spremljanja in raziskovalna povzetka neposredno na vaš telefon. Po obdelavi z AI se rezultati samodejno pošljejo v določen kanal. Pošljite ukaze v okno klepeta za daljinsko upravljanje izvajanja AI nalog.

![](../../images/previews/en/image8.png)

### Scheduled Tasks — Automated Execution

Nastavite pogostost spremljanja: vsakih 5 minut, na uro ali dnevno ob določenih časih. Grafični razporejevalnik s cron izrazi. Občasno pridobivajte strani ali vire podatkov, primerjajte spremembe, spremljajte ključne kazalnike in pošiljajte opozorila prek sporočilnih kanalov, ko zaznate nepravilnosti.

![](../../images/previews/en/image9.png)

### Text Selection for Instant Q&A

Izberite katero koli besedilo na zaslonu; samodejno se kopira v plavajoče polje za hitro vprašanje. En klik ga pošlje AI pomočniku za takojšen odgovor.

![](../../images/previews/en/image10.png)

### Smart Sidebar

Pametni pomočnik, ki se lahko pritrdi ob drugih oknih aplikacij. Hitro preklapljajte med različno konfiguriranimi AI pomočniki za zastavljanje vprašanj. Robot ustvarja odgovore na podlagi vaše povezane zbirke znanja in podpira pošiljanje odgovorov z enim klikom. Pametno plavajoče sledenje — vnos orodja je vedno pri roki.

![](../../images/previews/en/image11.png)

![](../../images/previews/en/image12.png)

### One Question, Multiple Answers: Compare with Ease

Ni potrebe po ponavljanju vprašanj. Hkrati se posvetujte z več "AI strokovnjaki", primerjajte njihove odgovore drug poleg drugega v istem vmesniku in pridite do najboljšega sklepa.

![](../../images/previews/en/image13.png)

### One-Click Launcher Ball

Kliknite plavajočo kroglico na namizju, da takoj prebudite ali odprete glavno okno aplikacije ChatClaw.

![](../../images/previews/en/image14.png)

### Community & Contact Us

Dobrodošli, da nas kontaktirate za pomoč ali podate predloge. WeChat: skenirajte QR kodo za vstop v tehnično izmenjevalno skupino ChatClaw. Pri dodajanju navedite "chatclaw".


## Namestitev v načinu strežnika


## Namestitev v načinu strežnika


## Namestitev v načinu strežnika


## Namestitev v načinu strežnika

ChatClaw lahko deluje kot strežnik (ni potrebna namizna GUI), dostopen prek brskalnika.

### Neposredna binarna datoteka

Prenesite binarno datoteko za svojo platformo z [GitHub Releases](https://github.com/chatwiki/chatclaw/releases):

|| Platforma | Datoteka |
||----------|------|
|| Linux x86_64 | `ChatClaw-server-linux-amd64` |
|| Linux ARM64 | `ChatClaw-server-linux-arm64` |

```bash
chmod +x ChatClaw-server-linux-amd64
./ChatClaw-server-linux-amd64
```

Odprite http://localhost:8080 v brskalniku.

Strežnik privzeto posluša na `0.0.0.0:8080`. Host in vrata lahko prilagodite prek okolijskih spremenljivk:

```bash
WAILS_SERVER_HOST=127.0.0.1 WAILS_SERVER_PORT=3000 ./ChatClaw-server-linux-amd64
```

### Docker

```bash
docker run -d \
  --name chatclaw-server \
  -p 8080:8080 \
  -v chatclaw-data:/root/.config/chatclaw \
  registry.cn-hangzhou.aliyuncs.com/chatwiki/chatclaw:latest
```

Odprite http://localhost:8080 v brskalniku.

### Docker Compose

Ustvarite datoteko `docker-compose.yml`:

```yaml
services:
  chatclaw:
    image: registry.cn-hangzhou.aliyuncs.com/chatwiki/chatclaw:latest
    container_name: chatclaw-server
    volumes:
      - chatclaw-data:/root/.config/chatclaw
    ports:
      - "8080:8080"
    restart: unless-stopped

volumes:
  chatclaw-data:
```

Nato zaženite:

```bash
docker compose up -d
```

Odprite http://localhost:8080 v brskalniku. Za zaustavitev: `docker compose down`. Podatki so shranjeni v volumnu `chatclaw-data`.

## Tehnološki sklad

|| Plast | Tehnologija |
||-------|-----------|
|| Namizno ogrodje | [Wails v3](https://wails.io/) (Go + WebView) |
|| Back-end jezik | [Go 1.26](https://go.dev/) |
|| Front-end ogrodje | [Vue 3](https://vuejs.org/) + [TypeScript](https://www.typescriptlang.org/) |
|| UI komponente | [shadcn-vue](https://www.shadcn-vue.com/) + [Reka UI](https://reka-ui.com/) |
|| Oblikovanje | [Tailwind CSS v4](https://tailwindcss.com/) |
|| Upravljanje stanja | [Pinia](https://pinia.vuejs.org/) |
|| Orodje za gradnjo | [Vite](https://vite.dev/) |
|| AI ogrodje | [Eino](https://github.com/cloudwego/eino) (ByteDance CloudWeGo) |
|| Ponudniki AI modelov | OpenAI / Claude / Gemini / Ollama / DeepSeek / Doubao / Qwen / Zhipu / Grok |
|| Podatkovna baza | [SQLite](https://www.sqlite.org/) + [sqlite-vec](https://github.com/asg017/sqlite-vec) (vektorsko iskanje) |
|| Mednarodizacija | [go-i18n](https://github.com/nicksnyder/go-i18n) + [vue-i18n](https://vue-i18n.intlify.dev/) |
|| Izvajalec nalog | [Task](https://taskfile.dev/) |
|| Ikone | [Lucide](https://lucide.dev/) |

## Struktura projekta

```
ChatClaw_D2/
├── main.go                     # Vstopna točka aplikacije
├── go.mod / go.sum             # Odvisnosti Go modula
├── Taskfile.yml                # Konfiguracija izvajalca nalog
├── build:                      # Konfiguracije gradnje in platformi sredstva
│   ├── config.yml              # Konfiguracija gradnje Wails
│   ├── darwin:                 # Nastavitve gradnje macOS in pooblastila
│   ├── windows:                # Namestitveni program Windows (NSIS/MSIX) in manifesti
│   ├── linux:                  # Pakiranje Linux (AppImage, nfpm)
│   ├── ios:                    # Nastavitve gradnje iOS
│   └── android:                # Nastavitve gradnje Android
├── frontend:                   # Vue 3 front-end aplikacija
│   ├── package.json            # Odvisnosti Node.js
│   ├── vite.config.ts          # Konfiguracija Vite bundlerja
│   ├── components.json         # Konfiguracija shadcn-vue
│   ├── index.html              # Vstop v glavno okno
│   ├── floatingball.html       # Vstop v okno plavajoče krogle
│   ├── selection.html          # Vstop v pojavno okno za izbiro besedila
│   ├── winsnap.html            # Vstop v okno Snap
│   └── src/
│       ├── assets:             # Ikone (SVG), slike in globalni CSS
│       ├── components:         # Skupne komponente
│       │   ├── layout:         # Postavitev aplikacije, stranski meni, naslovna vrstica
│       │   └── ui:             # Primitivi shadcn-vue (button, dialog, toast…)
│       ├── composables:        # Vue kompozicije (ponovno uporabna logika)
│       ├── i18n:               # Namestitev i18n za front-end
│       ├── locales:            # Prevajalne datoteke (zh-CN, en-US…)
│       ├── lib:                # Pomožne funkcije
│       ├── pages:              # Pogledi na ravni strani
│       │   ├── assistant:      # Stran AI pomočnika za klepet in komponente
│       │   ├── knowledge:      # Stran za upravljanje baze znanja
│       │   ├── multiask:       # Stran za primerjavo več modelov
│       │   └── settings:       # Stran z nastavitvami (ponudniki, modeli, orodja…)
│       ├── stores:             # Trgovine stanja Pinia
│       ├── floatingball:       # Mini aplikacija plavajoče krogle
│       ├── selection:          # Mini aplikacija za izbiro besedila
│       └── winsnap:            # Mini aplikacija za okno Snap
├── internal:                   # Zasebni Go paketi
│   ├── bootstrap:              # Inicializacija aplikacije in povezovanje
│   ├── define:                 # Konstant, vgrajeni ponudniki, okolijski zastavice
│   ├── device:                 # Identifikacija naprave
│   ├── eino:                   # Plast integracije AI/LLM
│   │   ├── agent:              # Orchesteracija agenta
│   │   ├── chatmodel:          # Tvornica modelov klepeta (več ponudnikov)
│   │   ├── embedding:          # Tvornica modelov vložkov
│   │   ├── filesystem:         # Orodja datotečnega sistema za AI agenta
│   │   ├── parser:             # Analizatorji dokumentov (PDF, DOCX, XLSX, CSV)
│   │   ├── processor:          # Cevovod za obdelavo dokumentov
│   │   ├── raptor:             # RAPTOR rekurzivno povzemanje
│   │   ├── splitter:           # Tvornica razdelilnikov besedila
│   │   └── tools:              # Integracije AI orodij (brskalnik, iskalnik, kalkulator…)
│   ├── errs:                   # Obravnava napak z zavedanjem i18n
│   ├── fts:                    # Žetonizator za iskanje polnega besedila
│   ├── logger:                 # Strukturirano beleženje
│   ├── services:               # Storitve poslovne logike
│   │   ├── agents:             # CRUD agenta
│   │   ├── app:                # Življenjski cikel aplikacije
│   │   ├── browser:            # Avtomatizacija brskalnika (chromedp)
│   │   ├── chat:               # Klepet in pretakanje
│   │   ├── conversations:      # Upravljanje pogovorov
│   │   ├── document:           # Nalaganje dokumentov in vektorizacija
│   │   ├── floatingball:       # Okno plavajoče krogle (več platform)
│   │   ├── i18n:               # i18n za back-end
│   │   ├── library:            # CRUD knjižnice znanja
│   │   ├── multiask:           # Q&A z več modeli
│   │   ├── providers:          # Konfiguracija ponudnika AI
│   │   ├── retrieval:          # Storitev pridobivanja RAG
│   │   ├── settings:          # Uporabniške nastavitve s predpomnilnikom
│   │   ├── textselection:      # Izbira besedila na zaslonu (več platform)
│   │   ├── thumbnail:          # Zajemanje sličic oken
│   │   ├── tray:               # Sistemska vrstica
│   │   ├── updater:            # Samodejna posodobitev (GitHub/Gitee)
│   │   ├── windows:            # Upravljanje oken in storitev Snap
│   │   └── winsnapchat:        # Storitev klepetalne seje Snap
│   ├── sqlite:                 # Plast podatkovne baze (Bun ORM + migracije)
│   └── taskmanager:            # Načrtovalnik nalog v ozadju
├── pkg:                         # Javni/ponovno uporabni Go paketi
│   ├── webviewpanel:           # Upravljalnik spletnega pogleda za več platform
│   ├── winsnap:                # Pogon za pripenjanje oken (macOS/Windows/Linux)
│   └── winutil:                # Pripomočki za aktivacijo oken
├── docs:                       # Dokumentacija za razvoj
└── images:                      # Posnetki zaslona README
```




