# ChatClaw **Repository Path**: zhimaAi/ChatClaw ## Basic Information - **Project Name**: ChatClaw - **Description**: 5 分钟即可拥有类 OpenClaw 的小龙虾个人AI 智能体,沙箱安全防护, macOS/Windows 30M 极小安装包,1 分钟安装。连接WhatsApp、Telegram、Slack、Discord、Gmail、钉钉、企业微信、QQ、飞书等主流通讯应用,内置技能市场、知识库、记忆、MCP、计划任务等核心功能。Go 开发,运行快、占资源少。 - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 8 - **Forks**: 1 - **Created**: 2026-03-04 - **Last Updated**: 2026-03-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 

ChatClaw

Get OpenClaw-like personal AI agent in 5 mins. with Sandbox security,small and fast

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | العربية | বাংলা | Deutsch | Español | Français | हिन्दी | Italiano | Português | Slovenščina | Türkçe | Tiếng Việt

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语言开发,运行快、占资源少。

Windows/Mac/Linux (Releases)

## Previews ### AI Chatbot Assistant Ask your AI assistant any question, and it will intelligently search your knowledge base to generate a relevant answer. ![](./images/previews/en/image1.png) ### PPT Quick Generate Send a one-sentence command to the smart assistant to automatically create and generate a PowerPoint presentation. ![](./images/previews/en/image3.png) ### Skill Manager Use a command to have the assistant help you find installed features on your computer or install new extension plugins. ![](./images/previews/en/image5.png) ### 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. ![](./images/previews/en/image6.png) ### 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. ![](./images/previews/en/image8.png) ### 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. ![](./images/previews/en/image9.png) ### Shared Team Knowledge Base Authorize one-click access to ChatWiki to sync robots and knowledge bases, share configurations, and control member permissions. ![](./images/previews/en/image10.png) ### 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. ![](./images/previews/en/image11.png) ### 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. ![](./images/previews/en/image12.png) ### Scheduled Tasks Let your assistant automatically execute actions at preset times or intervals: reminders, recurring work, and system-level maintenance. ![](./images/previews/en/image13.png) ### 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. ![](./images/previews/en/image14.png) ![](./images/previews/en/image15.png) ### Smart Sidebar Snap the assistant alongside other windows, quickly switch between differently configured assistants, and one-click send generated replies into your conversations. ![](./images/previews/en/image16.png) ### One Question, Multiple Answers: Compare with Ease Consult multiple "AI experts" simultaneously and view their responses side-by-side for easy comparison. ![](./images/previews/en/image17.png) ### One-Click Launcher Ball Click the floating ball on your desktop to instantly wake up or open the main ChatClaw window. ![](./images/previews/en/image18.png) ## 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](./docs/readmes/UpdateLog.md) ### 2026/03/18 1. **README Refresh (Multi-language)**: Updated README files across multiple languages with new previews, clearer capability descriptions, and consistent image paths/structure.
2. **Channel Integrations & Messaging**: Improved messaging flows and guardrails for multiple channels (e.g., QQ config dedup & image sending, WeCom/Feishu streaming output, DingTalk checks and related config updates).
3. **Docs/Tooling**: Added `readme-from-docx` skill documentation for syncing README content from Word documents, including image extraction and localization guidelines.
### 2026/03/17 1. **Chat File Upload (End-to-End)**: Delivered file attachment support across chat UI and backend services, including type/size validation, message state integration, and consistent handling alongside image attachments.
2. **Chat Input UX Upgrade**: Enhanced `ChatInputArea` with a new conversation entry, dropdown integrations, a compact mode selector with icon toggles, and a bottom toolbar for better ergonomics.
3. **In-App Selection Context Menu**: Added an in-app text selection popup with actions and an option to disable selection search, with `TextSelectionService` and settings synchronization.
4. **MCP Defaults & Reliability**: Enabled MCP by default via SQLite migration and hardened MCP settings flows (tool add/remove state handling, validation, cleanup) to reduce edge-case failures.
5. **Model Config Validation**: Strengthened Azure chat/embedding configuration validation (endpoint/version requirements) and refined thinking feature initialization logic for safer defaults.
6. **Project Hygiene**: Added `think_docs/` convention + `.gitignore` entry, removed legacy Klingon locale artifacts, and applied small refactors for readability/maintainability (e.g., button handlers).
### 2026/03/16 1. **New Style / Knowledge UI Refactor**: Major refactor of `KnowledgePage` folder/library behaviors with debounced expansion, improved folder-tree synchronization, and upgraded team knowledge UI via `TeamFolderCard`/`TeamFileCard` components.
2. **Assistant MCP Feature Expansion**: Added an Assistant MCP detail view (edit + tool management) and improved service networking behavior (host binding checks, `127.0.0.1` usage, CORS/OPTIONS handling).
3. **i18n Loading Improvements**: Refactored i18n initialization to support async locale message loading and made message typing more flexible for dynamic locale structures.
4. **Performance & Build Optimizations**: Improved Vite bundling via manual chunking and async component loading in `App.vue`; added reusable `copyToClipboard` utility; tuned server-mode performance and tokenizer dictionary loading for Chinese segmentation.
5. **Build/Dev Workflow Updates**: Updated `development.md` and Dockerfiles for clearer, more reliable build steps (bindings generation, frontend deps), plus backend app init/systray refinements for stability.