快速上手
5 分钟完成安装、配置，发送第一条消息。
系统要求
| 平台 | 最低要求 |
|---|---|
| macOS | 12 Monterey 及以上，Apple Silicon / Intel |
| Windows | Windows 10 (1809+)，x64 |
| Linux | Ubuntu 20.04+ / Fedora 36+，x64 |
安装
方式一：下载安装包
前往 GitHub Releases 下载对应平台安装包：
- macOS：
.dmg— 拖入 Applications 即可 - Windows：
.msi或.exe— 双击安装 - Linux：
.AppImage或.deb
方式二：源码编译
git clone https://github.com/everyday-items/hexclaw-desktop.git
cd hexclaw-desktop
pnpm install
pnpm tauri dev提示：源码编译需要 Node.js 18+、pnpm、Rust 1.70+ 和 Go 1.21+（用于 Sidecar 引擎）。
首次配置
1. 配置 AI 服务商
打开应用后进入 设置 → 模型服务商，添加至少一个 AI 服务商：
- OpenAI — 填入 API Key（
sk-...），支持 GPT-4o / GPT-4-Turbo / o1 / o3-mini - DeepSeek — 填入 API Key，支持 DeepSeek-V3 / DeepSeek-R1
- Anthropic — 支持 Claude Sonnet 4 / Claude Opus 4 / Claude Haiku 4.5
- Google Gemini — 支持 Gemini 2.5 Flash/Pro（含视频/音频能力）
- 阿里 Qwen — 通义千问系列，含视觉模型
- 字节 Ark（豆包） — 豆包系列，含视觉模型
- Ollama（本地） — 无需 API Key，支持 Llama / Qwen / Mistral / DeepSeek 等本地模型
- 自定义 — 任何兼容 OpenAI API 格式的服务
2. 选择默认模型
在服务商配置中，勾选一个模型作为默认聊天模型。
3. 发送第一条消息
进入 对话 页面，在输入框输入任意内容，按回车发送。支持流式输出，实时显示 AI 回复。
应用架构
HexClaw Desktop 采用 Tauri v2 + Vue 3 + Go Sidecar 架构：
- 前端：Vue 3 + TypeScript + Pinia + TailwindCSS
- 桌面壳：Tauri v2（Rust），负责窗口管理、系统托盘、全局快捷键
- AI 引擎：Go Sidecar（hexclaw），负责模型调用、工作流执行、知识库、记忆等核心逻辑
- 数据库：SQLite，本地存储会话和消息
数据隐私：所有数据存储在本地，不经过任何第三方服务器（除你配置的 AI API 外）。
界面概览
HexClaw 提供 14 个功能页面：
| 页面 | 功能 |
|---|---|
| 仪表盘 | 全局统计：会话数、消息数、Agent 数、知识库、引擎状态 |
| 对话 | 多模型聊天、流式输出、Artifact 预览、消息导出 |
| Agent | 创建/管理 AI 角色，多 Agent 会议模式 |
| 工作流画布 | 可视化拖拽编排，DAG 执行引擎 |
| 定时任务 | Cron 定时调度 Agent 自动执行 |
| 技能市场 | 安装/管理技能插件 |
| 知识库 | 文档上传、RAG 向量检索 |
| 记忆 | 跨会话语义记忆管理 |
| MCP | Model Context Protocol 服务器注册和工具发现 |
| 日志 | 实时 WebSocket 日志流 |
| 团队 | 共享 Agent、成员协作 |
| 设置 | 服务商配置、安全策略、外观主题、通知 |