<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>Obtenez un agent AI personnel comme OpenClaw en 5 minutes. Sécurité Sandbox, petit et rapide</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 est une application d'assistant de bureau graphique OpenClaw et de base de connaissances locale open source.
Aucune programmation requise — déployez sur votre ordinateur local en un clic. Connectez-vous à WeChat, DingTalk, WeCom, QQ, Feishu, WhatsApp et autres applications de messagerie grand public.
Envoyez des commandes et laissez l'IA exécuter des tâches pour vous. Bibliothèque de compétences intégrée OpenClaw 5000+, avec support de gestion de base de connaissances locale de type IMA.

## Aperçus

### AI Chatbot Assistant

Posez n'importe quelle question à votre assistant IA ; il recherchera intelligemment dans votre base de connaissances et générera des réponses pertinentes. Avec le marché de compétences intégré, les agents IA travaillent de manière autonome, sans nécessiter de supervision manuelle. Qu'il s'agisse de planification de projet complexe, d'organisation de documents, de génération de PowerPoint ou d'exécution de tâches multi-étapes, les agents IA peuvent analyser de manière autonome, avancer efficacement et livrer des résultats complets.

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

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

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

Créez plusieurs agents IA indépendants, chacun avec sa propre personnalité, mémoire et compétences. Basculez entre eux à la demande sans interférence. Chaque agent peut se voir attribuer différents rôles (p. ex. « Service Client », « Analyste de Données », « Assistant de Rédaction ») et être configuré avec différentes compétences, bases de connaissances et styles de réponse.

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

### Local Knowledge Base Management

Téléchargez vos documents (TXT, PDF, Word, Excel, CSV, HTML, Markdown). Le système analyse, divise et convertit automatiquement en insertions vectorielles stockées dans votre base de connaissances privée pour une récupération et une utilisation précises par l'IA. Prend en charge l'organisation des documents par dossier et par base de connaissances.

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

### Skill Manager — AI Responds at Command

5000+ compétences IA prêtes à l'emploi couvrent la productivité, les outils de développement, le multimédia, la maison intelligente et plus encore. Laissez l'IA travailler pour vous sans programmation. Utilisez des commandes pour que le robot trouve les fonctions installées ou installe de nouveaux plugins d'extension. Marché des compétences — parcourir et installer librement des compétences.

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

### Memory — Natural & Smarter Interactions

Activez les conversations contextuelles, proposez un service personnalisé, accomplissez des tâches complexes et évoluez par l'apprentissage continu. Le robot devient un compagnon en croissance qui fournit un service de plus en plus réfléchi et intelligent.

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

### Free Model Trial

Autorisation en un clic pour se connecter à ChatWiki, synchroniser les crédits, supporter les modèles personnalisés. LLMs intégrés de haute qualité : Ollama, Google Gemini, OpenAI et plus encore. Utilisez votre modèle IA préféré pour le travail de bureau ou les scénarios professionnels.

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

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

ChatClaw prend en charge plusieurs canaux de messages, envoyant des résultats d'analyse, des alertes de surveillance et des synthèses de recherche directement sur votre téléphone. Après le traitement IA, les résultats sont automatiquement envoyés au canal désigné. Envoyez des commandes dans la fenêtre de chat pour contrôler à distance l'exécution des tâches IA.

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

### Scheduled Tasks — Automated Execution

Définissez la fréquence de surveillance : toutes les 5 minutes, toutes les heures ou quotidiennement à des heures fixes. Planificateur graphique avec expressions cron. Récupérez périodiquement des pages ou des sources de données, comparez les changements, surveillez les indicateurs clés et envoyez des alertes via les canaux de messages lorsqu'une anomalie est détectée.

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

### Text Selection for Instant Q&A

Sélectionnez n'importe quel texte à l'écran ; il est automatiquement copié dans une boîte de question rapide flottante. Un clic l'envoie à l'assistant IA pour une réponse instantanée.

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

### Smart Sidebar

Un assistant intelligent qui peut s'ancrer à côté d'autres fenêtres d'application. Basculez rapidement entre des assistants IA différemment configurés pour poser des questions. Le robot génère des réponses basées sur votre base de connaissances associée et prend en charge l'envoi de réponses en un clic. Suivi flottant intelligent — l'accès aux outils toujours à portée de main.

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

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

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

Pas besoin de répéter les questions. Consultez plusieurs « experts IA » simultanément, comparez leurs réponses côte à côte dans la même interface et parvenez à la meilleure conclusion.

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

### One-Click Launcher Ball

Cliquez sur la boule flottante sur votre bureau pour réveiller ou ouvrir instantanément la fenêtre de l'application principale ChatClaw.

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

### Community & Contact Us

Bienvenue pour nous contacter pour obtenir de l'aide ou fournir des suggestions. WeChat : scannez le code QR pour rejoindre le groupe d'échange technique ChatClaw. Veuillez mentionner « chatclaw » lors de l'ajout.


## Déploiement en Mode Serveur


## Déploiement en Mode Serveur


## Déploiement en Mode Serveur


## Déploiement en Mode Serveur

ChatClaw peut fonctionner en mode serveur (pas besoin de GUI bureau), accessible via un navigateur.

### Binaire Direct

Téléchargez le binaire pour votre plateforme depuis [GitHub Releases](https://github.com/chatwiki/chatclaw/releases):

|| Plateforme | Fichier |
||----------|------|
|| Linux x86_64 | `ChatClaw-server-linux-amd64` |
|| Linux ARM64 | `ChatClaw-server-linux-arm64` |

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

Ouvrez http://localhost:8080 dans votre navigateur.

Le serveur écoute sur `0.0.0.0:8080` par défaut. Vous pouvez personnaliser l'hôte et le port via des variables d'environnement :

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

Ouvrez http://localhost:8080 dans votre navigateur.

### Docker Compose

Créez un fichier `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:
```

Puis exécutez :

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

Ouvrez http://localhost:8080 dans votre navigateur. Pour arrêter : `docker compose down`. Les données persistent dans le volume `chatclaw-data`.

## Stack Technologique

|| Couche | Technologie |
||-------|-----------|
|| Framework Bureau | [Wails v3](https://wails.io/) (Go + WebView) |
|| Langage Backend | [Go 1.26](https://go.dev/) |
|| Framework Frontend | [Vue 3](https://vuejs.org/) + [TypeScript](https://www.typescriptlang.org/) |
|| Composants UI | [shadcn-vue](https://www.shadcn-vue.com/) + [Reka UI](https://reka-ui.com/) |
|| Style | [Tailwind CSS v4](https://tailwindcss.com/) |
|| Gestion d'État | [Pinia](https://pinia.vuejs.org/) |
|| Outil de Build | [Vite](https://vite.dev/) |
|| Framework AI | [Eino](https://github.com/cloudwego/eino) (ByteDance CloudWeGo) |
|| Fournisseurs de Modèles AI | OpenAI / Claude / Gemini / Ollama / DeepSeek / Doubao / Qwen / Zhipu / Grok |
|| Base de Données | [SQLite](https://www.sqlite.org/) + [sqlite-vec](https://github.com/asg017/sqlite-vec) (recherche vectorielle) |
|| Internationalisation | [go-i18n](https://github.com/nicksnyder/go-i18n) + [vue-i18n](https://vue-i18n.intlify.dev/) |
|| Exécuteur de Tâches | [Task](https://taskfile.dev/) |
|| Icônes | [Lucide](https://lucide.dev/) |

## Structure du Projet

```
ChatClaw_D2/
├── main.go                     # Point d'entrée de l'application
├── go.mod / go.sum             # Dépendances du module Go
├── Taskfile.yml                # Configuration de l'exécuteur de tâches
├── build/                      # Configurations de build et ressources plateforme
│   ├── config.yml              # Configuration de build Wails
│   ├── darwin/                 # Paramètres de build macOS et entitlements
│   ├── windows/                # Installateur Windows (NSIS/MSIX) et manifestes
│   ├── linux/                  # Packaging Linux (AppImage, nfpm)
│   ├── ios/                    # Paramètres de build iOS
│   └── android:                # Paramètres de build Android
├── frontend:                   # Application frontend Vue 3
│   ├── package.json            # Dépendances Node.js
│   ├── vite.config.ts          # Configuration du bundleur Vite
│   ├── components.json         # Configuration shadcn-vue
│   ├── index.html              # Entrée de la fenêtre principale
│   ├── floatingball.html       # Entrée de la fenêtre balle flottante
│   ├── selection.html          # Entrée du popup de sélection de texte
│   ├── winsnap.html            # Entrée de la fenêtre Snap
│   └── src/
│       ├── assets/             # Icônes (SVG), images et CSS global
│       ├── components:         # Composants partagés
│       │   ├── layout:         # Layout de l'app, barre latérale, barre de titre
│       │   └── ui:             # Primitifs shadcn-vue (button, dialog, toast…)
│       ├── composables:        # Composables Vue (logique réutilisable)
│       ├── i18n:               # Configuration i18n du frontend
│       ├── locales:            # Fichiers de traduction (zh-CN, en-US…)
│       ├── lib:                # Fonctions utilitaires
│       ├── pages:              # Vues au niveau page
│       │   ├── assistant:      # Page assistant chat AI et composants
│       │   ├── knowledge:      # Page gestion base de connaissances
│       │   ├── multiask:       # Page comparaison multi-modèles
│       │   └── settings:       # Page paramètres (fournisseurs, modèles, outils…)
│       ├── stores:             # Magasins d'état Pinia
│       ├── floatingball:       # Mini-app balle flottante
│       ├── selection:          # Mini-app sélection de texte
│       └── winsnap:            # Mini-app fenêtre Snap
├── internal:                   # Paquets Go privés
│   ├── bootstrap:              # Initialisation de l'application et câblage
│   ├── define:                 # Constantes, fournisseurs intégrés, drapeaux env
│   ├── device:                 # Identification de l'appareil
│   ├── eino:                   # Couche d'intégration AI/LLM
│   │   ├── agent:              # Orchestration d'Agent
│   │   ├── chatmodel:          # Usine de modèles de chat (multi-fournisseur)
│   │   ├── embedding:          # Usine de modèles d'embedding
│   │   ├── filesystem:         # Outils système de fichiers pour Agent AI
│   │   ├── parser:             # Parseurs de documents (PDF, DOCX, XLSX, CSV)
│   │   ├── processor:          # Pipeline de traitement de documents
│   │   ├── raptor:             # Résumé récursif RAPTOR
│   │   ├── splitter:           # Usine de diviseurs de texte
│   │   └── tools:              # Intégrations d'outils AI (navigateur, recherche, calculatrice…)
│   ├── errs:                   # Gestion d'erreurs compatible i18n
│   ├── fts:                    # Tokeniseur de recherche plein texte
│   ├── logger:                 # Journalisation structurée
│   ├── services:               # Services de logique métier
│   │   ├── agents:             # CRUD d'Agent
│   │   ├── app:                # Cycle de vie de l'application
│   │   ├── browser:            # Automatisation du navigateur (chromedp)
│   │   ├── chat:               # Chat et streaming
│   │   ├── conversations:      # Gestion des conversations
│   │   ├── document:           # Upload de documents et vectorisation
│   │   ├── floatingball:       # Fenêtre balle flottante (cross-platform)
│   │   ├── i18n:               # i18n backend
│   │   ├── library:            # CRUD de bibliothèque de connaissances
│   │   ├── multiask:           # Q&R multi-modèles
│   │   ├── providers:          # Configuration du fournisseur AI
│   │   ├── retrieval:          # Service de récupération RAG
│   │   ├── settings:           # Paramètres utilisateur avec cache
│   │   ├── textselection:      # Sélection de texte à l'écran (cross-platform)
│   │   ├── thumbnail:          # Capture de miniature de fenêtre
│   │   ├── tray:               # Barre système
│   │   ├── updater:            # Mise à jour automatique (GitHub/Gitee)
│   │   ├── windows:            # Gestion de fenêtres et service Snap
│   │   └── winsnapchat:        # Service de session de chat Snap
│   ├── sqlite:                 # Couche base de données (Bun ORM + migrations)
│   └── taskmanager:            # Planificateur de tâches en arrière-plan
├── pkg:                         # Paquets Go publics/réutilisables
│   ├── webviewpanel:           # Gestionnaire de panel WebView multiplateforme
│   ├── winsnap:                # Moteur de snap de fenêtres (macOS/Windows/Linux)
│   └── winutil:                # Utilitaires d'activation de fenêtre
├── docs:                       # Documentation de développement
└── images:                      # Captures d'écran du README
```




