holaboss-ai/holaOS · 上手攻略

  • 仓库：holaboss-ai/holaOS
  • 链接：https://github.com/holaboss-ai/holaOS
  • 分类：ai-agent / local-first desktop
  • 作者：spark
  • 更新：2026-07-14

这是什么

holaOS 是 Holaboss 团队开源的一个「本地优先（local-first）AI 工作桌面」运行时与桌面 App（基于 Electron + TypeScript，底层 Node 24.14.1），主打"超级工作 Agent（super agent for work）"——把 Gmail、Slack、Notion、GitHub、Jira、Linear、HubSpot 等 100+ 工作工具通过 OAuth 接入，Agent 自动拉取其中和工作相关的上下文，沉淀成本地 Markdown + SQLite vec 的"工作记忆"，并通过 RAG 检索；长会话通过"Safe Session Compaction"压缩以保持 ~70% 模型窗口留给当下推理；UI 一句"不是终端",用桌面 App 承担交互、文件、任务编排。

它跟一般 ChatGPT-风格桌面客户端最大的区别是「工作记忆」（working memory）与「会话压缩」是产品的核心叙事，而不是把对话塞进 vector store 凑合——README 上明确写出"灵感来自 Karpathy 的 LLM wiki workflow"。许可证为「Modified Apache 2.0」。

注：项目当前 README 显式标注 "macOS supported, Windows & Linux in progress"，本文以官方 2026-07 时的状态为准。

解决什么问题

  1. 上下文漂移：你不可能每天把过去一周的工作 ticky-tacky 重新贴给 Agent。holaOS 通过 OAuth 自动 fetch + 摘要压缩，让 Agent 在你打开桌面的那一刻"接着上次的进度干"。
  2. 上下文爆窗：长会话里几小时后模型要么丢掉早期事实、要么上下文挤爆；它用 Safe Session Compaction（结构化 checkpoint：目标 / 约束 / 进度 / 决策 / 下一步 / 关键上下文 / 文件活动）维持跨天的连贯性。
  3. 数据被云端吞：所有 memory 落本地 Markdown + SQLite vec，可读可改，不锁在厂商账号里。
  4. 多工具打散：用一个桌面壳把浏览器 profile、本地文件、第三方集成、并行 subagent 收口到一个 UI，避免在十个 Tab 和命令行之间来回切。

快速安装

官方 README 给的最短路径是「一行安装 + 自动启动开发模式」：

# macOS / Linux / WSL 任选
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch

脚本会做的事（基于 scripts/install.sh 源码）：

  • 用 uname -s 探测 OS，目前只支持 macOS 和 Linux（其他直接 fail）。
  • 自动管理 Node：默认安装并切换到 MANAGED_NODE_VERSION="24.14.1"，落在 ${HOLABOSS_HOME:-$HOME/.holaboss}/node，无需你提前装 nvm。
  • 把仓库 clone 到 ${HOLABOSS_INSTALL_DIR:-$HOME/holaboss-ai}（可通过 --dir PATH 改）。
  • 默认 ref 为 main，可通过 --ref NAME 或 --branch NAME 改。
  • 把 ~/.local/bin 加进 PATH（按 shell 写入 ~/.zshrc / ~/.bashrc / ~/.profile）。
  • 加 --launch 会接着跑 npm run desktop:dev，直接拉起 Electron 桌面 App。

如果你想自己控每一步（给 Codex/Claude Code/Cursor/Windsurf 等代理看），按 README 提示手动：

git --version           # 任意现代 git
node --version          # >= 24.14.1
npm --version

git clone https://github.com/holaboss-ai/holaOS.git ~/holaboss-ai
cd ~/holaboss-ai
npm install
npm run desktop:dev

进桌面后第一次会让你登录 holaboss 账号；OAuth 接入、模型账户、记忆授权都在 App 内完成（README 里没说有 BYOK/自配 BaseURL 的选项——README 强调"one-account all SOTA models"）。

核心用法

holaOS 不是开发 SDK，主体体验都在桌面壳内，但 README 把关键交互抽象成了几条「场景式」命令式说明：

1. 启动并登录

# 一行版：装完即开
curl -fsSL https://raw.githubusercontent.com/holaboss-ai/holaOS/refs/heads/main/scripts/install.sh | bash -s -- --launch

# 手动版：先装再起
npm run desktop:dev

2. 接集成（OAuth 一键）

在桌面 App 内：

  • 打开「Integrations」面板 → 例如勾选 Gmail / Slack / GitHub / Linear / Jira。
  • 浏览器跳 OAuth 授权页 → 同意后回到桌面。

官方 README 措辞是 "100+ integrations" 和 "1000+ stable for working"，后者是付费/企业层（README 对比表里写"118+ via OAuth"对标"1000+ via OAuth + Stable for Working"）。

3. 触发 Auto-fetch

授权完成后，会按 README 描述每 30 分钟把授权工具里的相关信号拉一遍、摘要并写入本地 Markdown（外加 SQLite vec 嵌入）。Memory 目录在 ~/.holaboss 下（具体子目录由 App 内部管），结构是可直接 cat 看、改、删的 Markdown。

4. 用 Agent 完成任务

桌面里直接跟 Agent 对话。让它做"复杂任务"时它会自动 fork subagent 并行跑，最后 orchestrator 把结果整合回主对话；产物落工作区（workspace）目录，类型有 plans / drafts / notes / generated files / configs / outputs。

5. 看 / 改记忆

README 明说：所有 memory 都存成 Markdown，可以打开、浏览、编辑、删除。Agent 工作时会通过 RAG 召回，而不是把整份记忆每轮全塞回 prompt。

6. 让 Agent 走真实网页

桌面 App 里"一键让 Browser profile 接入 Agent"——让 Agent 操纵你日常的浏览器 profile，去处理 API 没法覆盖的网站、仪表盘、内网后台。

典型适用场景

  • 跨工具运营/PM 工作流：Linear 上提 issue、Slack 上回消息、Notion 写 WIKI、HubSpot 看 CRM——平时切换累，现在让 Agent 把这些汇总成"我今天该做什么"。
  • 多日研发任务：写一份跨好几天的大型重构或长文档，holaOS 的 Session Compaction 让你第二天打开还能续上。
  • 不想把公司数据给闭源云：所有 memory 落本地 Markdown + SQLite vec。
  • 不想拉 VSCode / 终端 的同事：UI 友好、能跑在桌面 App 里。
  • 要并行调研 / 数据采集：用 subagent 并行跑，UI 整合成一个可审稿的成品。

坑与注意

  • OS 支持很窄：README 当前徽章写 "macOS supported, Windows & Linux in progress"，Windows/Linux 跑 install.sh 会被 detect_os 直接 fail。Windows 用户只能等或参与移植。
  • 需要 holaboss 账号 + 联网 OAuth：模型访问走 holaboss 账户，不是"BYOK"（README 对比表里把"BYO Model / BYOK"标为减分项）。离线/自托管需求的，可能要等将来的 "Independent Deploy" 文档路径 docs/contribute/runtime/independent-deploy。
  • npm install 在大项目可能慢：TypeScript + Electron + 多个 workspace 子包，第一次拉常 ≥ 5 分钟；脚本里不展示进度，建议加 --no-audit --no-fund。
  • memory 文件可手改，但 RAG 不一定立即重建索引：如手动大改 memory，建议重启桌面 App 触发一次重建（README 没明说，谨慎起见）。
  • Auto-fetch 是 30 分钟一轮（README 对比表里讲的，跟 "20-min sync" 的 Openhuman 区分），不是"每次对话前都重新抓"。如果刚发生的关键状态需要等一轮。
  • 第三方集成刷新边界：只取"你允许的"信号；如果某个集成没列入，就搜不到。
  • 许可证是 "Modified Apache 2.0"：商业使用前先看 LICENSE，有"modified"条款，不是标准 Apache 2.0。

与同类对比

README 自带一张对比表，挑重点（其他三项是 OpenClaw / Hermes Agent / Openhuman）：

维度 holaOS OpenClaw / Hermes Openhuman
定位 Working Agent General Agent Personal Agent
UI Production Grade UI Terminal-first / Basic UI Basic UI
Memory Memory Tree + Semantic Embedding + RAG 插件式 / 自学习 Memory Tree + Obsidian
Integrations 1000+ via OAuth，稳定可工作 BYOK 118+ via OAuth
模型选择 一个账号通所有 SOTA BYO Model 单一模型
Native tools Code + Web Search + Browser Use + Wide Search Code-only + search/scraper/voice
Workspace 专给数字工作 无 无

简单说：如果你要的是"终端里的 Claude Code"，OpenClaw / Hermes 更合口；如果你要"桌面壳 + 长期工作记忆 + 一键 OAuth + 多 subagent"，holaOS 是直接对位的；如果你要的是"个人记忆助手 + Obsidian vault"，Openhuman 更近。

横向还可以想到：Manus / Devin（云端 Agent 平台，无本地数据）、Aider / Continue（终端 + IDE 内 code agent，不做工作记忆）、ChatGPT Memory / Claude Projects（云端记忆，不开源）。holaOS 的差异化是「开源 + local-first memory + 工作桌面」三件同时成立。

一句话推荐

如果你每天在 5 个以上 SaaS 之间切来切去、想要"昨天干什么今天接着干"，且能接受 macOS + 联网 OAuth，holaOS 是当前最接近"AI 工作操作系统"的开源选项；Windows/Linux 用户建议再观望几个 release。