<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">
  5分鐘擁有類 OpenClaw 的小龍蝦個人AI智慧體，沙箱安全，佔資源少，運行快.
</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是一款開源的本地知識庫、OpenClaw圖形化桌面管家應用
無需編程，一鍵部署至本地電腦。可連接 微信、 釘釘、企業微信、QQ、飛書，WhatsApp等主流通訊應用，
發送指令即可讓 AI 幫你執行任務。內置 OpenClaw 5000+ 技能庫，並支持類 ima 的本地知識庫管理

## 功能預覽

### AI Chatbot Assistant

向 AI 助手提出任何問題，它會智慧搜索您的知識庫並生成相關回答。搭配內建技能市場，讓 AI Agent 自主工作，無需人工全程干預。無論是複雜的項目規劃、文檔整理，還是 PPT 快速生成、多步驟任務執行，都能自主拆解，高效推進，最終交付完整結果，大幅節省人工時間，提升工作效率。

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

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

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

建立多個獨立 AI Agent，每個擁有專屬角色、記憶和技能，按需切換使用，互不干擾。每個 Agent 可設定不同身份，如「客服專員」「數據分析師」「文案助手」，可分別為每個 Agent 配置不同的技能、知識庫、回覆風格。在介面中自由切換 Agent，適應不同任務場景。

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

### Local Knowledge Base Management

上傳您的文檔（如 TXT、PDF、Word、Excel、CSV、HTML、Markdown），系統會自動解析、分割並轉換為向量嵌入，儲存到您的私有知識庫中，供 AI 模型進行精準檢索和利用，支援按資料夾，知识庫文檔進行分類整理。

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

### Skill Manager — AI Responds at Command

5000+ 開箱即用的 AI 技能，覆蓋效率辦公、開發工具、多媒體創作、智慧家居等全場景，讓 AI 幫你幹活，無需編程。使用指令讓機器人幫您查找電腦上已安裝的功能或安裝新的擴展插件。技能市場，自主選擇和安裝技能。

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

### Memory — Natural & Smarter Interactions

實現上下文對話，提供個人化服務，完成複雜任務，持續學習和進化，讓機器人像一個不斷成長的夥伴，能提供越來越貼心、越來越智慧的服務。

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

### Free Model Trial

一鍵授權接入 ChatWiki，同步 ChatWiki 帳戶積分，同時支援自訂模型，內建優質海內外大模型，Ollama、Google Gemini、OpenAI 等，無論是日常辦公還是專業場景，使用您喜歡的 AI 模型。

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

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

ChatClaw 支援多種消息通道，讓分析結果、監控告警、研究摘要直接推送到您的手機上，突破平台壁壘。接入多家消息通道，海內外主流通訊應用全支援。AI 處理完成後，結果自動發送到指定渠道，無需主動刷新。在聊天視窗中發送指令，即可遠程操控 AI 執行任務。

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

### Scheduled Tasks — Automated Execution

設定監控頻率：每 5 分鐘、每小時、每天固定時間點，圖形化排程器配合 cron 表達式，讓自動執行更直觀。定時抓取特定頁面或數據源，對比變化，監控關鍵指標、政策發布、公告更新，異常觸發時，第一時間透過消息通道推送提醒。

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

### Text Selection for Instant Q&A

選中螢幕上的任意文字，它會被自動複製並填入懸浮快問框。一鍵傳送給 AI 助手，即刻獲得回答。

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

### Smart Sidebar

可以貼靠在其他應用程式視窗旁的智慧助手。在其中快速切換不同配置的 AI 助手進行提問。機器人根據您關聯的知識庫生成回答，並支援一鍵將回覆發送到您的對話中。智慧懸浮跟隨，工具入口隨手可得，不遮擋、不打斷。

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

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

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

無需重複提問。同時諮詢多個「AI 專家」，在一個介面中並排查看它們的回覆，方便比較，幫助您得出最佳結論。

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

### One-Click Launcher Ball

點擊桌面上的懸浮球，即可喚醒或打開 ChatClaw 主應用程式視窗。

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

### Community & Contact Us

歡迎聯繫我們獲取幫助，或者提供建議幫助我們改善 ChatClaw。您可以通過以下方式聯繫我們：微信，使用微信掃碼加入 ChatClaw 技術交流群，添加請備註「chatclaw」。


## 伺服器模式部署


## 伺服器模式部署

ChatClaw 支援以伺服器模式執行（無需桌面 GUI），透過瀏覽器存取。

### 二進位直接執行

從 [GitHub Releases](https://github.com/chatwiki/chatclaw/releases) 下載對應平台的二進位檔案：

|| 平台 | 檔案 |
||------|------|
|| Linux x86_64 | `ChatClaw-server-linux-amd64` |
|| Linux ARM64 | `ChatClaw-server-linux-arm64` |

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

瀏覽器開啟 http://localhost:8080 即可使用。

服務預設監聽 `0.0.0.0:8080`。可透過環境變數自訂監聽位址和連接埠：

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

瀏覽器開啟 http://localhost:8080 即可使用。

### Docker Compose

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

然後執行：

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

瀏覽器開啟 http://localhost:8080 即可使用。停止服務：`docker compose down`。資料持久化在 `chatclaw-data` 卷中。

## 技術堆疊

|| 層級 | 技術 |
||------|------|
|| 桌面框架 | [Wails v3](https://wails.io/) (Go + WebView) |
|| 後端語言 | [Go 1.26](https://go.dev/) |
|| 前端框架 | [Vue 3](https://vuejs.org/) + [TypeScript](https://www.typescriptlang.org/) |
|| UI 元件 | [shadcn-vue](https://www.shadcn-vue.com/) (New York 風格) + [Reka UI](https://reka-ui.com/) |
|| 樣式方案 | [Tailwind CSS v4](https://tailwindcss.com/) |
|| 狀態管理 | [Pinia](https://pinia.vuejs.org/) |
|| 建構工具 | [Vite](https://vite.dev/) |
|| AI 框架 | [Eino](https://github.com/cloudwego/eino) (位元組跳動 CloudWeGo) |
|| AI 模型供應商 | OpenAI / Claude / Gemini / Ollama / DeepSeek / 豆包 / 通義千問 / 智譜 / Grok |
|| 資料庫 | [SQLite](https://www.sqlite.org/) + [sqlite-vec](https://github.com/asg017/sqlite-vec) (向量檢索) |
|| 國際化 | [go-i18n](https://github.com/nicksnyder/go-i18n) + [vue-i18n](https://vue-i18n.intlify.dev/) |
|| 任務執行 | [Task](https://taskfile.dev/) |
|| 圖示 | [Lucide](https://lucide.dev/) |

## 專案結構

```
ChatClaw_D2/
├── main.go                     # 應用入口
├── go.mod / go.sum             # Go 模組依賴
├── Taskfile.yml                # 任務執行器設定
├── build/                      # 建構設定與平台資源
│   ├── config.yml              # Wails 建構設定
│   ├── darwin/                 # macOS 建構設定與授權
│   ├── windows/                # Windows 安裝器 (NSIS/MSIX) 與清單
│   ├── linux/                 # Linux 打包 (AppImage, nfpm)
│   ├── ios/                   # iOS 建構設定
│   └── android/               # Android 建構設定
├── frontend/                   # Vue 3 前端應用
│   ├── package.json            # Node.js 依賴
│   ├── vite.config.ts          # Vite 打包設定
│   ├── components.json         # shadcn-vue 設定
│   ├── index.html              # 主視窗入口
│   ├── floatingball.html       # 懸浮球視窗入口
│   ├── selection.html          # 劃詞彈窗入口
│   ├── winsnap.html            # 貼靠視窗入口
│   └── src/
│       ├── assets/             # 圖示 (SVG)、圖片與全域 CSS
│       ├── components/         # 共用元件
│       │   ├── layout/         # 應用版面配置、側邊欄、標題欄
│       │   └── ui/             # shadcn-vue 基礎元件 (button, dialog, toast…)
│       ├── composables/        # Vue 組合式函數（可複用邏輯）
│       ├── i18n/               # 前端國際化設定
│       ├── locales/            # 翻譯檔案 (zh-CN, en-US…)
│       ├── lib/                # 工具函數
│       ├── pages/              # 頁面級視圖
│       │   ├── assistant/      # AI 聊天助手頁面及元件
│       │   ├── knowledge/      # 知識庫管理頁面
│       │   ├── multiask/       # 多模型對比頁面
│       │   └── settings/       # 設定頁面（供應商、模型、工具…）
│       ├── stores/             # Pinia 狀態倉庫
│       ├── floatingball/       # 懸浮球迷你應用
│       ├── selection/          # 劃詞迷你應用
│       └── winsnap/            # 貼靠視窗迷你應用
├── internal/                   # 私有 Go 套件
│   ├── bootstrap/              # 應用初始化與依賴注入
│   ├── define/                 # 常量、內建供應商、環境標誌
│   ├── device/                 # 設備識別
│   ├── eino/                   # AI/LLM 整合層
│   │   ├── agent/              # Agent 編排
│   │   ├── chatmodel/          # 聊天模型工廠（多供應商）
│   │   ├── embedding/          # 嵌入模型工廠
│   │   ├── filesystem/         # AI Agent 檔案系統工具
│   │   ├── parser/             # 文件解析器 (PDF, DOCX, XLSX, CSV)
│   │   ├── processor/          # 文件處理流水線
│   │   ├── raptor:             # RAPTOR 遞迴摘要
│   │   ├── splitter:           # 文字分割器工廠
│   │   └── tools:              # AI 工具整合（瀏覽器、搜尋、計算機…）
│   ├── errs/                   # 國際化錯誤處理
│   ├── fts:                    # 全文檢索分詞器
│   ├── logger:                 # 結構化日誌
│   ├── services:               # 商業邏輯服務
│   │   ├── agents:             # Agent 增刪改查
│   │   ├── app:                # 應用生命週期
│   │   ├── browser:            # 瀏覽器自動化 (chromedp)
│   │   ├── chat:               # 聊天與串流傳輸
│   │   ├── conversations:      # 對話管理
│   │   ├── document:           # 文件上傳與向量化
│   │   ├── floatingball:       # 懸浮球視窗（跨平台）
│   │   ├── i18n:               # 後端國際化
│   │   ├── library:            # 知識庫增刪改查
│   │   ├── multiask:           # 多模型問答
│   │   ├── providers:          # AI 供應商設定
│   │   ├── retrieval:          # RAG 檢索服務
│   │   ├── settings:           # 使用者設定與快取
│   │   ├── textselection:      # 螢幕劃詞（跨平台）
│   │   ├── thumbnail:          # 視窗縮圖擷取
│   │   ├── tray:               # 系統匣
│   │   ├── updater:             # 自動更新 (GitHub/Gitee)
│   │   ├── windows:             # 視窗管理與貼靠服務
│   │   └── winsnapchat:        # 貼靠聊天對話服務
│   ├── sqlite:                  # 資料庫層 (Bun ORM + 遷移)
│   └── taskmanager:             # 背景任務排程器
├── pkg:                         # 公共/可複用 Go 套件
│   ├── webviewpanel:           # 跨平台 WebView 面板管理器
│   ├── winsnap:                # 視窗貼靠引擎 (macOS/Windows/Linux)
│   └── winutil:                # 視窗啟動工具
├── docs:                       # 開發文件
└── images:                      # README 截圖
```

