<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 dakikada OpenClaw benzeri kişisel AI ajanı edinin. Sandbox güvenliği, küçük ve hızlı</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 açık kaynaklı bir yerel bilgi tabanı ve OpenClaw grafik masaüstü asistan uygulamasıdır.
Programlama gerektirmez — tek tıklamayla yerel bilgisayarınıza dağıtın. WeChat, DingTalk, WeCom, QQ, Feishu, WhatsApp ve diğer ana mesajlaşma uygulamalarına bağlanın.
Komut gönderin ve AI'ın sizin için görevleri yerine getirmesine izin verin. Entegre 5000'den fazla beceri kitaplığı ve IMA tarzı yerel bilgi tabanı yönetimi desteği.

## Önizlemeler

### AI Chatbot Assistant

AI asistanınıza herhangi bir soru sorun; bilgi tabanınızı akıllıca arayacak ve ilgili yanıtlar üretecektir. Yerleşik Yetenek Pazarı ile AI Ajanları özerk olarak çalışır — tüm süreç boyunca manuel denetim gerektirmez. Karmaşık proje planlaması, belge organizasyonu, PPT oluşturma veya çok adımlı görev yürütme olsun, AI Ajanları özerk olarak analiz edebilir, verimli bir şekilde ilerleyebilir ve sonunda tam sonuçlar sunabilir.

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

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

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

Her birinin kendine özgü kişiliği, belleği ve yetenekleri olan birden fazla bağımsız AI Ajanı oluşturun. İhtiyaç duyduğunuzda aralarında kesinti olmadan geçiş yapın. Her Ajan'a farklı roller (örn. "Müşteri Hizmetleri", "Veri Analisti", "Yazım Asistanı") atanabilir ve farklı yetenekler, bilgi tabanları ve yanıt stilleriyle yapılandırılabilir.

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

### Local Knowledge Base Management

Belgelerinizi yükleyin (TXT, PDF, Word, Excel, CSV, HTML, Markdown). Sistem bunları otomatik olarak ayrıştırır, böler ve AI tarafından hassas alma ve kullanım için özel bilgi tabanınızda saklanan vektör gömüleri dönüştürür. Belgelerin klasöre ve bilgi tabanına göre düzenlenmesini destekler.

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

### Skill Manager — AI Responds at Command

5000+ kullanıma hazır AI yeteneği üretkenlik, geliştirme araçları, multimedya, akıllı ev ve daha fazlasını kapsar — programlama yapmadan AI'nın sizin için çalışmasını sağlar. Yüklü özellikleri bulmak veya yeni uzantı eklentileri yüklemek için komutları kullanın. Yetenek Pazarı — yetenekleri özgürce göz atın ve yükleyin.

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

### Memory — Natural & Smarter Interactions

Bağlamsal konuşmaları etkinleştirin, kişiselleştirilmiş hizmet sunun, karmaşık görevleri tamamlayın ve sürekli öğrenme ve evrime izin verin. Robot, giderek daha düşünceli ve akıllı hizmet sunan büyüyen bir arkadaş haline gelir.

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

### Free Model Trial

ChatWiki'ye bağlanmak için tek tıkla yetkilendirme, kredi senkronizasyonu, özel model desteği. Ollama, Google Gemini, OpenAI ve daha fazlası gibi yerleşik yüksek kaliteli LLM'ler — ofis işleri veya profesyonel senaryolar için favori AI modelinizi kullanın.

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

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

ChatClaw birden fazla mesaj kanalını destekler, analiz sonuçlarını, izleme uyarılarını ve araştırma özetlerini doğrudan telefonunuza gönderir. AI işlemeden sonra sonuçlar otomatik olarak belirlenen kanala gönderilir. Sohbet penceresinde komutlar göndererek AI görev yürütmeyi uzaktan kontrol edin.

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

### Scheduled Tasks — Automated Execution

İzleme sıklığını ayarlayın: her 5 dakikada bir, saatlik veya günlük olarak belirli saatlerde. Cron ifadeleriyle grafik zamanlayıcı. Düzenli olarak sayfaları veya veri kaynaklarını getirin, değişiklikleri karşılaştırın, temel göstergeleri izleyin ve anomaliler tespit edildiğinde mesaj kanalları aracılığıyla uyarı gönderin.

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

### Text Selection for Instant Q&A

Ekrandaki herhangi bir metni seçin; otomatik olarak yüzen bir hızlı-soru kutusuna kopyalanır. Tek tıklama ile anında yanıt için AI asistanına gönderilir.

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

### Smart Sidebar

Diğer uygulama pencerelerinin yanına yaslanabilen akıllı bir asistan. Sorular sormak için farklı yapılandırılmış AI asistanları arasında hızla geçiş yapın. Robot, ilişkili bilgi tabanınıza göre yanıtlar oluşturur ve tek tıklama ile yanıt göndermeyi destekler. Akıllı kayan takip — araç girişi her zaman elinizin altında.

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

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

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

Soruları tekrarlamanıza gerek yok. Aynı anda birden fazla "AI uzmanına" danışın, yanıtlarını aynı arayüzde yan yana karşılaştırın ve en iyi sonuca ulaşın.

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

### One-Click Launcher Ball

ChatClaw ana uygulama penceresini anında uyandırmak veya açmak için masaüstünüzdeki kayan topa tıklayın.

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

### Community & Contact Us

Yardım için veya öneri sunmak için bizimle iletişime geçmenizi bekliyoruz. WeChat: ChatClaw teknik paylaşım grubuna katılmak için QR kodunu tarayın. Eklerken lütfen "chatclaw" belirtin.


## Sunucu Modu Dağıtımı


## Sunucu Modu Dağıtımı


## Sunucu Modu Dağıtımı


## Sunucu Modu Dağıtımı

ChatClaw sunucu modunda çalıştırılabilir (masaüstü GUI gerekmez), tarayıcı üzerinden erişilebilir.

### İkili Dosyayı Doğrudan Çalıştır

Platformunuz için ikili dosyayı [GitHub Releases](https://github.com/chatwiki/chatclaw/releases)'den indirin:

|| Platform | Dosya |
||----------|------|
|| Linux x86_64 | `ChatClaw-server-linux-amd64` |
|| Linux ARM64 | `ChatClaw-server-linux-arm64` |

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

Tarayıcınızda http://localhost:8080'i açın.

Sunucu varsayılan olarak `0.0.0.0:8080` dinler. Ana bilgisayar ve bağlantı noktasını ortam değişkenleri aracılığıyla özelleştirebilirsiniz:

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

Tarayıcınızda http://localhost:8080'i açın.

### Docker Compose

Bir `docker-compose.yml` dosyası oluşturun:

```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:
```

Ardından çalıştırın:

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

Tarayıcınızda http://localhost:8080'i açın. Durdurmak için: `docker compose down`. Veriler `chatclaw-data` hacminde kalıcıdır.

## Teknoloji Yığını

|| Katman | Teknoloji |
||-------|-----------|
|| Masaüstü Çerçevesi | [Wails v3](https://wails.io/) (Go + WebView) |
|| Arka Uç Dili | [Go 1.26](https://go.dev/) |
|| Ön Uç Çerçevesi | [Vue 3](https://vuejs.org/) + [TypeScript](https://www.typescriptlang.org/) |
|| UI Bileşenleri | [shadcn-vue](https://www.shadcn-vue.com/) + [Reka UI](https://reka-ui.com/) |
|| Stil | [Tailwind CSS v4](https://tailwindcss.com/) |
|| Durum Yönetimi | [Pinia](https://pinia.vuejs.org/) |
|| Yapı Aracı | [Vite](https://vite.dev/) |
|| AI Çerçevesi | [Eino](https://github.com/cloudwego/eino) (ByteDance CloudWeGo) |
|| AI Model Sağlayıcıları | OpenAI / Claude / Gemini / Ollama / DeepSeek / Doubao / Qwen / Zhipu / Grok |
|| Veritabanı | [SQLite](https://www.sqlite.org/) + [sqlite-vec](https://github.com/asg017/sqlite-vec) (vektör arama) |
|| Uluslararasılaştırma | [go-i18n](https://github.com/nicksnyder/go-i18n) + [vue-i18n](https://vue-i18n.intlify.dev/) |
|| Görev Çalıştırıcı | [Task](https://taskfile.dev/) |
|| İkonlar | [Lucide](https://lucide.dev/) |

## Proje Yapısı

```
ChatClaw_D2/
├── main.go                     # Uygulama giriş noktası
├── go.mod / go.sum             # Go modülü bağımlılıkları
├── Taskfile.yml                # Görev çalıştırıcı yapılandırması
├── build/                      # Yapı yapılandırmaları ve platform varlıkları
│   ├── config.yml              # Wails yapı yapılandırması
│   ├── darwin/                 # macOS yapı ayarları ve yetkilendirmeler
│   ├── windows/                # Windows yükleyici (NSIS/MSIX) ve bildirimler
│   ├── linux/                  # Linux paketleme (AppImage, nfpm)
│   ├── ios/                    # iOS yapı ayarları
│   └── android:                # Android yapı ayarları
├── frontend:                   # Vue 3 ön uç uygulaması
│   ├── package.json            # Node.js bağımlılıkları
│   ├── vite.config.ts          # Vite paketleyici yapılandırması
│   ├── components.json         # shadcn-vue yapılandırması
│   ├── index.html              # Ana pencere girişi
│   ├── floatingball.html       # Top pencere girişi
│   ├── selection.html          # Metin seçimi açılır penceresi girişi
│   ├── winsnap.html            # Yakalama penceresi girişi
│   └── src/
│       ├── assets:             # İkonlar (SVG), resimler ve genel CSS
│       ├── components:         # Paylaşılan bileşenler
│       │   ├── layout:         # Uygulama düzeni, kenar çubuğu, başlık çubuğu
│       │   └── ui:             # shadcn-vue ilkelleri (düğme, iletişim kutusu, bildirim…)
│       ├── composables:        # Vue bileşenleri (yeniden kullanılabilir mantık)
│       ├── i18n:               # Ön uç i18n kurulumu
│       ├── locales:            # Çeviri dosyaları (zh-CN, en-US…)
│       ├── lib:                # Yardımcı işlevler
│       ├── pages:              # Sayfa düzeyinde görünümler
│       │   ├── assistant:      # AI sohbet asistanı sayfası ve bileşenleri
│       │   ├── knowledge:      # Bilgi tabanı yönetimi sayfası
│       │   ├── multiask:       # Çoklu model karşılaştırma sayfası
│       │   └── settings:       # Ayarlar sayfası (sağlayıcılar, modeller, araçlar…)
│       ├── stores:             # Pinia durum depoları
│       ├── floatingball:       # Toplu mini uygulama
│       ├── selection:          # Metin seçimi mini uygulaması
│       └── winsnap:            # Yakalama penceresi mini uygulaması
├── internal:                   # Özel Go paketleri
│   ├── bootstrap:              # Uygulama başlatma ve kablolama
│   ├── define:                 # Sabitler, yerleşik sağlayıcılar, ortam bayrakları
│   ├── device:                 # Cihaz tanımlama
│   ├── eino:                   # AI/LLM entegrasyon katmanı
│   │   ├── agent:              # Ajan orkestrasyonu
│   │   ├── chatmodel:          # Sohbet modeli fabrikası (çoklu sağlayıcı)
│   │   ├── embedding:          # Gömme modeli fabrikası
│   │   ├── filesystem:         # AI Ajanı dosya sistemi araçları
│   │   ├── parser:             # Belge ayrıştırıcıları (PDF, DOCX, XLSX, CSV)
│   │   ├── processor:          # Belge işleme hattı
│   │   ├── raptor:             # RAPTOR özyinelemeli özetleme
│   │   ├── splitter:           # Metin bölücü fabrikası
│   │   └── tools:              # AI araç entegrasyonları (tarayıcı, arama, hesap makinesi…)
│   ├── errs:                   # i18n farkındalıklı hata işleme
│   ├── fts:                    # Tam metin arama belirteci
│   ├── logger:                 # Yapılandırılmış günlük
│   ├── services:               # İş mantığı hizmetleri
│   │   ├── agents:             # Ajan CRUD
│   │   ├── app:                # Uygulama yaşam döngüsü
│   │   ├── browser:            # Tarayıcı otomasyonu (chromedp)
│   │   ├── chat:               # Sohbet ve akış
│   │   ├── conversations:      # Konuşma yönetimi
│   │   ├── document:           # Belge yükleme ve vektörleştirme
│   │   ├── floatingball:       # Toplu pencere (çapraz platform)
│   │   ├── i18n:               # Arka uç i18n
│   │   ├── library:            # Bilgi kütüphanesi CRUD
│   │   ├── multiask:           # Çoklu model S&C
│   │   ├── providers:          # AI sağlayıcı yapılandırması
│   │   ├── retrieval:          # RAG alma hizmeti
│   │   ├── settings:           # Önbellekli kullanıcı ayarları
│   │   ├── textselection:      # Ekran metin seçimi (çapraz platform)
│   │   ├── thumbnail:          # Pencere küçük resim yakalama
│   │   ├── tray:               # Sistem tepsisi
│   │   ├── updater:            # Otomatik güncelleme (GitHub/Gitee)
│   │   ├── windows:            # Pencere yönetimi ve yakalama hizmeti
│   │   └── winsnapchat:        # Yakalama sohbet oturumu hizmeti
│   ├── sqlite:                 # Veritabanı katmanı (Bun ORM + geçişler)
│   └── taskmanager:            # Arka plan görev zamanlayıcı
├── pkg:                         # Genel/yeniden kullanılabilir Go paketleri
│   ├── webviewpanel:           # Çapraz platform WebView panel yöneticisi
│   ├── winsnap:                # Pencere yakalama motoru (macOS/Windows/Linux)
│   └── winutil:                # Pencere etkinleştirme yardımcı programları
├── docs:                       # Geliştirme belgeleri
└── images:                      # README ekran görüntüleri
```




