holaboss-ai/holaOS

你的超级工作 Agent：本地优先，几分钟内学习你的工作上下文且永不遗忘

官网 · 文档 · 登录 · 快速开始

# HolaOS（什么是 HolaOS）：

HolaOS 是你的超级工作 Agent：本地优先，几分钟内学习你的工作上下文且永不遗忘，以下是核心功能： - **100+ 集成与自动获取功能，让 Agent 在几分钟内了解你的工作状态** 通过一键 OAuth，你的 Agent 可连接到你每天都在使用的工具、浏览器配置和本地文件 —— 包括 Linear、GitHub、Slack、Jira、HubSpot、Gmail 等 100 多种工作平台集成。 无需再复制更新、粘贴链接或反复解释背景。Agent 会在几分钟内（仅在您允许的情况下）自动从你的工具中获取相关信号，并将分散的应用数据转化为工作记忆。当你需要时，Agent 会带回正确的上下文。 - **记忆管理系统，让你的 Agent 永不遗忘工作记忆** 你的 Agent 永远不会从零开始工作 —— 它会记住你的工作上下文和进度，并在你需要继续时带回正确的记忆。该 Agent 会从工作区文件、浏览器状态、集成和工作活动中构建一个本地优先的、压缩的知识库，将来自 Gmail、Slack、Notion、GitHub 和 Jira 等工具的原始数据转化为持久记忆。受 Karpathy 的 LLM wiki 工作流启发，这些记忆以 Markdown 格式存储在本地，使用 SQLite vec 进行 embedding，并通过 RAG 进行检索，在保留关键事实和上下文的同时，让回忆变得更快捷、更可控，也让你和 Agent 都更容易使用。你可以打开、浏览和编辑它们。 - **Session 上下文压缩，保持工作上下文新鲜及 token 效率** Agent 记住过去，同时不牺牲其对当前任务的思考能力。通过我们的安全 Session 压缩：长时间运行的 Agent 只有在连续工作数天后仍能保持连贯性才有用，而不仅仅依赖于一个巨大的 prompt。holaOS 将约 70% 的模型窗口保留用于全新推理，逐字保留活动的工作集，并将较早的历史记录折叠成结构化的检查点，其中包含目标、约束、进度、决策、下一步行动、关键上下文和文件活动。它会在可能的情况下在合理的边界处切断历史记录，在必要时通过本地前缀摘要修复拆分的对话轮次，并且 仅在当前实时 Session 仍然匹配时，才对快照执行压缩并将其合并回去。这样做的结果是实现了持久的连续性，而不会像通常那样逐渐陷入臃肿、昂贵且脆弱的 Session 之中。 - **简洁 UI 与用户友好** 通过桌面应用程序而不是终端来使用 Agent。你可以在一个简单的 UI 中管理任务、检查文件、查看输出并与你的 Agent 交互 —— 无需 CLI。本地文件系统将工作产物从冗长的对话中剥离出来，因此计划、草稿、笔记、生成的文件、配置和输出都保存在一个你 和 Agent 都可以访问和编辑的可见工作区中。只需一个账号，即可使用领先的 SOTA 模型，无需管理不同的提供商、API 密钥或繁琐设置。对于复杂任务，隐藏的子 Agent 可以并行工作，而编排 Agent 则会将进度和交付成果整合为一个易于审查的结果。一键集成你的浏览器配置，以支持 Agent 跨越网站、仪表板和应用程序处理真实的基于网络的工作，而不仅限于标准 API 或集成。 - **记忆永远不脱离你的控制** 你的 Agent 会学习你的工作，但你的工作记忆始终保留在你的电脑中。基于本地优先构建，你的数据不会被锁定在他人的云中。 你可以查看 Agent 记住了什么，进行编辑，删除不应该保留的内容，并控制要获取或回忆的内容。记忆始终是可见的、可调整的，并且完全属于你。 # 工作 Agent 记忆机制 该 Agent 会根据连接到你的工作区的文件、浏览器状态、集成和工作活动，创建一个本地优先的知识库。在成为记忆之前，来自 Gmail、Slack、Notion、GitHub 和 Jira 等工具（通过一键 OAuth）的信息会被总结和压缩，因此 Agent 无需从头搜索每一封原始邮件、消息、文档或工单。 记忆以 Markdown 文件的形式本地存储在你的机器上，并使用 SQLite vec 进行 embedding。这为 Agent 提供了一个持久的结构，它可以通过 RAG 从中进行检索，同时让底层工作区状态始终处于你的控制之下。受 Karpathy 的 LLM wiki 工作流启发，该系统将连接的工作数据转换为可浏览、压缩的记忆，你和 Agent 都可以使用。 这种压缩层保留了原始数据中重要的工作事实、关系和上下文，同时使记忆检索更快，也更容易让 Agent 进行选择。你的工作区无需手动将每个细节带回对话中，而是维护着关于发生了什么、什么重要以及 Agent 接下来应该查看什么的实时记忆。

# HolaOS 与其他 Agent 的对比 影响 Agent 使用的核心维度的高层概览： | | OpenClaw | Hermes Agent | Openhuman | HolaOS | | --- | --- | --- | --- | --- | | Agent 定位 | ✅通用 Agent | ✅通用 Agent | ✅个人 Agent | 🔥工作 Agent | | 启动便捷度 | ⚠️ 终端优先 | ⚠️ 终端优先 | ⚠️ 基础 UI | ✅生产级 UI | | 记忆 | ⚠️ 依赖插件 | ⚠️ 自学习 | ✅记忆树 + Obsidian 库，可选 agentmemory 后端 | 🔥企业级记忆机制：记忆树 + 语义 Embedding + RAG | | 集成 | 🚫BYOK | 🚫BYOK | ✅118+ 通过 OAuth | 🔥1000+ 通过 OAuth + 工作稳定 | | 成本 | 🚫BYO 模型 | 🚫BYO 模型 | ✅Token 消耗大 | 🔥每个原生工具 token 优化器 | | API 蔓延 | 🚫BYOK | ⚠️ 多供应商 | ✅单账号，每个集成单账户 | ✅单账号 + 每个集成多账户 | | 自动获取 | 🚫无 | 🚫无 | ✅20 分钟同步至记忆 | ✅30 分钟同步至记忆 | | 原生工具 | ✅仅代码 | ✅仅代码 | ✅代码 + 搜索 + 爬虫 + 语音 | 🔥代码 + 网页搜索 + 浏览器使用 + 广泛搜索 | | 模型选择 | 🚫BYOK | 🚫BYOK | ⚠️仅一个 | 🔥单账号畅享所有 SOTA 模型 | | 工作区 | 🚫无 | 🚫无 | 🚫无 | 🔥专为数字工作构建的工作区 | ## 目录 - [快速开始](#quick-start) - [环境要求](#what-you-need) - [一键安装](#one-line-install) - [文档](#documentation) - [手动安装](#manual-install) - [一键配置 Agent](#one-line-agent-setup) - [贡献](#contributing) - [OSS 发布说明](#oss-release-notes) ## 快速开始 ### 一键安装 对于在 macOS、Linux 或 WSL 上的全新机器初始化，请使用仓库安装程序： ``` curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch ``` 如果你想控制每个设置步骤，也可以按照手动路径进行操作。 ## 文档 所有更深入的技术和产品文档均位于 **[holaos.ai/docs](https://www.holaos.ai/docs)**： | 章节 | 涵盖内容 | | --- | --- | | [概述](https://www.holaos.ai/docs/getting-started) | 环境工程核心主旨与系统模型的合并入口页面 | | [快速开始](https://www.holaos.ai/docs/getting-started/quick-start) | 搭建可用的本地桌面环境的最快途径 | | [工作区](https://www.holaos.ai/docs/getting-started/workspaces) | 工作区是如何创建、切换、管理以及在磁盘上表示的 | | [环境工程](https://www.holaos.ai/docs/concepts/environment-engineering) | holaOS 背后的核心主旨以及为什么环境决定系统 | | [核心概念](https://www.holaos.ai/docs/concepts/concepts) | 关于工作区、runtime、记忆和输出的核心系统词汇 | | [工作区模型](https://www.holaos.ai/docs/concepts/workspace-model) | 工作区契约、创作面和 runtime 所拥有的状态 | | [记忆与连续性](https://www.holaos.ai/docs/concepts/memory-and-continuity) | 持久记忆、连续性产物以及长周期任务恢复行为 | | [Agent 框架](https://www.holaos.ai/docs/concepts/agent-harness) | runtime 内部稳定的框架边界以及执行器如何融入其中 | | [独立部署](https://www.holaos.ai/docs/contribute/runtime/independent-deploy) | 在没有桌面应用的情况下运行便携式 runtime | | [在 holaOS 上构建](https://www.holaos.ai/docs/contribute) | 用于桌面、runtime、应用、模板和验证路径的符合代码真实情况的开发者路线图 | | [开始开发](https://www.holaos.ai/docs/contribute/start-developing) | 用于桌面和 runtime 验证的本地开发者路径 | | [Runtime API](https://www.holaos.ai/docs/contribute/runtime/apis) | 用于工作区、运行、流式传输和应用生命周期的 runtime 操作面 | | [构建你的第一个应用](https://www.holaos.ai/docs/build/apps/first-app) | 在 holaOS 之上构建工作区应用 | | [参考](https://www.holaos.ai/docs/reference/environment-variables) | 环境变量及支持参考资料 | ## 手动安装 你可能不需要此部分，因为一键安装运行的是相同的设置。当你想检查或控制每一个步骤时，请使用手动安装。如果你使用手动路径，请首先验证通常的前置条件： ``` git --version node --version npm --version ``` ### 一键配置 Agent 如果你使用 Codex、Claude Code、Cursor、Windsurf 或其他编码 Agent，你可以用一句话将设置说明交给它： ``` Run the holaOS install script from https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh. It should install git and Node.js 24.14.1/npm if they are missing, clone or update the repo into ~/holaboss-ai unless I specify another --dir, run desktop:install, create apps/desktop/.env from apps/desktop/.env.example if needed, run desktop:prepare-runtime:local and desktop:typecheck, and only run desktop:dev if I ask for --launch. If Electron cannot open, stop after verification and tell me the next manual step. ``` 这种交接保持了安装流程的独立完整，同时将详细的基础部署步骤留在了仓库本地的 [INSTALL.md](INSTALL.md) 运行手册中。 这是本地桌面开发的基础安装流程。 1. 从仓库根目录安装桌面端依赖： ``` npm run desktop:install ``` 2. 创建你的本地环境文件： ``` cp apps/desktop/.env.example apps/desktop/.env ``` 如果你完全按照仓库操作，请保持文件与模板相近，仅更改你的提供商或机器所需的值。 规范路径为 `apps/desktop/.env`。目前现有的旧版 `desktop/.env` 文件仍然被接受，但新设置应使用 `apps/desktop/.env`。 3. 准备本地 runtime bundle： ``` npm run desktop:prepare-runtime:local ``` 4. 如果你想在启动 Electron 之前进行一次快速验证，请运行： ``` npm run desktop:typecheck ``` 5. 在开发模式下启动桌面应用： ``` npm run desktop:dev ``` `predev` 钩子将验证环境，重新构建原生模块，并确保存在一个暂存的 runtime bundle。 如果你想在打开桌面应用之前暂存 runtime，有两条常用路径： 从本地 runtime 构建： ``` npm run desktop:prepare-runtime:local ``` 获取最新发布的 runtime： ``` npm run desktop:prepare-runtime ``` 当你正在积极修改 runtime 代码时，请使用本地路径。当你想根据已知的发布产物验证桌面端时，请使用已发布的 bundle。 当你想寻找通往可用的本地桌面环境的最快路径时，请使用 `一键安装`。当你需要自行检查或控制每个设置步骤时，请使用 `手动安装`。 ## 贡献 如果你想做出贡献，请从 [开始开发](https://www.holaos.ai/docs/contribute/start-developing) 开始，让本地桌面和 runtime 循环工作起来，然后使用 [贡献指南](https://www.holaos.ai/docs/contribute/start-developing/contributing) 了解验证、提交和审查的期望。 ## OSS 发布说明 - License：修改版的 Apache 2.0，包含额外的商业分发和品牌条件。请参阅 [LICENSE](LICENSE)。 - 安全问题：请私下发送邮件报告至 `admin@holaboss.ai`。请参阅 [SECURITY.md](SECURITY.md)。

标签：AI 助手, Electron, MITM代理, TypeScript, 安全插件, 效率工具, 本地优先, 自动化攻击