一天一个开源项目（第209篇）：holaOS - Agent 原生的本地工作台

引言

"Apps and agents, side by side. Built for how work actually happens."

这是"一天一个开源项目"系列的第 209 篇文章。今天带你了解的项目是 holaOS。

用 AI 处理工作任务的常见体验是这样的：你在 Notion 里写文档，然后切换到 Claude 窗口，复制粘贴内容，解释上下文，等待输出，再复制回去。每一次切换都是一次上下文损耗------你得不断"转述"你刚刚做了什么。

holaOS 想解决的是这个根本问题：Agent 和应用应该共存在同一个工作空间，而不是两个互相隔离的世界。

在 holaOS 里，Notion、浏览器、自定义应用作为可交互的活动界面和 Agent 并排显示。你在界面里做的操作，Agent 自动感知------你不需要停下来解释"我刚刚做了什么"。

11.1k Stars，Modified Apache 2.0，holaboss 团队开发。

你将学到什么

HolaApps 概念：应用作为 Agent 上下文的双向数据来源
本地文件式共享记忆系统的设计
三个 Agent（Claude Code、Codex、holaOS 内置）共享工具和记忆的方式
IM 集成（Slack、飞书、钉钉、微信）如何向 Agent 提供真实对话上下文
HolaHub 社区 Recipe 平台的运作机制
企业级特性：SSO、审计日志、私有云部署

前置知识

了解 AI Agent 和工具调用的基本概念
知道什么是 MCP（Model Context Protocol）
了解 Electron 桌面应用基础（可选）

项目背景

项目简介

holaOS 是一个Agent 原生工作台（Agentic Workspace），核心主张是：在同一个界面里，应用和 Agent 并排运行，共享内存、工具和集成。

它不是一个 AI 聊天工具，也不是一个应用启动器，而是一种工作方式的重新设计：

Agent 可以读取你正在使用的应用的真实状态
你在应用里的操作自动成为 Agent 的上下文
多个 Agent（Claude Code、Codex、holaOS 内置）共享同一套工具和记忆，无需重新配置

官方的核心理念：

"Composable parts that fit your workflow rather than forcing you to adapt to ours. Everything runs locally by default."

作者/团队介绍

团队: holaboss AI（holaboss-ai）
官网 : holaboss.ai
技术栈 : holaboss 旗下包含三个产品：holaOS （开源桌面工作台）、holaProxy （跨模型 API 网关）、Neo Lab（内部研究实验室）
许可证: Modified Apache 2.0（附加商业分发和品牌使用条款）

项目数据

⭐ GitHub Stars: 11,100+
🍴 Forks: 720
📄 License: Modified Apache 2.0
💻 主要语言: TypeScript（Electron 桌面应用）
🌐 官网: holaboss.ai
📦 支持平台: macOS（Apple Silicon / Intel）、Windows、Linux

主要功能

核心作用

holaOS 的架构围绕三个核心层：

css 复制代码

┌──────────────────────────────────────────────────────────┐
│              holaOS 工作台（本地 Electron 桌面）            │
│                                                          │
│  ┌────────────────┐    ┌────────────────────────────┐   │
│  │  HolaApps      │    │  Agent（任意一个或多个）     │   │
│  │  Notion        │◄──►│  Claude Code               │   │
│  │  Browser       │    │  Codex                     │   │
│  │  自定义 URL     │    │  holaOS 内置 Agent          │   │
│  └────────────────┘    └────────────────────────────┘   │
│          ▼                          ▼                    │
│  ┌────────────────────────────────────────────────────┐  │
│  │          共享记忆（本地文件，跨会话跨 Agent）          │  │
│  └────────────────────────────────────────────────────┘  │
│          ▼                          ▼                    │
│  ┌────────────────┐    ┌────────────────────────────┐   │
│  │  50+ 集成       │    │  MCP 服务器                 │   │
│  │  Gmail/Notion  │    │  一键安装社区 MCP            │   │
│  │  Slack/GitHub  │    └────────────────────────────┘   │
│  └────────────────┘                                      │
└──────────────────────────────────────────────────────────┘

使用场景

软件开发工作台
- Claude Code 和 Codex 并行运行，共享同一个代码库上下文。GitHub 集成自动提供 PR 状态，浏览器 Agent 可以直接测试接口。
内容创作工作流
- Notion 作为 HolaApp 打开，Agent 在旁边根据 Notion 页面内容生成补充材料，输出真实 .docx 和 .pptx 文件。
团队 IM 上下文接入
- Agent 直接读取 Slack 频道或飞书群聊里的真实对话，而不是让用户手动总结。适合"整理周会记录"或"根据群聊决策生成任务清单"。
企业自动化流水线
- 定时或触发式任务：每天早上生成项目进度摘要，监控特定指标，自动归档报告。
本地隐私工作
- 所有文件、记忆、嵌入向量、会话历史存在本地磁盘，不经过任何服务器。适合处理敏感文档。

快速开始

bash 复制代码

# 一键安装并启动
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch

本地开发：

bash 复制代码

git clone https://github.com/holaboss-ai/holaOS.git
cd holaOS
bun install

# 安装桌面依赖
npm run desktop:install

# 准备本地运行时
npm run desktop:prepare-runtime:local

# 开发模式
npm run desktop:dev

核心特性

1. HolaApps：应用作为活动界面

这是 holaOS 最核心的概念。传统 AI 工具里，应用和 Agent 是分离的------你在 Notion 里做了什么，必须手动告诉 Agent。

HolaApps 把应用变成 Agent 的实时上下文提供者：

复制代码

传统方式：
用户在 Notion 写内容 → 复制粘贴 → 切换到 AI 窗口 → 解释上下文 → 等待输出 → 复制回 Notion

holaOS 方式：
用户在 HolaApp（Notion）里操作 → Agent 自动感知变化 → 直接生成 / 修改
↑ 操作在界面里，Agent 在旁边，共享上下文，没有切换，没有解释

任何 URL 都可以成为 HolaApp：配合 MCP 服务器，指向任意 Web 应用，在工作台内运行。

2. 共享记忆系统

记忆是 holaOS 的基础设施，而不是附加功能：

存储格式：本地磁盘上的普通文件（不是黑盒数据库）
跨会话：关闭再打开，记忆完整保留
跨 Agent：Claude Code 积累的项目上下文，Codex 同样可以访问
结构化 + 向量嵌入：支持精确检索
完全透明：可以直接打开文件查看、编辑、删除

"A folder you can read, not a black box."

这个设计决策意味着记忆是用户的资产，而不是应用的锁定点。

3. 多 Agent 协作

三个 Agent 在同一个工作台共存，共享同一套环境：

Agent	特点
holaOS 内置 Agent	通用任务，深度集成工作台功能
Claude Code	复杂代码任务，Anthropic 官方 CLI
Codex	OpenAI 代码生成，支持 BYOK

切换 Agent 不需要重新配置------同样的集成、同样的记忆、同样的技能，换一个 Agent 执行就行。

4. IM 上下文读取

支持平台：Slack、飞书（Feishu）、钉钉（DingTalk）、微信（WeChat）

Agent 可以直接读取你的 IM 频道/群聊，使用真实对话作为上下文，而不是用户自己写的总结。每个工具连接需要单独授权，读取范围明确。

5. 技能（Skills）与 MCP

50+ OAuth 集成：Gmail、Notion、Slack、GitHub、Linear 等一键连接，所有 Agent 自动继承，无需重复配置
MCP 服务器：任意 MCP 服务器一键接入，扩展 Agent 工具集
技能（Skills）：打包一个工作流，任意 Agent 可以按需调用
Combos：技能 + 集成打包成一个可安装单元，一键复制完整工作流

6. 文档与多媒体生成

Agent 输出不只是文本：

真实文件：.xlsx、.pptx、.docx
图片、视频、音频生成（内置于所有 Agent）
适合"生成一份本周进度 PPT"或"制作产品介绍海报"这类任务

7. 浏览器控制

Agent 可以操控已登录的浏览器，完成需要认证的网页操作。所有操作在用户控制下进行，不是无监督的自动化。

8. 企业特性

特性	说明
SSO	基于角色的权限，精细到 Agent / 技能 / 应用级别
审计日志	每个操作完整记录
内部系统连接	不暴露到外网
私有云 / On-prem	完整自托管选项

项目详细剖析

本地优先的隐私架构

holaOS 的隐私保护是架构决策，不是策略承诺：

vbnet 复制代码

本地磁盘（永远在这里）：
  ├── workspace files/      ← 工作文件
  ├── memory/               ← Agent 记忆（普通文件，可直接查看）
  ├── embeddings/           ← 向量索引
  └── session_history/      ← 会话记录

外部网络（只有在你明确授权时）：
  ├── 模型 API 调用（你的 API Key，你的账单）
  ├── 集成 OAuth（Gmail、GitHub 等，按需授权）
  └── MCP 服务器（每个连接单独授权）

"It isn't a policy we promise; it's a place your data never goes."

技术架构：Electron Monorepo

makefile 复制代码

holaOS/
  apps/
    desktop/       ← Electron 主应用
    web/           ← Web 界面层
  packages/        ← 共享包
  runtime/         ← 运行时环境
  shared/          ← 跨包共享逻辑
  docs/            ← 文档
  scripts/         ← 构建/安装脚本

构建工具: Bun + Turborepo
Node 版本: 固定在 .nvmrc（推荐用 nvm 管理）

HolaHub：Recipe 共享平台

HolaHub 是内置于工作台的社区 Recipe 平台。一个 Recipe 包含：

ini 复制代码

Recipe = 模型选择 + Prompt + 技能集 + MCP 服务器 + 集成

发布一个 Recipe，其他人一键安装，得到完全相同的 Agent 配置------不只是分享 Prompt，而是分享整个工作流。

HolaHub 的发布还会暴露"过程"：技能背后的会话、图片/视频生成背后的 Prompt。这让分享从"结果展示"变成"过程透明"。

与其他 Agent 工具的定位差异

工具	定位	核心差异
Claude.ai / ChatGPT	AI 聊天界面	应用和 AI 分离
Cursor / Claude Code	代码专用 Agent	单一场景，无通用工作台
n8n / Make	自动化平台	侧重工作流，非实时协作
holaOS	Agent 原生工作台	应用 + Agent 共享屏幕，共享记忆

holaOS 的差异化在于"并排"------不是 Agent 执行完之后你再看结果，而是你工作的同时 Agent 在旁边实时感知和辅助。

项目地址与资源

官方资源

🌟 GitHub : github.com/holaboss-ai...
🌐 官网 : holaboss.ai
📦 安装 : curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch

总结与展望

核心要点回顾

HolaApps 是根本创新：应用作为 Agent 的活动上下文提供者，双向同步，消除切换成本
记忆是基础设施：本地文件、跨会话跨 Agent、用户完全可见可控------不是黑盒
多 Agent 无锁定：Claude Code、Codex、holaOS 内置 Agent 共享同一环境，按需切换
IM 上下文是真正的工作记录：读取 Slack/飞书的真实对话，比用户自己写的总结准确得多
本地优先是架构决策：数据不出设备是物理保证，不是合规承诺

适用人群

需要 AI 深度融入日常工作流的开发者和知识工作者：不只是"聊天"，而是真正和工作应用集成
使用飞书/钉钉的中国团队：原生支持，Agent 可以直接接入公司 IM 上下文
重视数据隐私的企业用户：本地优先架构 + SSO + 审计日志 + 私有云部署
想复用和分享工作流的团队：HolaHub Recipe 平台让成功的工作流一键复制给全团队

一句话评价

holaOS 在问一个值得问的问题：如果 AI 和应用真的并排工作，工作效率会是什么样？

欢迎访问 PrimeSkills ------ 一个精心策划的 AI Agent 与技能市场，所有内容均经过真实企业级工作流验证。没有噱头，只有真正有效的东西。

更多实用知识和有趣产品，欢迎访问我的个人主页