holaOS：一个空间运行任意 Agent，共享记忆

面向你和你 Agent 的电脑

在任何 Agent——Claude Code、Codex 或 holaOS——中运行，全部集中在同一个本地优先的工作空间里，通过你的工具、你的文件以及一个共享记忆来工作。内置前沿模型，也可以带上你自己的密钥。

网站 · 文档 · 登录 · 快速上手

⭐ 如果 holaOS 对你有用，一颗星可以帮助更多开发者发现它。

✨ 与众不同之处

🔀 在同一个工作空间运行任何 Agent

Claude Code、Codex 和内置的 holaOS Agent——并行运行，无需切换。无论你运行哪一个，它们都共享相同的记忆、工具、技能和应用。为每个任务选择最合适的 Agent，而不必每次都重新搭建环境。

不锁定任何 Agent——带上你已有的、信任的 Agent 即可。

一切共享——同一个上下文、同一套工具、同一个工作空间。

结果一致——无论由哪个 Agent 驱动，技能和集成都保持不变。

🧠 一个记忆，所有 Agent 共享

上下文、偏好设置和项目历史存储在单一共享记忆中——本地保存为普通文件，可读可改。切换 Agent、关闭应用、下周再回来：它已经知道你上次的进度。

永不从零开始——跨会话、跨 Agent 的持久记忆。

本地优先，数据属于你——在你自己电脑上，可见可改，不被锁定在别人的云端。

真正可召回——结构化并做向量嵌入，需要时正确的上下文会自动召回。

💸 按你的方式使用模型——内置或自带密钥

一个账户，用遍所有模型——无需密钥、无需配置、无需在供应商之间切换。最新的前沿模型已内置：日常高性价比的 Kimi K3 和 GLM 5.2，以及处理难题的顶级 GPT 5.6、Claude Opus 5 和 Fable 5。想用自己的供应商？带来你自己的 OpenAI、Anthropic 或任何兼容 OpenAI 或 Anthropic 协议的密钥——这些都走你自己的账户，不走你的 holaOS 套餐。

零配置开箱即用——一个账户，用遍所有 SOTA 模型，无需管理 API 密钥。

按需自带密钥——你的密钥、你的供应商、你的费率。

每个任务选对模型——按任务、按 Agent 自由选择。

🪟 HolaApps——应用和 Agent 并排

从应用市场安装应用，它们会以真实、交互式的界面出现在你的 Agent 旁边。看着它在应用内工作，随时介入干预，结果直接落地——不是一堆聊天记录，而是实际的应用、由 Agent 驱动的真实界面，紧挨着 Agent。

真实界面，而非聊天——每个应用都是实时 UI（Notion、浏览器、你自己的应用），而非对话记录。

天生并排显示——应用和 Agent 共用屏幕，你始终看到正在发生什么，随时可以接管。

一键安装——浏览应用市场，立即打开任意应用。

自带应用——将任意 URL 和 MCP 服务器指向一个 HolaApp；它运行在你本地机器上，由你打开和操控。

🧩 技能、集成与 MCP——教一次，处处复用

集成——通过一键 OAuth 连接 Gmail、Notion、Slack、GitHub、Linear 等 50 多种服务。Agent 跨工具读写和操作，所有 Agent 继承相同的连接，无需胶水代码。

MCP——接入任何 Model Context Protocol 服务器，为 Agent 赋予新工具。自带或一键安装社区 MCP 服务器。

技能——将工作流打包一次；任何 Agent 按需调用。

组合包——将技能和集成打包为单个一键安装。

🛠️ 你整个工作站，Agent 均可操控

🌐 由 Agent 驱动的真实浏览器——Agent 在你控制下浏览、点击、抓取内容。

🎨 内置前沿生成模型——每个 Agent 内置最新的图像、视频和音频模型。构思视频分镜、设计海报、配音脚本——一条 prompt 搞定。

📄 真实交付物——报告、电子表格和幻灯片保存为真实的 .xlsx、.pptx 和 .docx 文件，可直接发送，而非困在聊天里的文字。

💬 在任何聊天渠道触达——飞书、微信、Slack、Telegram。在任意对话线程发一个任务；结果回到同一个线程。

⏰ 自动化——按计划或触发条件运行。简报、监控和报告自动完成并归档。

在新机器上引导初始化（macOS、Linux 或 WSL），使用仓库内的安装脚本：

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

你也可以按手动安装步骤操作，适合希望控制每个环节的情况。

如果 holaOS 有用或有趣，非常感谢赐予一颗 GitHub Star。

你大概率不需要看这一节，因为一键安装已经完成了同样的设置。只有当你希望检查或控制每个步骤时才走手动安装。如果走手动路径，先验证常见前置条件：

git --version
node --version
npm --version

如果你使用 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 运行手册中。

以下是为本地桌面开发准备的基线安装流程。

从仓库根目录安装桌面依赖：

npm run desktop:install

创建本地环境文件：

cp apps/desktop/.env.example apps/desktop/.env

如果完全按仓库示例来，保持文件接近模板，只改供应商或机器需要的值。标准路径是 apps/desktop/.env。已有的旧版 desktop/.env 文件目前仍被兼容，但新设置应使用 apps/desktop/.env。

准备本地运行时包：

npm run desktop:prepare-runtime:local

如果想在启动 Electron 前快速验证一下，运行：

npm run desktop:typecheck

以开发模式启动桌面应用：

npm run desktop:dev

predev hook 会验证环境、重新构建原生模块，并确保存在一个预演的运行时包。

如果你想在打开桌面应用之前预先打包运行时，有两条常见路径：

从本地运行时构建：

npm run desktop:prepare-runtime:local

获取最新发布的运行时：

npm run desktop:prepare-runtime

在修改运行时代码时使用本地路径。想用已知版本验证桌面时使用发布的包。

一键安装适合想要最快路径获得可用本地桌面环境的场景。手动安装适合需要自己检查或控制每个步骤的场景。

许可证：修改后的 Apache 2.0，附加商业分发和品牌条件。见 LICENSE。

安全问题：请私下报告至 admin@holaboss.ai。见 SECURITY.md。