<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>Nhận AI cá nhân như OpenClaw trong 5 phút. Bảo mật Sandbox, nhỏ và nhanh</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 là ứng dụng trợ lý desktop đồ họa mã nguồn mở và cơ sở tri thức cục bộ.
Không cần lập trình — triển khai lên máy tính cục bộ chỉ với một lần nhấp. Kết nối với WeChat, DingTalk, WeCom, QQ, Feishu, WhatsApp và các ứng dụng nhắn tin phổ biến.
Gửi lệnh để AI thực hiện tác vụ cho bạn. Thư viện kỹ năng tích hợp hơn 5000+, hỗ trợ quản lý cơ sở tri thức cục bộ kiểu IMA.

## Xem trước

### AI Chatbot Assistant

Đặt câu hỏi bất kỳ cho trợ lý AI của bạn; nó sẽ thông minh tìm kiếm cơ sở tri thức của bạn và tạo ra các câu trả lời liên quan. Với Thị trường Kỹ năng được tích hợp sẵn, các Tác nhân AI hoạt động tự chủ — không cần giám sát thủ công trong suốt quá trình. Từ lập kế hoạch dự án phức tạp, tổ chức tài liệu đến tạo PPT và thực thi nhiệm vụ nhiều bước, các Tác nhân AI có thể tự phân tích, tiến triển hiệu quả và cuối cùng mang lại kết quả đầy đủ.

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

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

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

Tạo nhiều Tác nhân AI độc lập, mỗi cái có nhân cách, bộ nhớ và kỹ năng riêng. Chuyển đổi giữa chúng theo nhu cầu mà không can thiệp lẫn nhau. Mỗi Tác nhân có thể được giao các vai trò khác nhau (ví dụ "Dịch vụ Khách hàng", "Nhà Phân tích Dữ liệu", "Trợ lý Soạn thảo") và được cấu hình với các kỹ năng, cơ sở tri thức và phong cách phản hồi khác nhau.

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

### Local Knowledge Base Management

Tải lên tài liệu của bạn (TXT, PDF, Word, Excel, CSV, HTML, Markdown). Hệ thống tự động phân tích, chia nhỏ và chuyển đổi chúng thành các embedding vector được lưu trữ trong cơ sở tri thức riêng tư của bạn để AI tìm kiếm và sử dụng chính xác. Hỗ trợ tổ chức tài liệu theo thư mục và cơ sở tri thức.

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

### Skill Manager — AI Responds at Command

5000+ kỹ năng AI sẵn sàng sử dụng bao gồm năng suất, công cụ phát triển, đa phương tiện, nhà thông minh và hơn thế nữa — để AI làm việc cho bạn mà không cần lập trình. Sử dụng lệnh để robot tìm các tính năng đã cài đặt hoặc cài đặt các plugin mở rộng mới. Thị trường Kỹ năng — thoải mái duyệt và cài đặt kỹ năng.

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

### Memory — Natural & Smarter Interactions

Cho phép các cuộc trò chuyện theo ngữ cảnh, cung cấp dịch vụ cá nhân hóa, hoàn thành các nhiệm vụ phức tạp, học tập và phát triển liên tục. Robot trở thành một người bạn đồng hành đang phát triển, cung cấp dịch vụ ngày càng chu đáo và thông minh hơn.

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

### Free Model Trial

Ủy quyền một lần để kết nối với ChatWiki, đồng bộ tín dụng, hỗ trợ mô hình tùy chỉnh. Các LLM chất lượng cao tích hợp sẵn: Ollama, Google Gemini, OpenAI và hơn thế nữa — sử dụng mô hình AI yêu thích của bạn cho công việc văn phòng hoặc các kịch bản chuyên nghiệp.

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

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

ChatClaw hỗ trợ nhiều kênh nhắn tin, đẩy kết quả phân tích, cảnh báo giám sát và tóm tắt nghiên cứu trực tiếp đến điện thoại của bạn. Sau khi xử lý AI, kết quả được gửi tự động đến kênh được chỉ định. Gửi lệnh trong cửa sổ trò chuyện để điều khiển từ xa việc thực thi nhiệm vụ AI.

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

### Scheduled Tasks — Automated Execution

Đặt tần suất giám sát: mỗi 5 phút, hàng giờ hoặc hàng ngày vào các thời điểm cố định. Bộ lập lịch đồ họa với biểu thức cron. Định kỳ truy xuất trang hoặc nguồn dữ liệu, so sánh thay đổi, giám sát các chỉ số chính và đẩy cảnh báo qua các kênh nhắn tin khi phát hiện bất thường.

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

### Text Selection for Instant Q&A

Chọn bất kỳ văn bản nào trên màn hình; nó được tự động sao chép vào hộp hỏi nhanh nổi. Một lần nhấp gửi nó đến trợ lý AI để nhận câu trả lời tức thì.

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

### Smart Sidebar

Một trợ lý thông minh có thể gắn bên cạnh các cửa sổ ứng dụng khác. Nhanh chóng chuyển đổi giữa các trợ lý AI được cấu hình khác nhau để đặt câu hỏi. Robot tạo câu trả lời dựa trên cơ sở tri thức liên kết của bạn và hỗ trợ gửi trả lời bằng một lần nhấp. Theo dõi nổi thông minh — đầu vào công cụ luôn trong tầm tay.

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

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

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

Không cần lặp lại câu hỏi. Tham khảo ý kiến nhiều "chuyên gia AI" cùng một lúc, so sánh câu trả lời của họ song song trong cùng một giao diện và đi đến kết luận tốt nhất.

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

### One-Click Launcher Ball

Nhấp vào quả cầu nổi trên màn hình nền để đánh thức hoặc mở ngay cửa sổ ứng dụng chính của ChatClaw.

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

### Community & Contact Us

Chào mừng liên hệ với chúng tôi để được trợ giúp hoặc đưa ra đề xuất. WeChat: quét mã QR để tham gia nhóm trao đổi kỹ thuật ChatClaw. Vui lòng đề cập "chatclaw" khi thêm.


## Triển khai Chế độ Máy chủ


## Triển khai Chế độ Máy chủ


## Triển khai Chế độ Máy chủ


## Triển khai Chế độ Máy chủ

ChatClaw có thể chạy ở chế độ máy chủ (không cần GUI máy tính), có thể truy cập qua trình duyệt.

### Binary Trực tiếp

Tải xuống binary cho nền tảng của bạn từ [GitHub Releases](https://github.com/chatwiki/chatclaw/releases):

|| Nền tảng | Tệp |
||----------|------|
|| Linux x86_64 | `ChatClaw-server-linux-amd64` |
|| Linux ARM64 | `ChatClaw-server-linux-arm64` |

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

Mở http://localhost:8080 trong trình duyệt của bạn.

Máy chủ lắng nghe trên `0.0.0.0:8080` theo mặc định. Bạn có thể tùy chỉnh máy chủ và cổng thông qua các biến môi trường:

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

Mở http://localhost:8080 trong trình duyệt của bạn.

### Docker Compose

Tạo tệp `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:
```

Sau đó chạy:

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

Mở http://localhost:8080 trong trình duyệt của bạn. Để dừng: `docker compose down`. Dữ liệu được lưu trữ trong volume `chatclaw-data`.

## Ngăn xếp Công nghệ

|| Lớp | Công nghệ |
||-------|-----------|
|| Khung Desktop | [Wails v3](https://wails.io/) (Go + WebView) |
|| Ngôn ngữ Backend | [Go 1.26](https://go.dev/) |
|| Khung Frontend | [Vue 3](https://vuejs.org/) + [TypeScript](https://www.typescriptlang.org/) |
|| Thành phần UI | [shadcn-vue](https://www.shadcn-vue.com/) + [Reka UI](https://reka-ui.com/) |
|| Tạo kiểu | [Tailwind CSS v4](https://tailwindcss.com/) |
|| Quản lý Trạng thái | [Pinia](https://pinia.vuejs.org/) |
|| Công cụ Build | [Vite](https://vite.dev/) |
|| Khung AI | [Eino](https://github.com/cloudwego/eino) (ByteDance CloudWeGo) |
|| Nhà cung cấp Mô hình AI | OpenAI / Claude / Gemini / Ollama / DeepSeek / Doubao / Qwen / Zhipu / Grok |
|| Cơ sở dữ liệu | [SQLite](https://www.sqlite.org/) + [sqlite-vec](https://github.com/asg017/sqlite-vec) (tìm kiếm vector) |
|| Quốc tế hóa | [go-i18n](https://github.com/nicksnyder/go-i18n) + [vue-i18n](https://vue-i18n.intlify.dev/) |
|| Trình chạy Tác vụ | [Task](https://taskfile.dev/) |
|| Biểu tượng | [Lucide](https://lucide.dev/) |

## Cấu trúc Dự án

```
ChatClaw_D2/
├── main.go                     # Điểm vào ứng dụng
├── go.mod / go.sum             # Phụ thuộc mô-đun Go
├── Taskfile.yml                # Cấu hình trình chạy tác vụ
├── build:                      # Cấu hình build và tài sản nền tảng
│   ├── config.yml              # Cấu hình build Wails
│   ├── darwin:                 # Cài đặt build macOS và quyền
│   ├── windows:                # Trình cài đặt Windows (NSIS/MSIX) và manifest
│   ├── linux:                  # Đóng gói Linux (AppImage, nfpm)
│   ├── ios:                    # Cài đặt build iOS
│   └── android:                # Cài đặt build Android
├── frontend:                   # Ứng dụng Vue 3 frontend
│   ├── package.json            # Phụ thuộc Node.js
│   ├── vite.config.ts          # Cấu hình bundler Vite
│   ├── components.json         # Cấu hình shadcn-vue
│   ├── index.html              # Entry cửa sổ chính
│   ├── floatingball.html       # Entry cửa sổ bóng nổi
│   ├── selection.html          # Entry popup chọn văn bản
│   ├── winsnap.html            # Entry cửa sổ Snap
│   └── src/
│       ├── assets:             # Biểu tượng (SVG), hình ảnh và CSS toàn cục
│       ├── components:         # Thành phần dùng chung
│       │   ├── layout:         # Bố cục app, thanh bên, thanh tiêu đề
│       │   └── ui:             # Primitives shadcn-vue (button, dialog, toast…)
│       ├── composables:        # Vue composables (logic có thể tái sử dụng)
│       ├── i18n:               # Thiết lập i18n frontend
│       ├── locales:            # Tệp dịch (zh-CN, en-US…)
│       ├── lib:                # Hàm tiện ích
│       ├── pages:              # Views cấp trang
│       │   ├── assistant:      # Trang trợ lý chat AI và thành phần
│       │   ├── knowledge:      # Trang quản lý cơ sở tri thức
│       │   ├── multiask:       # Trang so sánh đa mô hình
│       │   └── settings:       # Trang cài đặt (nhà cung cấp, mô hình, công cụ…)
│       ├── stores:             # Kho trạng thái Pinia
│       ├── floatingball:       # Mini-app bóng nổi
│       ├── selection:          # Mini-app chọn văn bản
│       └── winsnap:            # Mini-app cửa sổ Snap
├── internal:                   # Gói Go riêng tư
│   ├── bootstrap:              # Khởi tạo ứng dụng và kết nối
│   ├── define:                 # Hằng số, nhà cung cấp tích hợp, cờ môi trường
│   ├── device:                 # Nhận dạng thiết bị
│   ├── eino:                   # Lớp tích hợp AI/LLM
│   │   ├── agent:              # Điều phối Agent
│   │   ├── chatmodel:          # Nhà máy mô hình chat (đa nhà cung cấp)
│   │   ├── embedding:          # Nhà máy mô hình embedding
│   │   ├── filesystem:         # Công cụ hệ thống tệp cho Agent AI
│   │   ├── parser:             # Bộ phân tích tài liệu (PDF, DOCX, XLSX, CSV)
│   │   ├── processor:          # Đường ống xử lý tài liệu
│   │   ├── raptor:             # Tóm tắt đệ quy RAPTOR
│   │   ├── splitter:           # Nhà máy bộ chia văn bản
│   │   └── tools:              # Tích hợp công cụ AI (trình duyệt, tìm kiếm, máy tính…)
│   ├── errs:                   # Xử lý lỗi nhận biết i18n
│   ├── fts:                    # Tokenizer tìm kiếm toàn văn
│   ├── logger:                 # Ghi nhật ký có cấu trúc
│   ├── services:               # Dịch vụ logic nghiệp vụ
│   │   ├── agents:             # CRUD Agent
│   │   ├── app:                # Vòng đời ứng dụng
│   │   ├── browser:            # Tự động hóa trình duyệt (chromedp)
│   │   ├── chat:               # Chat và streaming
│   │   ├── conversations:      # Quản lý cuộc trò chuyện
│   │   ├── document:           # Tải lên tài liệu và vector hóa
│   │   ├── floatingball:       # Cửa sổ bóng nổi (đa nền tảng)
│   │   ├── i18n:               # i18n backend
│   │   ├── library:            # CRUD thư viện tri thức
│   │   ├── multiask:           # Q&A đa mô hình
│   │   ├── providers:          # Cấu hình nhà cung cấp AI
│   │   ├── retrieval:          # Dịch vụ truy xuất RAG
│   │   ├── settings:           # Cài đặt người dùng với cache
│   │   ├── textselection:      # Chọn văn bản màn hình (đa nền tảng)
│   │   ├── thumbnail:          # Chụp thu nhỏ cửa sổ
│   │   ├── tray:               # Khay hệ thống
│   │   ├── updater:            # Cập nhật tự động (GitHub/Gitee)
│   │   ├── windows:            # Quản lý cửa sổ và dịch vụ Snap
│   │   └── winsnapchat:        # Dịch vụ phiên chat Snap
│   ├── sqlite:                 # Lớp cơ sở dữ liệu (Bun ORM + migrations)
│   └── taskmanager:            # Bộ lập lịch tác vụ nền
├── pkg:                         # Gói Go công cộng/tái sử dụng
│   ├── webviewpanel:           # Trình quản lý panel WebView đa nền tảng
│   ├── winsnap:                # Công cụ Snap cửa sổ (macOS/Windows/Linux)
│   └── winutil:                # Tiện ích kích hoạt cửa sổ
├── docs:                       # Tài liệu phát triển
└── images:                      # Ảnh chụp màn hình README
```




