ChatClaw

<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="./docs/readmes/README.md">English</a> | <a href="./docs/readmes/README_zh-CN.md">简体中文</a> | <a href="./docs/readmes/README_zh-TW.md">繁體中文</a> | <a href="./docs/readmes/README_ja-JP.md">日本語</a> | <a href="./docs/readmes/README_ko-KR.md">한국어</a> | <a href="./docs/readmes/README_ar-SA.md">العربية</a> | <a href="./docs/readmes/README_bn-BD.md">বাংলা</a> | <a href="./docs/readmes/README_de-DE.md">Deutsch</a> | <a href="./docs/readmes/README_es-ES.md">Español</a> | <a href="./docs/readmes/README_fr-FR.md">Français</a> | <a href="./docs/readmes/README_hi-IN.md">हिन्दी</a> | <a href="./docs/readmes/README_it-IT.md">Italiano</a> | <a href="./docs/readmes/README_pt-BR.md">Português</a> | <a href="./docs/readmes/README_sl-SI.md">Slovenščina</a> | <a href="./docs/readmes/README_tr-TR.md">Türkçe</a> | <a href="./docs/readmes/README_vi-VN.md">Tiếng Việt</a> </p>

Get OpenClaw-like knowledge base personal AI agent in 5 mins. Sandbox-secured, with an ultra-small 30MB installer for macOS & Windows (install in 1 min). Connects to WhatsApp, Telegram, Slack, Discord, Gmail, DingTalk, WeChat Work, QQ, Feishu & other messaging apps. Built-in Skill Market, Knowledge Base, Memory, MCP, Scheduled Tasks. Developed in Go: fast & low resource usage.

5分钟拥有类 OpenClaw 本地知识库个人AI智能体,沙箱安全防护,支持macOS/Windows 30M 极小安装包,1 分钟安装。连接WhatsApp、Telegram、Slack、Discord、Gmail、钉钉、企业微信、QQ、飞书等主流通讯应用，内置技能市场、IMA开源版本地知识库平替、记忆、MCP、计划任务等核心功能。Go语言开发，运行快、占资源少。

<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, and it will intelligently search your knowledge base to generate a relevant answer.

PPT Quick Generate

Send a one-sentence command to the smart assistant to automatically create and generate a PowerPoint presentation.

Skill Manager

Use a command to have the assistant help you find installed features on your computer or install new extension plugins.

MCP: Unlimited Capability Extensions

Add external MCP servers to securely and efficiently connect to diverse data sources and tools, enabling your assistant to go beyond daily tasks into professional workflows.

Sandbox Mode: Double Protection

Choose between sandbox-isolated execution (OS-level isolation, restricted command scope) and native execution (more flexible). Switch freely to balance safety and convenience.

Memory: More Natural, Smarter Interactions

Enable contextual conversations and personalized assistance. The assistant can continuously learn and evolve so it feels like a growing partner.

Shared Team Knowledge Base

Authorize one-click access to ChatWiki to sync robots and knowledge bases, share configurations, and control member permissions.

Knowledge Base | Document Vectorization Storage

Upload documents (TXT, PDF, Word, Excel, CSV, HTML, Markdown). The system automatically parses, splits, and converts them into vector embeddings for precise retrieval.

Rich IM Channel Integrations

Integrate IM providers (Feishu, WeCom, QQ, DingTalk, LINE, Discord, WhatsApp, X/Twitter, Telegram, etc.) via SDKs to quickly enable channel creation, user management, and messaging.

Scheduled Tasks

Let your assistant automatically execute actions at preset times or intervals: reminders, recurring work, and system-level maintenance.

Text Selection for Instant Q&A

Select any text on your screen. It is automatically copied into a floating quick-ask box. One click to ask, instant answers.

Smart Sidebar

Snap the assistant alongside other windows, quickly switch between differently configured assistants, and one-click send generated replies into your conversations.

One Question, Multiple Answers: Compare with Ease

Consult multiple "AI experts" simultaneously and view their responses side-by-side for easy comparison.

One-Click Launcher Ball

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

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:

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

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:

WAILS_SERVER_HOST=127.0.0.1 WAILS_SERVER_PORT=3000 ./ChatClaw-server-linux-amd64

Docker

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:

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:

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 (Go + WebView) | | Backend Language | Go 1.26 | | Frontend Framework | Vue 3 + TypeScript | | UI Components | shadcn-vue (New York style) + Reka UI | | Styling | Tailwind CSS v4 | | State Management | Pinia | | Build Tool | Vite | | AI Framework | Eino (ByteDance CloudWeGo) | | AI Model Providers | OpenAI / Claude / Gemini / Ollama / DeepSeek / Doubao / Qwen / Zhipu / Grok | | Database | SQLite + sqlite-vec (vector search) | | Internationalization | go-i18n + vue-i18n | | Task Runner | Task | | Icons | Lucide |

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
│   │   ├──