# User Guide

HanaAgent 用户说明书。解答用户关于软件使用方法、功能介绍、常见问题和实用技巧的疑问。 MANDATORY TRIGGERS: 怎么用, 使用方法, 说明书...

- Repository: https://github.com/liliMozi/openhanako (6858 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add liliMozi/openhanako --skill user-guide -g -a claude-code -y`
Codex: `npx skills add liliMozi/openhanako --skill user-guide -g -a codex -y`
Cursor: `npx skills add liliMozi/openhanako --skill user-guide -g -a cursor -y`
Gemini CLI: `npx skills add liliMozi/openhanako --skill user-guide -g -a gemini-cli -y`

## Description

HanaAgent 用户说明书。解答用户关于软件使用方法、功能介绍、常见问题和实用技巧的疑问。 MANDATORY TRIGGERS: 怎么用, 使用方法, 说明书, 帮助文档, 新手指南, 怎么设置, 功能介绍, how to use, user guide, help, getting started, 教程, tutorial, 这是什么功能, 怎么操作

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# HanaAgent 用户说明书

> 面向普通用户的使用指南。当用户问到「怎么用」「这个功能是什么」「怎么设置」等问题时，参考本文档回答。
> 回答时用通俗语言，避免技术术语，必要时举例说明。

---

## 一、HanaAgent 是什么

HanaAgent 是一个运行在你电脑上的 AI 私人助手。

你可以把它理解成一个「住在你电脑里的伙伴」：它能和你聊天、帮你处理文件、写东西、搜索资料、定时执行任务，甚至连接到你的微信和 Telegram 帮你自动回复。

和 ChatGPT 网页版最大的区别是：
- **它有记忆**。HanaAgent 能记住你之前说过的话，今天聊的、上周聊的、上个月聊的，它都会整理归档
- **它能动手**。不只是聊天，它可以读写你电脑上的文件、执行命令、浏览网页、创建定时任务
- **它是私有的**。所有数据存在你自己的电脑上，不经过第三方服务器
- **它可以有多个分身**。你可以创建多个 Agent（助手），每个有不同的性格和专长

### 和 OpenClaw 有什么不同

OpenClaw 是一个 AI Agent 开发框架，偏向开发者和基础设施层面。HanaAgent 的定位是面向个人用户的成品应用：

| | HanaAgent | OpenClaw |
|---|--------|---------|
| 定位 | 个人 AI 助手（成品应用） | AI Agent 框架（开发工具） |
| 受众 | 普通用户 + 开发者 | 主要面向开发者 |
| 记忆 | 多层级自然衰退记忆系统 | 框架级，需自行实现 |
| 界面 | 精心设计的桌面应用 | 无自带 GUI |
| 技能格式 | 兼容 OpenClaw / Claude Code / Codex / Pi 的 Skill 格式 | 自有 Skill 格式 |

简单说：OpenClaw 是造 Agent 的工具箱，HanaAgent 是一个已经造好的、可以直接用的 Agent。同时 HanaAgent 兼容 OpenClaw 的技能生态，可以直接安装 OpenClaw 社区的 Skill。

---

## 二、开始使用

### 首次打开

1. 打开 HanaAgent 后，你会看到一个欢迎界面，显示助手的头像和问候语
2. 引导向导会带你选择语言、填写你的名字、连接模型供应商
3. 进入设置 → 供应商，可以继续添加或调整 API Key、Base URL、OAuth 账号、本地 Ollama 或 Coding Plan
4. 配置好模型后回到主界面，就可以开始对话了

### 模型角色

HanaAgent 会把不同任务分给不同模型：

- **聊天模型**：主力模型，负责和你对话、执行任务
- **实用模型（轻量）**：做摘要、分类等轻活，省钱省速度
- **实用模型（重型）**：做记忆编译、深度分析等需要强推理的后台任务
- **视觉模型**：当聊天模型不支持图片时，先把图片转成结构化说明，再交给聊天模型理解

视觉模型本身必须是支持图片输入的多模态模型。设置时请同时确认两件事：模型卡片里的「视觉 / 支持图片」能力没有被误关；设置 → 供应商底部的「辅助视觉开关」已开启，且「视觉辅助模型」没有选成纯文本模型。

在设置 → 助手里可以为每个助手单独选择聊天模型。在设置 → 供应商底部可以配置实用模型和视觉模型。输入框里的模型胶囊可以临时切换当前会话模型。

---

## 三、和 HanaAgent 对话

### 基本操作

- **发送消息**：输入文字，按发送按钮或快捷键发送
- **换行**：Shift + Enter
- **附加文件**：把文件拖进聊天区域，或点击附件按钮
- **停止回复**：HanaAgent 正在回复时，发送按钮会变成停止按钮
- **插话（Steer）**：HanaAgent 回复过程中你可以发送新消息打断它、补充指令
- **选择消息**：消息旁有勾选、复制、截图按钮。勾选多条后可以一起复制或生成截图
- **预览媒体**：聊天里的图片、SVG、视频可以点开全屏查看，支持缩放、拖拽和左右切换

### 思考深度

输入框旁边有个思考深度按钮，可以调整 HanaAgent 思考问题的深入程度：

- **关闭 / 低 / 中 / 高 / 极高**：越高越深入，适合复杂问题，但回复会慢一些。极高只在模型支持时显示

思考过程会显示在消息中，你可以展开查看它是怎么一步步推理的。

### 访问模式

输入框左侧有访问模式按钮：

The rest: https://github.com/liliMozi/openhanako/blob/HEAD/skills2set/user-guide/SKILL.md