<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>Get OpenClaw-like personal AI agent in 5 mins. with Sandbox security,small and fast</strong>
</p>

<p align="center">
  <a href="./README_en.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 is an open-source local knowledge base and OpenClaw graphical desktop assistant application.
No coding required — deploy to your local computer with one click. Connect to WeChat, DingTalk, WeChat Work, QQ, Feishu, WhatsApp and other mainstream messaging apps.
Send commands and let AI execute tasks for you. Built-in OpenClaw 5000+ skill library, with support for IMA-like local knowledge base management.

ChatClaw是一款开源的本地知识库、OpenClaw图形化桌面管家应用
无需编程，一键部署至本地电脑。可连接 微信、 钉钉、企业微信、QQ、飞书，WhatsApp等主流通讯应用，
发送指令即可让 AI 帮你执行任务。内置 OpenClaw 5000+ 技能库，并支持类 ima 的本地知识库管理
 

<p align="center">
<a href="https://github.com/zhimaAi/ChatClaw/releases" target="_blank" >Windows/Mac/Linux (Releases)</a>  
</p>

## Previews

### AI Chatbot Assistant

Ask your AI assistant any question; it will intelligently search your knowledge base and generate relevant answers. With the built-in Skill Market, AI Agents work autonomously — no need for manual oversight throughout. From complex project planning and document organization to PPT generation and multi-step task execution, AI Agents can autonomously break down, efficiently advance, and ultimately deliver complete results, saving significant time.

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

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

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

Create multiple independent AI Agents, each with its own persona, memory and skills. Switch between them on demand without interference. Each Agent can be assigned different roles (e.g. "Customer Service", "Data Analyst", "Copy Assistant") and configured with different skills, knowledge bases and response styles.

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

### Local Knowledge Base Management

Upload documents (TXT, PDF, Word, Excel, CSV, HTML, Markdown). The system automatically parses, splits and converts them into vector embeddings stored in your private knowledge base for precise AI retrieval and utilization. Supports organizing documents by folder and knowledge base.

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

### Skill Manager — AI Responds at Command

5000+ ready-to-use AI skills cover productivity, development tools, multimedia, smart home and more — letting AI work for you without programming. Use commands to find installed features or install new extension plugins. Skill Market — freely browse and install skills.

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

### Memory — Natural & Smarter Interactions

Enable contextual conversations, personalized service, complex task completion and continuous learning & evolution. The robot becomes a growing companion that provides increasingly thoughtful and intelligent service.

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

### Free Model Trial

One-click authorization to connect to ChatWiki, sync credits, support custom models. Built-in high quality LLMs: Ollama, Google Gemini, OpenAI and more — use your favorite AI model for office work or professional scenarios.

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

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

ChatClaw supports multiple message channels, pushing analysis results, monitoring alerts and research summaries directly to your phone. After AI processing, results are automatically sent to the designated channel. Send commands in the chat window to remotely control AI task execution.

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

### Scheduled Tasks — Automated Execution

Set monitoring frequency: every 5 minutes, hourly, or daily at fixed times. Graphical scheduler with cron expressions. Periodically fetch pages or data sources, compare changes, monitor key indicators and push alerts via message channels when anomalies are detected.

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

### Text Selection for Instant Q&A

Select any text on screen; it is automatically copied into a floating quick-ask box. One click sends it to the AI assistant for an instant answer.

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

### Smart Sidebar

A smart assistant that snaps alongside other app windows. Quickly switch between differently configured AI assistants to ask questions. The robot generates answers based on your associated knowledge base and supports one-click reply sending. Smart floating follow — tool entry always at hand.

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

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

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

No need to repeat questions. Consult multiple "AI experts" simultaneously, compare their replies side-by-side in the same interface and reach the best conclusion.

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

### One-Click Launcher Ball

Click the floating ball on your desktop to instantly wake up or open the ChatClaw main application window.

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

## Server Mode Deployment


## Server Mode Deployment

ChatClaw can run as a server (no desktop GUI required), accessible via a browser.

### Binary

Download the binary for your platform from [GitHub Releases](https://github.com/chatwiki/chatclaw/releases):

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

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

Open http://localhost:8080 in your browser.

The server listens on `0.0.0.0:8080` by default. You can customize host and port via environment variables:

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

Open http://localhost:8080 in your browser.

### Docker Compose

Create a `docker-compose.yml` file:

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

Then run:

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

Open http://localhost:8080 in your browser. To stop: `docker compose down`. Data is persisted in the `chatclaw-data` volume.

## Tech Stack

| Layer | Technology |
|-------|-----------|
| Desktop Framework | [Wails v3](https://wails.io/) (Go + WebView) |
| Backend Language | [Go 1.26](https://go.dev/) |
| Frontend Framework | [Vue 3](https://vuejs.org/) + [TypeScript](https://www.typescriptlang.org/) |
| UI Components | [shadcn-vue](https://www.shadcn-vue.com/) (New York style) + [Reka UI](https://reka-ui.com/) |
| Styling | [Tailwind CSS v4](https://tailwindcss.com/) |
| State Management | [Pinia](https://pinia.vuejs.org/) |
| Build Tool | [Vite](https://vite.dev/) |
| AI Framework | [Eino](https://github.com/cloudwego/eino) (ByteDance CloudWeGo) |
| AI Model Providers | OpenAI / Claude / Gemini / Ollama / DeepSeek / Doubao / Qwen / Zhipu / Grok |
| Database | [SQLite](https://www.sqlite.org/) + [sqlite-vec](https://github.com/asg017/sqlite-vec) (vector search) |
| Internationalization | [go-i18n](https://github.com/nicksnyder/go-i18n) + [vue-i18n](https://vue-i18n.intlify.dev/) |
| Task Runner | [Task](https://taskfile.dev/) |
| Icons | [Lucide](https://lucide.dev/) |

## Project Structure

```
ChatClaw_D2/
├── main.go                     # Application entry point
├── go.mod / go.sum             # Go module dependencies
├── Taskfile.yml                # Task runner configuration
├── build/                      # Build configurations & platform assets
│   ├── config.yml              # Wails build config
│   ├── darwin/                 # macOS build settings & entitlements
│   ├── windows/                # Windows installer (NSIS/MSIX) & manifests
│   ├── linux/                  # Linux packaging (AppImage, nfpm)
│   ├── ios/                    # iOS build settings
│   └── android/                # Android build settings
├── frontend/                   # Vue 3 frontend application
│   ├── package.json            # Node.js dependencies
│   ├── vite.config.ts          # Vite bundler config
│   ├── components.json         # shadcn-vue config
│   ├── index.html              # Main window entry
│   ├── floatingball.html       # Floating ball window entry
│   ├── selection.html          # Text selection popup entry
│   ├── winsnap.html            # Snap window entry
│   └── src/
│       ├── assets/             # Icons (SVG), images & global CSS
│       ├── components/         # Shared components
│       │   ├── layout/         # App layout, sidebar, title bar
│       │   └── ui/             # shadcn-vue primitives (button, dialog, toast…)
│       ├── composables/        # Vue composables (reusable logic)
│       ├── i18n/               # Frontend i18n setup
│       ├── locales/            # Translation files (zh-CN, en-US…)
│       ├── lib/                # Utility functions
│       ├── pages/              # Page-level views
│       │   ├── assistant/      # AI chat assistant page & components
│       │   ├── knowledge/      # Knowledge base management page
│       │   ├── multiask/       # Multi-model comparison page
│       │   └── settings/       # Settings page (providers, models, tools…)
│       ├── stores/             # Pinia state stores
│       ├── floatingball/       # Floating ball mini-app
│       ├── selection/          # Text selection mini-app
│       └── winsnap/            # Snap window mini-app
├── internal/                   # Private Go packages
│   ├── bootstrap/              # Application initialization & wiring
│   ├── define/                 # Constants, built-in providers, env flags
│   ├── device/                 # Device identification
│   ├── eino/                   # AI/LLM integration layer
│   │   ├── agent/              # Agent orchestration
│   │   ├── chatmodel/          # Chat model factory (multi-provider)
│   │   ├── embedding/          # Embedding model factory
│   │   ├── filesystem/         # File-system tools for AI agents
│   │   ├── parser/             # Document parsers (PDF, DOCX, XLSX, CSV)
│   │   ├── processor/          # Document processing pipeline
│   │   ├── raptor/             # RAPTOR recursive summarization
│   │   ├── splitter/           # Text splitter factory
│   │   └── tools/              # AI tool integrations (browser, search, calculator…)
│   ├── errs/                   # i18n-aware error handling
│   ├── fts/                    # Full-text search tokenizer
│   ├── logger/                 # Structured logging
│   ├── services/               # Business logic services
│   │   ├── agents/             # Agent CRUD
│   │   ├── app/                # Application lifecycle
│   │   ├── browser/            # Browser automation (via chromedp)
│   │   ├── chat/               # Chat & streaming
│   │   ├── conversations/      # Conversation management
│   │   ├── document/           # Document upload & vectorization
│   │   ├── floatingball/       # Floating ball window (cross-platform)
│   │   ├── i18n/               # Backend internationalization
│   │   ├── library/            # Knowledge library CRUD
│   │   ├── multiask/           # Multi-model Q&A
│   │   ├── providers/          # AI provider configuration
│   │   ├── retrieval/          # RAG retrieval service
│   │   ├── settings/           # User settings with cache
│   │   ├── textselection/      # Screen text selection (cross-platform)
│   │   ├── thumbnail/          # Window thumbnail capture
│   │   ├── tray/               # System tray
│   │   ├── updater/            # Auto-update (GitHub/Gitee)
│   │   ├── windows/            # Window management & snap service
│   │   └── winsnapchat/        # Snap chat session service
│   ├── sqlite/                 # Database layer (Bun ORM + migrations)
│   └── taskmanager/            # Background task scheduler
├── pkg/                        # Public/reusable Go packages
│   ├── webviewpanel/           # Cross-platform webview panel manager
│   ├── winsnap/                # Window snapping engine (macOS/Windows/Linux)
│   └── winutil/                # Window activation utilities
├── docs/                       # Development documentation
│   └── readmes/                # Multi-language README files
│       ├── README.md           # English README
│       ├── README_zh-CN.md    # Simplified Chinese README
│       └── images/             # README screenshots
└── images/                     # README screenshots (legacy)
```

### Changelog
To view the complete update log, please click👉️👉️[UpdateLog.md](../../UpdateLog.md)


### 2026/04/03
1. **OpenClaw Doctor Console Enhancement**: Integrated `ansi-to-html` for enhanced console output rendering with ANSI color support in both light and dark themes. Added streaming support for doctor command output with improved stdout/stderr handling and event emission for UI updates.
2. **OpenClaw Runtime Upgrade System**: Implemented comprehensive upgrade status management with "Upgrading" state across components and localization files. Enhanced npm package installation with progress updates and improved error handling, including rollback mechanisms.
3. **Gateway Port Management**: Added port occupation checks with user feedback for gateway operations. Implemented `ensurePortClean` method to detect and gracefully stop stale processes using the gateway port. Added stop port functionality.
4. **ChatWiki Sync Enhancement**: Enhanced ChatWiki sync data fetching to support forced refresh for up-to-date model catalog. Implemented model catalog refresh mechanism for OpenClaw sync to ensure models stay current.
5. **OpenClaw Auto-Start**: Implemented auto-start functionality for OpenClaw gateway with UI toggle and localization support. Configuration persists auto-start preference with toast notifications for state changes.
6. **Chat Session Sync**: Implemented OpenClaw chat session synchronization functionality.
7. **WhatsApp Integration**: Enhanced WhatsApp binding functionality.
8. **QQ/Enterprise WeChat Optimization**: Resolved download plugin rate limiting issues. Fixed Chinese/English prompts and login redirect issues.
9. **Style Updates**: Removed team features from OpenClaw mode. Updated settings component layout and styling for improved responsiveness.
10. **Version Bump**: Application version updated to 0.9.1. OpenClaw version updated to 2026.4.2.

### 2026/04/02
1. **OpenClaw Doctor Integration**: Added gateway status handling in SideNav with localized messages. Updated ChatInputArea to reflect gateway state with relevant UI components.
2. **i18n Enhancement**: Added translation files for new gateway and doctor messages across multiple languages. Added toast notifications for toolchain updates.
3. **OpenClaw Version Update**: Updated OpenClaw version to 2026.4.1 with enhanced gateway integration in frontend.


### 2026/04/01
1. **Version 0.9.0 Release**: Updated application version to 0.9.0 in build configuration.
2. **OpenClaw Installer Bundling**: Enhanced Taskfile.yml and NSIS installer with conditional OpenClaw runtime bundling support, including zip file existence checks before bundling.
3. **OpenClaw Version Update**: Upgraded OpenClaw runtime to version 2026.3.31.
4. **Multi-Language Translations**: Updated translations across Arabic, Bengali, German, English, Spanish, and French locales with new keys and improved consistency.
5. **Scheduled Task Bug Fixes**: Fixed cron display anomalies and edited scheduled task issues.
6. **WeChat Text Updates**: Updated WeChat-related text copy and default naming conventions.




