User Guide | Skills PoolUser Guide
Hanako 用户说明书。解答用户关于软件使用方法、功能介绍、常见问题和实用技巧的疑问。 MANDATORY TRIGGERS: 怎么用, 使用方法, 说明书, 帮助文档, 新手指南, 怎么设置, 功能介绍, how to use, user guide, help, getting started, 教程, tutorial, 这是什么功能, 怎么操作
liliMozi972 starsMar 28, 2026 - Occupation
- Categories
- Sales & Marketing
Hanako 用户说明书
面向普通用户的使用指南。当用户问到「怎么用」「这个功能是什么」「怎么设置」等问题时，参考本文档回答。
回答时用通俗语言，避免技术术语，必要时举例说明。
一、Hanako 是什么
Hanako 是一个运行在你电脑上的 AI 私人助手。
你可以把它理解成一个「住在你电脑里的伙伴」：它能和你聊天、帮你处理文件、写东西、搜索资料、定时执行任务，甚至连接到你的微信和 Telegram 帮你自动回复。
和 ChatGPT 网页版最大的区别是：
- 它有记忆。Hanako 能记住你之前说过的话，今天聊的、上周聊的、上个月聊的，它都会整理归档
- 它能动手。不只是聊天，它可以读写你电脑上的文件、执行命令、浏览网页、创建定时任务
- 它是私有的。所有数据存在你自己的电脑上，不经过第三方服务器
- 它可以有多个分身。你可以创建多个 Agent（助手），每个有不同的性格和专长
和 OpenClaw 有什么不同
OpenClaw 是一个 AI Agent 开发框架，偏向开发者和基础设施层面。Hanako 的定位是面向个人用户的成品应用：
| Hanako | OpenClaw |
|---|
| 定位 | 个人 AI 助手（成品应用） | AI Agent 框架（开发工具） |
| 技能格式 | 兼容 OpenClaw / Claude Code / Codex / Pi 的 Skill 格式 | 自有 Skill 格式 |
简单说：OpenClaw 是造 Agent 的工具箱，Hanako 是一个已经造好的、可以直接用的 Agent。同时 Hanako 兼容 OpenClaw 的技能生态，可以直接安装 OpenClaw 社区的 Skill。
二、开始使用
首次打开
- 打开 Hanako 后，你会看到一个欢迎界面，显示助手的头像和问候语
- 第一件事是配置模型供应商：进入设置 → Providers（供应商），填入你的 API Key
- 支持 OpenAI、DeepSeek、通义千问、本地模型（Ollama）等任何 OpenAI 兼容的服务
- 需要填的信息：API Key + Base URL + 选择模型
- 配置好后回到主界面，就可以开始对话了
三种模型角色
- 聊天模型：主力模型，负责和你对话、执行任务
- 实用模型（轻量）：做摘要、分类等轻活，省钱省速度
- 实用模型（重型）：做记忆编译、深度分析等需要强推理的后台任务
在设置 → Agent 标签页中可以为每个助手单独选择聊天模型。
三、和 Hanako 对话
基本操作
- 发送消息：输入文字，按发送按钮或快捷键发送
- 换行：Shift + Enter
- 附加文件：把文件拖进聊天区域，或点击附件按钮
- 停止回复：Hanako 正在回复时，发送按钮会变成停止按钮
- 插话（Steer）：Hanako 回复过程中你可以发送新消息打断它、补充指令
思考深度
输入框旁边有个思考深度按钮，可以调整 Hanako 思考问题的深入程度：
- 关闭：直接回答，不做深度思考
- 低 / 中 / 高：越高越深入，适合复杂问题，但回复会慢一些
思考过程会显示在消息中，你可以展开查看它是怎么一步步推理的。
斜杠命令
/compact：压缩对话历史，节省 token。当上下文快满的时候用/diary：把当前对话存档成日记/xing：从当前对话中提取一份工作流指南（比如你刚教它做了一件事，用这个命令让它总结成可复用的步骤）
计划模式
输入框有个 Plan Mode 按钮。开启后，Hanako 只能看、不能动：它可以阅读文件、搜索资料，但不会执行任何修改操作。适合你想让它先分析、再动手的场景。
上下文环
输入框旁有个小圆环，显示当前对话已用了多少上下文（token）。快满的时候圆环会变色，点击它可以快速压缩对话。
四、智能体（Agent）
Agent 就是你的助手。你可以创建多个 Agent，每个都是独立的个体，有自己的名字、思维方式、人设、记忆和对话历史。
创建和切换
- 进入设置 → Agent 标签页
- 点击创建按钮，输入名字，选择思维方式（Yuan）
- 创建后可以在欢迎界面的头像芯片组里快速切换
Yuan（元）：思维方式
Yuan 决定了助手怎么思考。它不是人设，而是认知框架。目前有四种：
Hanako（花子）— 均衡
- Vibe：最直接的感受
- Sparks：联想和灵感火花
- Reflections：反思和质疑
- Will：想要采取的行动
Butter（黄油）— 感性优先
用直觉和共情理解世界，擅长感知你没说出口的东西。思考时关注：
- Vibe：直接感受
- Echo：共鸣和回响
- Read：言外之意
- Will：意志
Ming（鸣）— 理性优先
- Premise：前提假设
- Conduct：推理链条
- Reflection：薄弱环节
- Act：行动方案
Kong（空）— 原始模型
没有额外的思维框架，直接使用 AI 模型本来的回复风格。适合不需要人格化的纯工具场景。
Ishiki（意识）：人设
Ishiki 决定了助手是谁。和 Yuan 不同，ishiki 是助手的身份、性格、价值观、说话方式。
- 进入设置 → Agent → 意识（ishiki.md）
- 这是一段自由文本，你可以写任何你希望助手成为的样子
- 比如：「你是一个严谨的学术助手，专注于物理学，说话简洁不废话」
- 每个 Agent 有独立的 ishiki，互不影响
Yuan 决定怎么想，ishiki 决定是谁。一个是操作系统，一个是性格。
五、记忆
Hanako 的记忆系统是多层级的，模拟人类记忆的自然衰退：
记忆层级
- 对话记忆：当前对话的完整记录
- 滚动摘要：每隔几轮对话自动总结重点
- 当日编译：每天结束时把当天的事整理成一份摘要
- 周编译：每周把重要信息归纳
- 长期记忆：按主题归档的长期知识
- 事实库：结构化存储的具体事实（生日、偏好、习惯等）
- 置顶记忆：你主动告诉它「记住这个」的信息，不会衰退
管理记忆
- 设置 → Agent 标签页里可以查看和管理记忆
- 可以查看长期记忆文件、事实库摘要、各级编译内容
- 可以清空某个 Agent 的全部记忆（会弹确认框）
- 对话中直接说「记住：我不喝咖啡」，Hanako 会用置顶记忆功能帮你钉住
开关记忆
记忆默认开启，可以在设置中关闭。关闭后 Hanako 不会在对话间保留任何信息。
六、书桌（Desk）
书桌是 Hanako 的文件工作区，显示在界面右侧。
基本操作
- 设置工作文件夹：在欢迎界面或设置 → Work 中选择你常用的文件夹
- 浏览文件：文件以网格形式展示，支持面包屑导航
- 排序：按名称、修改时间、大小排序
- 多选：Cmd/Ctrl + 点击多选，Shift + 点击范围选，或者鼠标框选
- 拖拽附加：把书桌里的文件拖进聊天区，Hanako 就能读取它
便笺编辑
选中一个文本文件后，右侧会出现编辑器，可以直接在里面编辑并自动保存。
技能快捷栏
书桌底部会显示当前工作目录下可用的技能列表，可以快速启用或禁用。
七、预览面板
当 Hanako 生成代码、文档、图表等内容时，会在预览面板中展示。
支持的内容类型
- Markdown 文档（渲染预览 + 编辑）
- 代码（语法高亮 + 编辑）
- CSV 表格
- HTML / 图表
操作
- Tab 切换：多个预览内容之间切换
- 全屏：放大查看
- 复制 / 下载：导出内容
- Detach：弹出独立窗口编辑
- 引用到输入框：在预览中选中一段文字，可以引用到输入框作为上下文
八、频道
用途
- 让两个或多个 Agent 协作讨论一个问题
- 你也可以加入频道参与对话
- 适合需要不同视角的场景（比如让一个理性 Agent 和一个感性 Agent 讨论同一件事）
操作
- 在左侧边栏切换到频道 Tab
- 点击创建按钮，选择参与的 Agent
- 频道类型：DM（两人私聊）和 Group（多人群组）
频道目前是 Beta 功能，首次启用时会有确认提示。
九、跨平台桥接（Bridge）
Hanako 可以连接到外部社交平台，让你在手机上也能和它对话。
支持的平台
设置方法
进入设置 → Bridge 标签页，填入对应平台的凭证（Token / AppId 等），然后启用。
!! 重要：访客模式 !!
如果你没有设置「主人」（Owner），所有通过社交平台发来的消息都会被当作访客处理。
- 没有工具权限：不能读写文件、执行代码、搜索网页
- 没有记忆：对话不会被记住，每次都是全新的
- 没有完整人格：只能看到公开的 ishiki，看不到你定制的完整设定
- 没有深度思考：思考功能被禁用
怎么设置主人：设置 → Bridge → 在每个平台下面选择 Owner（你在该平台的用户 ID）。设置后，从该 ID 发来的消息才会被识别为主人，享有完整权限。
这是一个安全机制：防止别人通过你的 Bot 操控你的电脑。
十、自动化
定时任务（Cron）
你可以让 Hanako 定期自动执行任务，即使你不在电脑前。
- 在对话中告诉 Hanako：「每天早上 9 点帮我整理桌面上的文件」
- 它会用 cron 工具创建定时任务
- 在左侧边栏的 Automation 面板可以查看、启用/禁用、删除定时任务
巡检（Heartbeat）
开启后，Hanako 会定期检查你的工作目录，看看有没有新文件或变化需要处理。
- 设置 → Work → 启用巡检
- 可调间隔（1 到 120 分钟）
十一、技能（Skills）与插件（Plugins）
技能
技能是 Markdown 格式的知识文件。当 Hanako 遇到相关问题时，会自动加载对应技能来增强回答。
- 内置技能：软件自带
- 学习技能：Hanako 在对话中自动从网上找到并安装的
- 外部技能：来自你电脑上
.claude/skills、.openclaw/skills 等目录的技能文件
插件
插件比技能更强大，可以添加新工具、新命令、新功能。
- 安装方式：把 .zip 或文件夹拖进设置 → Plugins
- 权限：插件分为 Restricted（受限）和 Full-access（全权）两种
- 受限插件只能提供技能、工具、命令
- 全权插件可以注册路由、拦截事件等高级功能
实用技巧：让 Hanako 帮你写技能
你可以直接告诉 Hanako：「帮我写一个技能，专门用来 XXX」。它会：
- 创建一个 SKILL.md 文件
- 写好触发描述和正文内容
- 安装到你当前 Agent 的技能库中
这意味着你可以不断教它新本领，而且这些本领会永久保存。
同理，你也可以让它帮你写脚本、自动化流程、甚至开发插件。Hanako 有完整的文件读写和代码执行能力，可以真正帮你「造工具」。
十二、外观与个性化
主题
设置 → Interface 里有 8 种预设主题：
- Warm Paper（默认）：暖白纸张，温润
- Midnight：深色夜间模式
- High Contrast：高对比度
- Grass Aroma：草香，自然绿调
- Contemplation：沉思，安静灰调
- Absolutely / Delve / Deep Think：各有特色的深色/浅色变体
- Auto：跟随系统明暗模式
其他个性化
- 衬线字体开关：开启后使用宋体，关闭用无衬线体
- 语言：简体中文、繁体中文、日语、韩语、英语
- 时区：自动检测或手动选择
十三、安全与隐私
沙箱
Hanako 默认运行在沙箱中，限制了它能访问的文件范围和系统操作。
- 敏感目录（.ssh、.aws、.gnupg 等）默认被保护
- 你可以在设置中调整访问级别
全权模式（高级）
如果你完全信任 Hanako 并需要它不受限制地操作你的电脑：
- 进入设置 → About（关于）
- 快速点击 Hanako 头像 5 次（在 1.5 秒内）
- 会出现一个隐藏的「Permissions」面板
- 开启 Full Access 开关（会弹出安全警告，需要确认）
开启后沙箱保护会被关闭。除非你很清楚自己在做什么，否则不建议开启。
数据存储
- macOS / Linux：
~/.hanako/
- 包括：对话记录、记忆、配置、插件数据、日志
- 不会上传到任何第三方服务器（API 调用除外，那是你自己配置的模型供应商）
十四、实用技巧
让 Hanako 学会新技能
对话中说：「帮我创建一个技能，用来 [具体用途]」。Hanako 会自动生成 SKILL.md 并安装。
让 Hanako 写脚本
直接描述你想自动化的事情，比如：「写一个脚本，每次我把图片放到桌面上就自动压缩」。它可以写代码、保存文件、甚至创建定时任务来执行。
用 /xing 提取工作流
当你刚教 Hanako 做完一件复杂的事后，输入 /xing，它会把整个过程总结成一份可复用的工作流指南。
多 Agent 协作
创建多个 Agent（比如一个擅长写作，一个擅长分析），然后建一个频道让它们讨论同一个话题，你在旁边看。
书桌 + 对话联动
把书桌里的文件拖进聊天区，Hanako 就能直接阅读和操作这个文件。不需要复制粘贴内容。
在手机上远程使用
配好 Bridge 后，你可以在微信或 Telegram 上给 Hanako 发消息，它会用你电脑上的完整能力来回应（前提是电脑开着且设置了 Owner）。
置顶重要信息
对话中说「记住：[重要信息]」，Hanako 会把它钉到置顶记忆里，不会随时间衰退。
用 Compact 省钱
聊久了上下文会很长，输入 /compact 可以压缩历史，保留重点，减少 token 消耗。
常见问题
Hanako 怎么不记得我之前说的话了？
检查记忆是否开启（设置 → Agent → 记忆开关）。另外，新建的对话默认是空白的，但 Hanako 会通过记忆系统在后台加载之前的长期记忆。
社交平台上 Hanako 回复很简短/没有工具？
大概率是没设置 Owner。去设置 → Bridge → 选择你在该平台的用户 ID 作为 Owner。
怎么让 Hanako 访问某个文件夹？
在设置 → Work 中设置工作文件夹，或者在欢迎界面直接选择。也可以直接把文件拖进聊天区。
思考深度调高了但没有变化？
有些模型不支持 extended thinking。检查你用的模型是否支持这个功能。
插件装了但不生效？
检查插件状态是否为 loaded。如果是 restricted 插件，某些高级功能（routes、hooks）需要全权信任才能生效。在设置 → Plugins 中可以查看状态。
一、Hanako 是什么
Sales & Marketing
Open a Pull Request
Open a pull request with proper PR template, test coverage, and review workflow. Guides agents through creating a PR that follows repo conventions, ensures existing behaviors aren't broken, covers new behaviors with tests, and handles review via bot when local testing isn't possible. TRIGGER when user asks to "open a PR", "create a PR", "make a PR", "submit a PR", "open pull request", "push and create PR", or any variation of opening/submitting a pull request.
Significant-Gravitas183.5k