openhanako 是什么?

OpenHanako(花子)是一个有记忆、有人格、能主动行动的私人 AI agent 桌面应用(Electron + React):把强大的 Agent 能力从命令行带到普通人面前——记住你说的每件事、操作电脑、浏览网页、读写文件、执行代码、管日程,还能自主学新技能;支持多 Agent 各有独立记忆/人格/定时任务并互相协作,配「书桌」异步协作区、Cron 心跳自主工作、双层安全沙盒、约定优先的插件系统和 Telegram/飞书/QQ/微信多平台接入。

⭐ 5,283 Stars 🍴 478 Forks TypeScript Apache-2.0 作者: liliMozi 无商业引流
来源:README Hanako 是什么 + 功能特性 查看 GitHub 仓库 →

为什么值得关注

Claude Code、Codex、Manus 等强 Agent 大多停在命令行或偏 coding,普通文员/办公用户够不着。OpenHanako 的初衷就是弥合这道缝隙:一方面强化 Agent「像人」的属性(人格模板 + 自定义人格文件,每个 Agent 有自己的说话方式,Agent 即文件夹便于备份)让沟通更自然,另一方面针对日常办公做了大量工具与流程优化。它把一堆别处分散的能力整合进一个桌面应用:记忆系统、多 Agent 频道群聊协作与互相委派、「书桌」(放文件、写「笺」便签让 Agent 主动读取执行)、Cron 定时任务 + 心跳巡检(你不在时自主工作)、兼容 SKILLS 生态且 Agent 能自己从 GitHub 装/编写技能、角色卡 zip 导入导出、多平台机器人接入、移动端 PWA + LAN 前端。安全上做了双层沙盒(PathGuard 四级 + OS 级 Seatbelt/Bubblewrap/restricted token)。3.6K★ 反映「让普通人也能用上有人格、会自主的桌面 AI agent」这个方向的吸引力。

来源:README Hanako 是什么 / 功能特性

核心功能

多 Agent + 记忆 + 人格

创建多个 Agent,各有独立记忆、人格和定时任务,Agent 之间可经频道群聊协作或互相委派任务。记忆系统结合主流方案再做优化,近期事情记得牢;人格通过模板 + 自定义人格文件塑造,每个 Agent 有自己的说话方式和行为逻辑,Agent 即文件夹、备份方便。

来源:README 功能特性(记忆/人格/多 Agent)
书桌(异步协作区 + 主动执行的「笺」)

每个 Agent 有自己的「书桌」,可放文件、写「笺」(类似便签,Agent 会主动读取并执行);支持拖拽、文件预览、工作区文件树变更监听。是你和 Agent 之间的异步协作空间——你留下任务,Agent 自己来处理。

来源:README 功能特性(书桌)
定时任务 + 心跳(自主工作)

Agent 可设 Cron 定时任务,也会定期巡检书桌文件变化;你不在时也能按计划自主工作。配合记忆和人格,体现「自主性」——不只是被动应答,而是主动行动。

来源:README 功能特性(定时任务与心跳)
SKILLS 生态 + 角色卡/技能包

内置兼容庞大 SKILLS 社区生态,Agent 干活前可从 GitHub 装社区技能、也能自己编写学会新技能(默认严格审核可关);Agent 可导入/导出为本地优先的角色卡 zip(按白名单带人格/头像/可选记忆/Skills),Skill Bundle 是独立技能包基础设施,可分组、拖拽、成组启用、单独导出 zip 便于迁移分享。

来源:README 功能特性(SKILLS 支持 / 角色卡与技能包)
双层安全沙盒

双层隔离:应用层 PathGuard 四级访问控制 + 操作系统级沙盒(macOS Seatbelt / Linux Bubblewrap / Windows restricted token)。默认只读访问系统普通文件,写入/删除限制在工作目录与受控数据目录;沙盒级别和网络(系统代理/手动/直连)可在设置里调。

来源:README 功能特性(安全沙盒)
约定优先插件系统 + 多平台接入 + 移动/LAN

插件可贡献工具/技能/命令/Agent 模板/HTTP 路由/事件钩子/LLM Provider/页面/侧栏 Widget/配置 schema/后台任务,拖拽安装,PluginContext 注入 + Session Bus 与 Agent 交互,两级权限(restricted/full-access)。同一 Agent 可接 Telegram/飞书/QQ/微信机器人远程操作;Hana Server 托管 /mobile/ PWA,另一桌面端可经 LAN URL + access key 连同一 Server。

来源:README 功能特性(插件系统 / 多平台接入 / 移动端与 LAN 前端)

技术架构

OpenHanako 是 JavaScript 写的 Electron 桌面应用 + 服务端:core/(110,引擎编排层 + Manager 含 PluginManager)、lib/(250,核心库——记忆、工具、沙盒、Bridge 适配器)、desktop/(827,Electron 应用 + React 前端)、server/(54,Hana Server,托管移动 PWA 和 LAN 接入)、plugins/(43,内置系统插件随应用打包)、skills2set/(53,内置技能定义)、hub/、cli/、shared/。模型分工:对话模型(主对话)、小工具模型(轻量任务)、大工具模型(记忆编译/深度分析)、可选视觉模型(经 Vision Bridge 处理图片),接入 OpenAI 兼容/Anthropic/OAuth/Ollama。运行模型:Agent 是文件夹(含人格/记忆/定时任务),core 编排其工具调用,lib 提供记忆/沙盒/Bridge,desktop 提供 UI 与书桌,server 提供多端接入;Cron + 心跳驱动自主行为,多 Agent 经频道协作,插件经约定 + PluginContext + Session Bus 扩展。安全是双层沙盒(PathGuard 四级 + OS 沙盒)。设计判断:它的取向很清晰——把 Agent 做得「像人 + 自主 + 面向办公而非 coding」,用「Agent 即文件夹」「书桌 + 笺」「角色卡 zip」这些拟人化、文件优先的设计降低普通用户门槛,再用双层沙盒和两级插件权限兜住安全。这是「个人 AI 助理」方向上功能很全的尝试;代价是功能极多(记忆/人格/多 Agent/书桌/定时/沙盒/插件/多平台/移动)导致系统庞大复杂、单作者维护、版本号已飙到 0.225.x 说明高频迭代但也意味着稳定性仍在打磨,作者自己也承认记忆系统「有待优化」。

来源:README 架构/技术栈 + tree

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) core(引擎编排 + PluginManager)+ lib(记忆/工具/沙盒/Bridge)core(引擎编排… OS 沙盒:macOS Seatbelt / Linux Bubblewrap / Windows restricted token + PathGuardOS 沙盒:macOS… 多 LLM:OpenAI 兼容 / Anthropic / OAuth Provider / Ollama(对话/小工具/大工具/视觉四类模型)多 LLM:OpenAI… SKILLS 生态 + Skill Bundle + 插件 SDK(PluginContext / Session Bus)SKILLS 生态 +… 多平台 Bridge:Telegram / 飞书 / QQ / 微信多平台 Bridge:… 多 Agent + 记忆 + 人格多 Agent + 记忆 + 人… 书桌(异步协作区 + 主动执行的「笺」)书桌(异步协作区 + 主… 定时任务 + 心跳(自主工作)定时任务 + 心跳(自主… SKILLS 生态 + 角色卡/技能包SKILLS 生态 + 角色卡… 双层安全沙盒 约定优先插件系统 + 多平台接入 + 移动/LAN约定优先插件系统 + 多… openhanako 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言JavaScript(Electron 应用 + 服务端)+ React(前端)框架Electron + React + Vite(多 vite config:main/preload/server/theme)+ Hana Server
core(引擎编排 + PluginManager)+ lib(记忆/工…OS 沙盒:macOS Seatbelt / Linux Bubblew…多 LLM:OpenAI 兼容 / Anthropic / OAuth …SKILLS 生态 + Skill Bundle + 插件 SDK(Pl…多平台 Bridge:Telegram / 飞书 / QQ / 微信
Electron 桌面应用(下载安装),跨 macOS/Linux/Windows;Hana Server 托管 /mobile/ PWA + LAN 接入;Agent 即文件夹、角色卡 zip 导入导出;Apache-2.0;v0.225.x 高频迭代;vitest 测试 + eslint
来源:README 技术栈/平台支持/开发 + tree + package.json

快速上手

# 下载安装(见 README 下载安装;跨 macOS/Linux/Windows) # 首次运行引导向导: # 选语言 → 输入你的名字 → 连模型提供商(API key + base URL) # 选三个模型:对话模型 / 小工具模型 / 大工具模型(记忆编译+深度分析) # 设置页可单独选视觉模型(经 Vision Bridge 处理图片) # 支持 OpenAI 兼容 / Anthropic 风格 / OAuth Provider / Ollama 本地 # 从源码开发 npm install npm start # Electron 启动(自动构建 renderer) npm run dev:renderer # 配合 Vite HMR 开发 # 仅启动 server / server-first CLI / npm test / 类型检查 见 README 开发节 # 用法:创建多个 Agent(各有记忆/人格/定时任务),用「书桌」放文件写「笺」、 # 设 Cron 定时任务、装 SKILLS、接 Telegram/飞书/QQ/微信、手机经 /mobile/ PWA 访问 # 安全:设置 → 安全页调沙盒级别与网络代理
来源:README 快速开始 / 首次运行 / 开发 原文

使用场景

1. 普通人/文员的桌面 AI 助理:要一个能记住你、有人格、会主动办事的 Agent 操作电脑/读写文件/管日程,而非命令行 coding agent;2. 多 Agent 分工协作:建多个各有记忆和人格的 Agent,经频道群聊协作或互相委派;3. 异步托办:往 Agent「书桌」放文件、写「笺」,它主动读取执行,你不在时按 Cron 自主工作;4. 远程操控:接 Telegram/飞书/QQ/微信,在任何平台和 Agent 对话、远程操作电脑,手机经 PWA 访问;5. 角色卡分享:把调好的 Agent 导出成角色卡 zip(带人格/技能)迁移或分享;6. 插件/技能扩展:用插件 SDK 贡献工具/Provider/页面,或让 Agent 自己装/写 SKILLS。

来源:README 功能特性 / 多平台接入 / 移动端

优势与局限

优势

  • 定位清晰:把 Agent 做得「像人 + 自主 + 面向办公」,用拟人化设计(Agent 即文件夹、书桌+笺、人格文件、角色卡 zip)降低普通用户门槛,弥合大众和强 Agent 的缝隙
  • 功能很全:记忆 + 多 Agent 协作 + 书桌异步协作 + Cron 心跳自主 + SKILLS 生态 + 插件系统 + 多平台机器人 + 移动 PWA/LAN,一个桌面应用覆盖个人 AI 助理的多数需求
  • 安全做得认真:双层沙盒(应用层 PathGuard 四级 + OS 级 Seatbelt/Bubblewrap/restricted token)、插件两级权限、默认 SKILLS 审核,对一个会操作电脑的自主 Agent 是必要的
  • 本地优先与可迁移:Agent 是文件夹、角色卡/技能包可导出 zip、本地模型(Ollama)支持,数据可控、便于备份分享
  • 扩展性强:约定优先的插件架构能贡献工具/技能/命令/Provider/页面/路由/后台任务等十类东西,PluginContext + Session Bus 接核心服务,Skill Bundle 独立技能包基础设施

局限

  • 系统庞大复杂 + 单作者维护:功能极多(记忆/人格/多 Agent/书桌/定时/沙盒/插件/多平台/移动)使代码量大(1888 文件)、维护面广,单人主导 + 版本号已 0.225.x 高频迭代,稳定性仍在打磨
  • 记忆系统作者自承待优化:README 明说记忆「近期记得牢但目前确实有待优化」,长期记忆/检索质量是已知短板,对依赖长期记忆的场景需留意
  • 自主行为的风险面:会主动执行书桌的「笺」、自己从 GitHub 装技能、Cron 自主工作——自主性越强,误执行/装到坏技能的风险越大,虽有沙盒和 SKILLS 审核兜底,仍需用户谨慎授权
  • 可测试性 / 质量:人格、记忆、自主决策的「好坏」本质主观,无 benchmark;多平台 Bridge(微信/QQ 等)依赖各平台接口与非官方对接,稳定性和合规需注意
  • 依赖外部模型:需配 4 类模型(对话/小工具/大工具/视觉)的 provider,能力和成本由所选 LLM 决定;大工具模型做记忆编译/深度分析,成本不低
  • Windows 沙盒较弱:README 说明 Windows 命令沙盒目前是写隔离模型(读取/网络按当前用户权限),隔离强度不如 macOS/Linux,Windows 用户的安全边界要清楚
来源:综合 README + tree + 单作者/版本现实

最新版本

v0.225.4(2026-05-21),同日发了 v0.225.1,前序 v0.224.1,发版极频繁(一天多个)。仓库 2026-03-15 创建即冲到 0.225.x 的高版本号,pushed 到 2026-05-22,迭代非常活跃但仍是 0.x、稳定性打磨中。

来源:GitHub Releases API(v0.224-225)+ repo created

总结评价

如果你想要一个「像人、会自主、面向日常办公」的桌面 AI 助理而非命令行 coding agent,OpenHanako 功能很全:多 Agent + 记忆 + 人格 + 书桌异步协作 + Cron 自主 + 插件 + 多平台接入 + 移动 PWA,还配双层沙盒。务实建议:1) 下载桌面端,首次按引导配好 4 类模型(对话/小工具/大工具/视觉),本地可用 Ollama;2) 它的特色在「拟人 + 自主」——用书桌+笺托办、Cron 让它自主工作、接 IM 远程操控,先小范围试自主行为;3) 自主性越强风险越大(会自己装技能、执行笺),保持沙盒开启、谨慎授权 full-access,别一上来给全权限;4) 记忆系统作者自承待优化,别指望它完美记住远期;5) 0.225.x 一天多版、单作者,稳定性仍在打磨,重要数据多备份(Agent 即文件夹便于备份);6) Windows 沙盒较弱(写隔离),Windows 用户注意安全边界;多平台 Bridge(微信/QQ)是非官方对接,合规自评。

来源:综合分析

常见问题

openhanako 是什么?

OpenHanako(花子)是一个有记忆、有人格、能主动行动的私人 AI agent 桌面应用(Electron + React):把强大的 Agent 能力从命令行带到普通人面前——记住你说的每件事、操作电脑、浏览网页、读写文件、执行代码、管日程,还能自主学新技能;支持多 Agent 各有独立记忆/人格/定时任务并互相协作,配「书桌」异步协作区、Cron 心跳自主工作、双层安全沙盒、约定优先的插件系统和…

openhanako 有哪些核心功能?

openhanako 的核心功能包括:多 Agent + 记忆 + 人格、书桌(异步协作区 + 主动执行的「笺」)、定时任务 + 心跳(自主工作)、SKILLS 生态 + 角色卡/技能包、双层安全沙盒。

openhanako 为什么最近很受关注?

Claude Code、Codex、Manus 等强 Agent 大多停在命令行或偏 coding,普通文员/办公用户够不着。OpenHanako 的初衷就是弥合这道缝隙:一方面强化 Agent「像人」的属性(人格模板 + 自定义人格文件,每个 Agent 有自己的说话方式,Agent 即文件夹便于备份)让沟通更自然,另一方面针对日常办公做了大量工具与流程优化。

openhanako 适合哪些使用场景?

1. 普通人/文员的桌面 AI 助理:要一个能记住你、有人格、会主动办事的 Agent 操作电脑/读写文件/管日程,而非命令行 coding agent;2. 多 Agent 分工协作:建多个各有记忆和人格的 Agent,经频道群聊协作或互相委派;3. 异步托办:往 Agent「书桌」放文件、写「笺」,它主动读取执行,你不在时按 Cron 自主工作;4.

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 11:24. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件