| 悬浮球常驻桌面 | 双击快速提问 | 对话 + 文件处理 |
 |
 |
 |
| 按天记忆回顾 | Claw 的回忆日记 | Claw 人格与认知 |
 |
 |
 |
大多数 AI 产品还停留在"打开一个网页，向它提问"的范式里。
Desktop-Claw 想探索另一种方式：
不是把 AI 放进桌面壳子里，而是让 AI 真正成为桌面上的一个常驻伙伴。
它不是全知全能的超级 Agent，也不只是一个卖萌的桌宠。
它是一个小而稳定的桌面 AI Companion，做少、做轻、做有用。
🚧 项目正在积极开发中
- ● 悬浮球常驻桌面 — 随时唤起，不占 Dock ✅
- 💬 自然对话 — 承接上下文，流式响应 ✅
- 📄 文件读写与编辑 — 读取、创建、修改本地文件 ✅
- 🧠 稳定人格 — SOUL.md 定义人格，重启后风格一致 ✅
- 🐾 首次引导 — "互相认识"仪式，Claw 记住你的称呼和偏好 ✅
- 🗓️ 按天归档记忆 — 对话自动落盘，日历视图回顾历史 ✅
- 💭 记忆检索 — Claw 能回忆过去的对话，跨天不失忆 ✅
- 🧩 结构化记忆 — 自动提取人物画像、关系、话题，越聊越懂你 ✅
- 🔄 记忆纠错 — 对话中让 Claw 更正或遗忘记忆 ✅
- ⚡ Agent 状态提示 — 思考中、回忆中、读取文件中... 实时可见 ✅
- 📝 轻记录与待办 — 随手就能发生（规划中）
- 跨平台 — 支持 macOS 和 Windows，GitHub Actions 自动构建双平台安装包
- 常驻桌面 — 悬浮球形态，不占用 Dock 和任务栏，始终在视野边缘待命
- 实时流式响应 — 回答边生成边显示，不等待
- 稳定人格 — 由 SOUL.md 定义角色性格，不漂移、不走样，重启后还是同一个 Claw
- 按天记忆 — 每天的对话自动归档为 JSON，重启不失忆，用日历视图回顾历史
- 结构化记忆 — 6 类记忆对象（自我画像、关系、话题、来源、存档、原始对话），不是简单 RAG
- 后台记忆提取 — 对话过程中异步提取关键信息，静默积累长期记忆
- 每日归档内化 — 关机或日终时自动总结、写日记、提取事实，编译为人格文件
- 记忆纠错与遗忘 — 对话中告诉 Claw "你记错了"或"忘掉这个"，即时更正
- 首次引导 — 第一次见面有"互相认识"仪式，你可以塑造 Claw 的性格倾向
- 文件操作 — 读取桌面/文档/下载目录的文件，支持 .pdf / .docx / .xlsx 文本提取
- Agent 技能体系 — 三级渐进式披露，按需激活能力，不浪费 token
- 断线恢复 — WS 断连自动重连，流式中断不挂死，关机前自动归档
- 连续感 — 第一人称日记 + 情绪状态机 + 关机归档，不是工具，是伙伴
- 轻量无打扰 — 不主动推送，不占资源，常驻但不烦人
Desktop UI (悬浮球 + 对话面板 + 日历视图)
│
│ WebSocket + HTTP
▼
Gateway (入口层)
│
▼
Task Coordinator (FIFO 任务队列)
│
▼
Agent Loop (ReAct 循环)
│
┌────┼────────┐
▼ ▼ ▼
File Memory ...未来扩展
Skill Skill
│
▼
Prompt Assembler (6 层 System Prompt 组装)
│ Base · SOUL.md · USER.md · CONTEXT.md · Skills · BOOTSTRAP.md
│
▼
Memory System
├─ Memory Service (按天 JSON 归档 + 日终封存)
├─ Interpret Service (后台记忆提取)
├─ Maintain Service (日终维护与事实清洗)
├─ Capsule Compiler (编译 USER.md / CONTEXT.md)
└─ Index Service (5 类索引：self / relationship / topic / saved / source)
技术栈： Electron · React · TypeScript · Node.js · Fastify · OpenAI 兼容 API
前往 Releases 下载对应平台的安装包：
| 平台 | 文件 | 说明 |
|---|---|---|
| macOS (Apple Silicon) | .dmg |
双击打开，拖入 Applications |
| macOS (Apple Silicon) | .zip |
解压即用 |
| Windows (x64) | .exe |
Portable 免安装版，双击直接运行 |
macOS 安装：
- 下载
.dmg文件，双击打开，拖入 Applications - 首次打开需在「系统设置 → 隐私与安全性」中点"仍要打开"（未签名应用）
- 右键悬浮球 → 设置，填写 LLM API Key
Windows 安装：
- 下载
.exe文件，双击直接运行（免安装） - 右键悬浮球 → 设置，填写 LLM API Key
需要一个支持 Function Calling 的 LLM API Key（推荐 DeepSeek）。
前置要求：Node.js 20+ / pnpm 9+
# 克隆仓库
git clone https://github.com/DjTaNg-404/Desktop-Claw.git
cd Desktop-Claw
# 安装依赖
pnpm install
# 启动开发模式
pnpm dev首次启动后，右键悬浮球 → 设置，填写 LLM 配置（API Key、Base URL、Model）。配置保存在 data/config.json。
# macOS
pnpm run package:mac
# Windows
pnpm run package:win产物位于 apps/desktop/release/。推送 v* tag 时 GitHub Actions 会自动构建双平台并发布到 Release。
安装后数据存储位置：
- macOS:
~/Library/Application Support/Desktop-Claw/data/ - Windows:
%APPDATA%/Desktop-Claw/data/
| 阶段 | 内容 | 状态 |
|---|---|---|
| 基础架构 | 架构设计与技术选型 | ✅ 完成 |
| 核心闭环 | 桌面入口 + Agent Loop + 基础工具 | ✅ 完成 |
| 体验稳定 | 人格体系 + 记忆归档 + 断线重连 + 日历视图 | ✅ 完成 |
| 记忆系统 | 结构化记忆 + 后台提取 + 日终内化 + 记忆纠错 | ✅ 完成 |
| 发布就绪 | 打包分发 + 数据路径适配 + 跨平台 | ✅ 完成 |
Claw（爪子）是一种有趣的存在感——轻轻搭在你桌面的边缘，随时在，不打扰，但你知道它在。
这个名字来自 OpenClaw 项目的技术理念，Desktop-Claw 借鉴了其 Agent 架构思想，并将其裁剪为适合桌面 Companion 的最小可用形态。
- Companion-first — 先做有陪伴感的伙伴，再做能力强大的工具
- 轻执行优先 — 高频、轻量、低风险的任务；不做高风险系统控制
- 常驻但不打扰 — 有存在感，但不主动推送、不占注意力
- 先成立，再成长 — MVP 先让体验成立，后续再演化为桌宠形态
欢迎 Issues 和 Discussions！
目前项目处于早期阶段，如果你对桌面 AI Companion 这个方向有想法，欢迎：
- 提交 Issue 描述你希望看到的功能
- 在 Discussions 讨论产品方向
- 欢迎提交 PR
Build in Public · Made with ❤️ by a solo developer
如果你也对"桌面 AI 陪伴"这个方向感兴趣，欢迎 Star ⭐