openhanako

给 AI 装上记忆和人格，越用越懂你

openhanako 是一个用 TypeScript 编写的个人 AI 智能体项目，核心卖点是给 AI 装上长期记忆、稳定人格和自主行动能力。它想解决的问题是：普通聊天机器人每次对话都从零开始，记不住你是谁、你的偏好和历史，也无法主动做事。openhanako 通过持久化记忆层让智能体跨会话记住用户信息，通过人格设定让回答风格保持一致，并通过自主性机制让智能体在无需逐步指令的情况下规划并执行任务。项目以个人助理为定位，适合希望拥有一个长期陪伴、越用越懂自己的 AI 助手的开发者与极客用户。技术上基于 TypeScript 生态，便于接入现有 Node.js 工具链和前端应用，也方便二次开发自定义记忆策略与人格模板。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6597

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队liliMozi

所属国家

官网地址

GitHubhttps://github.com/liliMozi/openhanako

定价模式free

价格说明开源项目，免费使用，定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型

GitHub 星标★ 6597

30天Star增速

HF 下载量

上线时间2026-03-15 00:00:00

最近更新2026-09-19 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数0

使用教程

难度：入门约 15 分钟部署方式：本地安装 8 步

环境要求

支持 macOS（Apple Silicon / Intel）、Windows 或 Linux 的电脑
从源码运行需安装 Node.js 与 npm（README 使用 npm 命令）
可用的模型服务：API key + base URL（OpenAI 兼容 / Anthropic 风格 / OAuth Provider / Ollama 本地
下载安装包需要访问 GitHub Releases 页面

安装与启动步骤

1下载桌面安装包

打开 Releases 页面，按系统选择安装文件：macOS 下载 .dmg，Windows 下载 .exe，Linux 下载 .AppImage 或 .deb。
2安装并打开应用

macOS 已签名公证可直接打开；Windows 首次运行可能被 SmartScreen 拦截，点“更多信息”→“仍要运行”。
3完成首次引导配置

首次启动会出现引导向导：选择语言、输入你的名字、填写模型提供商 API key 与 base URL，并选择对话/小工具/大工具三个模型。
4源码方式安装依赖

如果走源码运行，先在项目根目录（从 GitHub 仓库 https://github.com/liliMozi/openhanako 获取代码）执行依赖安装。
```
npm install
```
5启动 Electron 应用

npm start 会启动 Electron 并自动构建 renderer，适合直接当桌面应用使用。
```
npm start
```
6Vite 热更新开发

需要边改边看效果时使用；README 提示须先运行 npm run dev:renderer 再启动 Vite HMR。
```
npm run dev:renderer
npm run start:vite
```
7仅启动 server

只跑后端服务、不开 Electron 界面时使用，可用 server-first CLI 在终端连接同一台 Server。
```
npm run server
```
8运行测试

想确认代码是否正常，可在项目目录下执行测试命令。
```
npm test
```

关键配置

配置项	必填	说明	示例
`语言`	是	首次运行向导中选择界面语言	`简体中文`
`API Key`	是	模型提供商的访问密钥	`sk-xxxxxxxx`
`Base URL`	是	模型服务的接口地址	`https://api.openai.com/v1`
`对话模型`	是	承担主对话的模型	`gpt-4o`
`小工具模型`	是	处理轻量任务的模型	`gpt-4o-mini`
`大工具模型`	是	用于记忆编译和深度分析的模型	`gpt-4o`

如何确认成功

应用窗口成功打开并出现首次运行引导向导，配置完模型后即可开始对话；仅启动 server 时终端会输出服务启动信息。

常见问题

Q：Windows 安装时被杀毒/系统拦截怎么办？

A：安装包暂未做代码签名，属正常现象。点击提示中的“更多信息”，再点“仍要运行”即可继续安装。

Q：macOS 上会提示应用来源不明吗？

A：一般不会。应用已通过 Apple Developer ID 签名和公证，macOS 应该可以直接打开。

Q：支持哪些模型接入方式？

A：支持 OpenAI 兼容、Anthropic 风格、OAuth Provider 和 Ollama 本地模型等多类接入，目前提供 OpenAI 的 OAuth 登录。

Q：技能（SKILLS）装不上怎么办？

A：默认对 SKILLS 做了比较严格的审核导致装不上，可以在设置中自行关闭审核后再安装。

Q：必须先装 Node.js 吗？

A：只用下载的安装包（dmg/exe/AppImage/deb）不需要；源码运行方式需要用 npm 命令，因此需要 Node.js 环境。

注意事项

安装包统一从 GitHub Releases 获取，务必选与自己系统匹配的文件格式。
首次运行必须完成模型配置（API key + base URL）才能正常对话。
每个 Agent 以文件夹形式独立保存记忆与人格，可直接备份文件夹迁移。
出于封号风险考虑，项目暂不提供 Anthropic 的 OAuth 登录，请按需自备密钥。

核心亮点

同时提供记忆、人格、自主性三大能力，而非只做单一聊天壳
TypeScript 实现，与 Node.js/前端生态无缝衔接，便于二次开发
定位个人智能体，强调跨会话持久记忆，交互体验更连贯

不足之处

项目较新，长期记忆的检索准确率与遗忘策略缺乏大规模验证
自主执行任务时的安全边界与权限控制细节尚不明确

适用场景

个人长期 AI 助理，记住用户习惯与偏好并主动提醒
开发者基于其记忆层快速搭建带人格的垂直领域智能体
极客用户自建可自主规划任务的本地 AI 助手

替代项目

mem0、Letta、AutoGPT

项目介绍

openhanako 是一个智能体领域的开源项目，官方简介：A personal AI agent with memory, personality, and autonomy.。项目使用 TypeScript 开发，在 GitHub 上获得 6538 星标。

上一篇：docker-agent

下一篇：swarm-forge