ChatClaw

划词即时问答

选中屏幕上的任意文字，它会被自动复制并填入悬浮快问框。一键发送给 AI 助手，即刻获得回答。

智能侧边栏

可以贴靠在其他应用窗口旁的智能助手。在其中快速切换不同配置的 AI 助手进行提问。机器人根据您关联的知识库生成回答，并支持一键将回复发送到您的对话中。智能悬浮跟随，工具入口随手可得，不遮挡、不打断。

一问多答：轻松比较

无需重复提问。同时咨询多个"AI 专家"，在一个界面中并排查看它们的回复，方便比较，帮助您得出最佳结论。

一键启动

点击桌面上的悬浮球，即可唤醒或打开 ChatClaw 主应用窗口。

社区交流&联系我们

欢迎联系我们获取帮助，或者提供建议帮助我们改善 ChatClaw。您可以通过以下方式联系我们： 微信，使用微信扫码加入 ChatClaw 技术交流群，添加请备注"chatclaw"。

Server Mode Deployment

ChatClaw 支持以服务器模式运行（无需桌面 GUI），通过浏览器访问。

二进制直接运行

从 GitHub Releases 下载对应平台的二进制文件：

| 平台 | 文件 | |------|------| | Linux x86_64 | ChatClaw-server-linux-amd64 | | Linux ARM64 | ChatClaw-server-linux-arm64 |

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

浏览器打开 http://localhost:8080 即可使用。

服务默认监听 0.0.0.0:8080。可通过环境变量自定义监听地址和端口：

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

浏览器打开 http://localhost:8080 即可使用。

Docker Compose

创建 docker-compose.yml 文件：

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:

然后运行：

docker compose up -d

浏览器打开 http://localhost:8080 即可使用。停止服务：docker compose down。数据持久化在 chatclaw-data 卷中。

技术栈

| 层级 | 技术 | |------|------| | 桌面框架 | Wails v3 (Go + WebView) | | 后端语言 | Go 1.26 | | 前端框架 | Vue 3 + TypeScript | | UI 组件 | shadcn-vue (New York 风格) + Reka UI | | 样式方案 | Tailwind CSS v4 | | 状态管理 | Pinia | | 构建工具 | Vite | | AI 框架 | Eino (字节跳动 CloudWeGo) | | AI 模型供应商 | OpenAI / Claude / Gemini / Ollama / DeepSeek / 豆包 / 通义千问 / 智谱 / Grok | | 数据库 | SQLite + sqlite-vec (向量检索) | | 国际化 | go-i18n + vue-i18n | | 任务运行 | Task | | 图标 | Lucide |

项目结构

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 截图

Changelog

To view the complete update log, please click👉️👉️UpdateLog.md

2026/04/24

1. Multi-Language Localization Update: Updated localization files for Arabic, Bengali, German, Spanish, French, Hindi, and Italian, including translations for app titles, common phrases, tool descriptions, and various UI elements.
2. WhatsApp Channel Hotfix: Fixed WhatsApp channel initialization error configuration issue.
3. Skill Market Synchronization Enhancement: