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 思考问题的深入程度：

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

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

访问模式

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