holaOS：让 AI Agent 真正成为你的「桌面同事」

图1：holaOS 桌面工作空间 — Agent 与文件、工具并排协作

---

场景切入：当 AI 不再只是「问答机器」

想象一个场景：你让 AI 帮你 review 一个 PR，它花了 10 分钟阅读上下文，好不容易理解了项目结构，结果你关闭对话窗口后，它彻底「失忆」——下次再问同一个项目，又要重新解释一遍。大多数 AI 助手都是这样：用完即忘，无法持续。

holaOS 试图解决的根本问题，不是让 AI 回答更准确，而是让 AI 像一个真正的同事一样长期工作——记住你的项目背景、工具偏好、工作习惯，随时跟进，从不重新开始。

---

背景：Holaboss 是谁？

Holaboss AI 成立于 2024 年，是一家专注于 Agent 基础设施 的初创公司。其核心产品 holaOS 于 2025 年中开源，采用 Modified Apache 2.0 许可证，目标是将 AI Agent 从「聊天机器人」升级为「桌面级同事」。

项目 GitHub 已有 5497★，主要贡献者来自原 Vercel、Linear、Stripe 等公司背景。团队在社交媒体（X/Discord）活跃，文档体系完整（holaos.ai/docs）。

---

核心功能：从「单次问答」到「持续工作」

1. 100+ 工具一鍵接入

holaOS 通过 OAuth 一键连接你最常用的工作工具：Linear、GitHub、Slack、Jira、HubSpot、Gmail 等 100+ 集成。连接后，Agent 主动拉取 相关上下文，而不是等你提问才去查。

关键点：数据获取是用户授权制的，只有用户允许时才会访问工具数据。这解决了很多企业级 AI 助手的合规顾虑。

2. 本地优先的记忆管理系统

这是 holaOS 最具技术深度的模块。Agent 会将工作上下文压缩为本地的 Markdown 文件，存入 SQLite 向量数据库，通过 RAG 检索。

图2：Holaboss 组织头像

灵感来自 Karpathy 的 LLM Wiki 工作流，但做了更工程化的实现：记忆是用户可见、可编辑、可删除的——你永远知道 Agent 记住了什么，并拥有最终控制权。

记忆存储在本地（local-first），不锁定在任何第三方云服务中。

3. Safe Session Compaction（安全会话压缩）

大模型上下文窗口是有限的。holaOS 实现了智能会话压缩：保留 70% 窗口用于新鲜推理，保留当前工作集原文，将历史对话压缩为结构化检查点（目标、约束、进度、决策、下一步）。

遇到跨对话截断时，Agent 会尝试修复被截断的对话轮次，通过本地前缀摘要合并回快照。只有当活跃会话仍匹配快照时，才会合并回来——避免 Agent 被「记忆污染」。

4. 多 Agent 协作：主 Agent + 子 Agent

支持隐藏式子 Agent 并行工作：用户发起复杂任务时，主 Agent 可以调度多个子 Agent 在后台同时处理，最终汇总为一个易于审查的结果返回给你。这比一次性给你一堆中间结果体验好得多。

5. 浏览器Profile集成

通过集成浏览器 Profile，Agent 可以直接操作真实网站：填写表单、点击按钮、读取动态内容——不仅限于标准 API，真正做到「像人一样操作网页」。

---

技术架构：Electron 桌面 + TypeScript Runtime

整体架构

holaOS 采用 Monorepo 结构，使用 Bun 作为包管理器，主要分为三层：

Desktop 层（apps/desktop）：Electron 桌面应用，使用 Vite 构建，提供用户界面和浏览器渲染引擎。UI 部分采用 React 生态（components.json 配置）。

Runtime 层（runtime/api-server）：TypeScript 运行时，是 Agent 的核心执行引擎。使用 Fastify 作为 HTTP/WS 服务器，提供 REST API 和 WebSocket 双向通信。

SDK 层（sdk/app-builder-sdk）：App 构建 SDK，定义了 5 个正交原语：Connection（连接）、Resource（资源）、Action（动作）、Sync（同步）、Start（启动）。开发者可以基于此 SDK 声明式构建 Agent 工具模块。

核心技术栈

组件	技术选型
桌面框架	Electron
前端构建	Vite
后端框架	Fastify
通信协议	WebSocket（@fastify/websocket）、MCP（Model Context Protocol）
包管理器	Bun 1.3.6
内存存储	SQLite vec（向量检索）
认证集成	OAuth 2.0（Composio）
监控	Sentry
格式处理	js-yaml、tar、yauzl

App Builder SDK 设计

SDK 的核心理念是「声明式状态机 + 插件化后端」：

// SDK 5个正交原语
Connection  // 外部工具连接
Resource    // 数据资源抽象
Action      // 可执行动作
Sync        // 状态同步策略
Start       // 启动入口定义

开发者只需声明这 5 个维度，SDK 自动处理底层集成细节。

---

上手体验：安装与运行

安装方式

无 Docker 支持，提供引导式 install.sh 脚本：

curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/main/scripts/install.sh | bash

脚本会自动安装 Node.js 24（如缺失）、克隆仓库、配置环境变量、运行依赖安装。默认目标平台为 macOS，Windows/Linux 仍在完善中。

环境要求

• Node.js 24+
• Bun >= 1.3.6
• Git
• RAM >= 4GB，磁盘 >= 2GB
• 无 GPU 需求（纯推理/工具编排，不做本地模型推理）

开发模式

bun install
bun run desktop:prepare-runtime:local
bun run desktop:dev

构建发布

bun run desktop:dist:mac:local  # macOS
bun run desktop:dist:win:local  # Windows

项目有完整的 GitHub Actions CI/CD：类型检查（typecheck）、端到端测试（e2e）、SDK 发布、Runtime 发布。

---

争议与局限

1. 平台优先级割裂用户体验

项目 README 明确标注「macOS supported, Windows & Linux in progress」。在当前 AI 工具生态中，开发者普遍在 Linux 桌面工作，macOS 优先策略可能限制用户群。

2. Node.js 24 的前沿依赖

要求 Node.js 24（LTS 最新版），对于保守的服务器/部署环境来说过于前沿，增加了在企业内网环境部署的摩擦。

3. 本地记忆的隐私悖论

虽然数据存储在本地，但 Agent 通过 Composio 等服务调用外部工具时，部分数据仍然流经第三方 API。需要用户对 Composio 平台有信任。

4. 闭源云端服务的双重依赖

holaOS 桌面版开源，但 Holaboss 的云服务（holaos.ai/signin）并未开源。开源版本和云服务之间的边界、是否功能受限，用户无法完全知晓。

---

行业意义：AI OS 赛道的真实探索

holaOS 代表了 AI Agent 从「对话界面」向「操作系统」演进的探索方向。类似的项目还有 Claude Desktop、OpenAI Agents SDK，但 holaOS 的差异化在于：

• 桌面原生：不是网页，是真正的桌面应用，与本地文件系统深度集成
• 记忆持久化：不是聊天历史，而是结构化的、可查询的本地知识库
• 多 Agent 编排：子 Agent 并行 + 主 Agent 汇总，比单 Agent 更接近真实工作场景

5497★ 的社区关注度，说明市场对「AI 作为长期同事」这个愿景有强烈需求。holaOS 的开源策略和 App Builder SDK 的设计，让它不仅是一个产品，更是一个生态入口。

---

分析基于 GitHub 仓库 v1.0，stars: 5497（2026-06-20），代码采样：runtime/api-server/src/app.ts（Fastify + MCP）、sdk/app-builder-sdk、apps/desktop/electron。