1. 项目定位与用途
holaOS 是 Holaboss 推出的 AI 代理环境平台，定位为代理的长期工作操作系统。它不仅仅是一个执行框架，而是为代理提供完整的运行时环境，包括内存管理、工具调用、应用集成和持久化状态存储。其核心用途是让 AI 代理能够像人类一样在连续的工作会话中保持上下文、积累经验并自我改进，而非每次任务都从零开始。这适用于需要长期规划、多步骤执行和适应性学习的代理场景。
项目档案应用项目
holaOS - AI 代理长期工作环境与自我进化平台 | Electron 桌面应用安装、使用及技术架构详解
holaOS 是 Holaboss 开发的 AI 代理环境，提供结构化运行时、持久化状态与自我进化能力，支持长期连续任务执行。本文介绍其作为 Electron 桌面应用的安装方式、核心模块（desktop、runtime、sdk）、集成架构及使用指南，适用于 macOS 平台（Windows/Linux 开发中）。
AI 总结
holaOS 是一个专为 AI 代理设计的长期工作环境，提供结构化运行时、持久化状态与自我进化能力，使代理能够连续执行任务而非一次性运行。
中文项目介绍
holaOS 是 Holaboss 开发的面向 AI 代理的长期工作环境，旨在解决代理在长期任务中的连续性与状态保持问题。它提供结构化的操作系统层，包括运行时、内存、工具、应用和持久化状态，使代理能够跨运行周期持续工作、自我进化，并保持可检查性，避免每次执行都重置为一次性任务。
项目以 Electron 桌面应用形式呈现，当前已支持 macOS，Windows 与 Linux 版本正在开发中。技术栈采用 TypeScript 运行时，Node.js 24.14.1，并通过 monorepo 结构组织代码，核心模块包括 desktop（桌面 UI）、runtime（harness-host、state-store、api-server）以及 sdk（app-sdk、bridge）。设计上定义了集成架构（集成目录、连接与绑定存储）、Composio OAuth 桥接模式、市场 UI 组件以及工作区自动绑定流程，构建安全、可进化、开发者友好的代理生态系统。
详细信息与使用说明
2. 解决的问题
传统 AI 代理系统通常面临‘一次性执行’困境：每次调用都重置状态，无法维持长期记忆或连续性工作。holaOS 通过提供结构化操作系统层解决此问题：1) 持久化状态存储确保代理跨运行周期保留记忆与学习成果；2) 运行时环境管理代理生命周期与资源隔离；3) 工具与应用集成层使代理能操作外部系统；4) 可检查性设计允许开发者监控代理决策过程。此外，集成架构与 Composio 桥接模式解决了安全凭证管理与能力暴露的统一问题。
3. 适用场景
holaOS 适用于以下场景：1) AI 代理的长期自动化任务执行，如持续数据收集、系统监控；2) 需要状态持久化的连续工作流，例如跨会话的个人助理或企业流程自动化；3) 可自我进化的代理系统开发，代理能根据历史经验优化策略；4) 代理执行过程的监控与调试，通过可检查性设计追踪决策链；5) 多工具集成环境，代理需安全调用第三方服务（通过 Composio 桥接）。当前主要面向 macOS 用户，Windows/Linux 支持正在推进中。
4. 安装方式
holaOS 提供一键安装脚本，支持 macOS、Linux 或 WSL 环境。 prerequisites 包括 curl 和 bash，安装器会自动 bootstrap git、Node.js 24.14.1 和 npm。执行命令：curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaboss-ai/main/scripts/install.sh | bash -s -- --launch。该脚本会克隆仓库至 ~/holaboss-ai，创建 desktop/.env 配置文件，并运行 desktop:install、desktop:prepare-runtime:local 和 desktop:typecheck 等准备步骤。若需手动控制，可参考仓库中的 Manual Install 部分，但具体步骤未在提供信息中详述。
5. 使用方式
安装完成后，可通过 npm run desktop:dev 启动本地开发环境，启动 Electron 桌面应用。在桌面工作空间中与代理交互，执行长期任务。运行 npm run desktop:e2e 可执行端到端测试套件。完整的产品与技术文档位于 holaboss.ai/docs，包括快速入门、学习路径、环境工程 thesis 和核心概念说明。对于 SDK 开发，可进入 sdk/app-sdk 或 sdk/bridge 目录进行构建；runtime 模块（harness-host、state-store、api-server）有独立的安装、构建和测试脚本，通过根 package.json 的 runtime:* 系列命令调用。
6. 补充说明与实现特点
holaOS 采用 monorepo 结构，模块间通过 npm 或 bun 管理依赖。技术实现上，集成架构分为四层：集成目录（能力声明）、连接存储（OAuth 凭证）、绑定存储（连接与集成映射）和代理模型（访问绑定）。Composio 作为 OAuth 后端，Holaboss 运行时通过桥接 API 提供 execute 和 proxy 原语，确保应用不直接接触凭证。市场 UI 组件（KitCard、KitDetail、MarketplaceGallery）用于模板发现与选择。工作区创建流程支持自动集成检测与绑定，提升配置效率。当前版本聚焦 macOS 平台，跨平台支持正在进行。
思维导图
holaOS 项目结构
Desktop
Electron App
UI Components
E2E Tests
Runtime
Harness Host
State Store
API Server
SDK
App SDK
Bridge (Bun)
Integration
Directory
Connection Storage
Binding Storage
Composio Bridge
Marketplace
KitCard
KitDetail
Gallery
Workspace
Auto-Bind
Runtime Preparation
常见问题
holaOS 是什么？
holaOS 是面向 AI 代理的长期工作环境，提供结构化的操作系统层（运行时、内存、工具、应用、持久状态），使代理能连续工作、自我进化并在运行间保持可检查性，而非一次性执行。
如何安装 holaOS？
在 macOS、Linux 或 WSL 上，使用一键安装命令：curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaboss-ai/main/scripts/install.sh | bash -s -- --launch。安装器会自动安装 git、Node.js 24.14.1 和 npm，并完成环境准备。
holaOS 支持哪些平台？
当前 macOS 版本已正式支持；Windows 和 Linux 版本正在开发中，尚未完整发布。
holaOS 的主要模块有哪些？
项目采用 monorepo 结构，主要模块包括：desktop（Electron 桌面应用与 UI）、runtime（包含 harness-host、state-store、api-server 三个子模块，提供运行时服务）、sdk（包含 app-sdk 和 bridge，供应用开发与桥接交互）。
如何启动 holaOS 开发环境或运行测试？
运行 npm run desktop:dev 启动本地开发环境；运行 npm run desktop:e2e 执行端到端测试。runtime 各子模块有独立脚本（如 runtime:harness-host:test），可通过根 package.json 命令调用。