openhanako 是什么?

OpenHanako 仓库当前 README 使用 HanaAgent 作为产品名,是一个桌面 Agent 工作台,集中处理记忆、技能、多 Agent、定时任务、provider 和本地权限。

⭐ 5,283 Stars 🍴 478 Forks TypeScript Apache-2.0 作者: liliMozi
来源:官方 Releases 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

v0.450.0(2026-08-22,Pre-release);v0.449.0 在 release 页面标记 Latest。OpenHanako 仓库当前 README 使用 HanaAgent 作为产品名,是一个桌面 Agent 工作台,集中处理记忆、技能、多 Agent、定时任务、provider 和本地权限。

来源:官方 Releases

核心功能

桌面安装包与多平台支持

release 页面提供 macOS、Windows 和 Linux 安装资产,Windows 在 README 中标为 Beta。

来源:github.com/liliMozi/openhanako
多 provider 与记忆/视觉模型

README 说明可接 OpenAI 兼容、Anthropic 风格、OAuth、Ollama,并区分对话、工具、记忆/深度分析模型。

来源:github.com/liliMozi/openhanako
PathGuard + OS sandbox

项目将 PathGuard 与 macOS Seatbelt、Linux Bubblewrap、Windows restricted token 组合来限制工具权限。

来源:github.com/liliMozi/openhanako

技术架构

Electron 桌面端管理本地数据、provider、工具和 Agent;README 描述 PathGuard 叠加 macOS Seatbelt、Linux Bubblewrap、Windows restricted token。

来源:官方 Releases

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 桌面 release OpenAI-compatible/Anthropic/OAuth/Ollama providerOpenAI-compati… HANA_HOME 桌面安装包与多平台支持 多 provider 与记忆/视觉模型多 provider 与记忆/… PathGuard + OS sandboxPathGuard + OS sand… openhanako 项目本体 核心功能 关键依赖

技术栈

语言TypeScript/React(官方 README 技术栈)框架Electron 42 + React 19 + Hono + better-sqlite3
桌面 releaseOpenAI-compatible/Anthropic/OAuth/Ol…HANA_HOME
macOS、Windows Beta、Linux AppImage/deb
来源:官方 Releases

快速上手

从官方 release 选择对应系统安装包;首次启动配置 provider、主对话模型、工具模型和记忆/深度分析模型;确认 HANA_HOME 和沙盒权限后,用无敏感文件完成一次读写测试。
来源:官方 Releases

使用场景

想用桌面界面管理本地 Agent、记忆和 Skill,并希望明确限制文件/命令权限的用户。

来源:官方 Releases

优势与局限

优势

  • 桌面工作流覆盖模型、记忆、Skill 和多 Agent
  • 支持多类 provider 与本地 Ollama
  • 权限边界在 README 中有明确平台说明

局限

  • 版本迭代快,预发布功能不应当作稳定承诺
  • Windows 当前标为 Beta
  • 安装包和 GUI 未在本工作区实测
来源:官方 Releases

最新版本

v0.450.0(2026-08-22,Pre-release);v0.449.0 在 release 页面标记 Latest。

来源:官方 Releases

实测与证据

status: official_repo_and_release_checked_not_locally_installed  |  checked_at: 2026-09-22  |  environment: 核对官方 README、仓库和 release;未在当前 macOS 工作区安装 GUI  |  limitations: 未验证安装包启动、OAuth、真实模型调用或跨平台差异  |  observed_output: release 页面显示 v0.450.0 为 Pre-release、v0.449.0 为 Latest;README 给出 HANA_HOME、provider 和平台沙盒说明

来源:官方 Releases

同类项目对比

相比终端 Agent,OpenHanako 提供桌面工作台、记忆和权限设置;如果更看重脚本化、远程服务器和 CI,终端 Agent 更直接。

来源:官方 Releases

总结评价

想用桌面界面管理本地 Agent、记忆和 Skill,并希望明确限制文件/命令权限的用户。采用前需要核对:版本迭代快,预发布功能不应当作稳定承诺。

来源:官方 Releases

常见问题

OpenHanako 现在叫什么?

官方仓库 README 的产品名是 HanaAgent,仓库 URL 仍是 liliMozi/openhanako。

v0.450.0 能直接用吗?

v0.450.0 在 release 页面标记为 Pre-release;普通用户优先确认 Latest 版本和对应说明。

支持哪些模型?

README 提到 OpenAI 兼容、Anthropic 风格、OAuth provider 和 Ollama;实际可用性取决于版本和 provider 配置。

数据存在哪里?

默认 HANA_HOME 是 ~/.hanako,开发模式是 ~/.hanako-dev;可以在启动环境中显式设置。

能让 Agent 执行命令吗?

项目支持终端和工具调用,但应先设置沙盒和工作目录权限,再用无敏感数据的测试任务验证。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件