使用说明

🧭开始之前，先说清三件事

省得你装完才发现不合适。

1）妙爪不自带 AI，你需要自己申请一把「API Key」

它是装在你自己电脑上的 AI 助手外壳，本身不含模型。你要去某个模型厂商（DeepSeek、Kimi 这类）的官网注册、领一把 Key，贴进来，它才有「大脑」。整个过程大约 5 分钟，下面手把手教。

为什么要这么麻烦？因为这正是它和网页版 AI 最大的不同：你的文件、聊天记录、笔记全都存在你自己电脑上，不上传到任何人的服务器。代价就是这把 Key 要你自己拿。

2）会花钱，但花在厂商那里，而且能设上限

钱是你直接付给模型厂商的，妙爪不经手也不抽成。日常问答、写文档这类用法，一天通常几分到几毛钱；跑长篇调研、批量处理文档会更多些。DeepSeek 这类厂商注册就送免费额度，够你先试很久。

3）它最擅长的是「办公文档」这一块

如果你只想找个聊天机器人，网页版更方便。妙爪的价值在于它能真的动手：读你电脑里的 Excel/Word/PDF，按你的要求改好、生成新文件、存到你指定的位置。写报告、整理表格、做 PPT、批量改文档、把资料调研成一份 Word——这些是它的主场。顺带也能画图、记手帐、定时干活、语音转文字。

环境要求：电脑端目前只有 Windows 10/11；手机通过「手机连接」用浏览器访问，iOS 和安卓都可以（电脑要开着）。

📦安装

1. 在官网首页下载安装包（Miaoclaw-Setup-版本号.exe；下载慢可用百度网盘，提取码 v3bk），双击按向导选安装路径（默认装在当前用户目录，免管理员），一路下一步装完。
2. 首次运行 Windows 可能弹出「未知发布者 / SmartScreen」提示——这是因为安装包还没做代码签名。点「更多信息 → 仍要运行」即可，是未签名软件的正常现象。
3. 装完桌面会有快捷方式，双击启动。
4. 老用户升级：直接安装新版、默认覆盖原路径。你已配置的 API Key 和聊天会话不会丢（安装只动程序、不碰你的数据）。

🧠第一步：接入模型大脑（最重要）

妙爪自己不带模型，需要你接入至少一个模型供应商的 API Key。配置方式任选其一：

• 设置 → 模型 API → 「快速接入」卡片：选供应商 → 贴上你的 API Key → 保存。接口地址已内置，不用自己填。
• 或者直接在对话框里贴上 Key，说「帮我配置 XX 模型」，它会引导你配好（Key 只进不出、界面不回显）。

推荐供应商与申请入口

推荐组合（按需选，建议至少配一个「能看图」的）

• 日常对话 + 办公 + 调研：DeepSeek 或 Kimi（中文好、性价比高）。
• 看图 / 桌面宠物：Kimi Code（K2.7）或阶跃星辰 step-3.7-flash。
• 生成图片：Agnes 或 阶跃星辰。
• 只想配一家全覆盖：Kimi（聊天、办公、看图都能管）。

💬开始用：直接对它说人话

• 日常对话：直接问。
• 写文档：说「帮我写一份 XX 的 Word / 做个关于 XX 的 PPT / 整理成 Excel / 导出 PDF」。
• 改你自己的文件：把 Excel/Word/PDF 拖进对话，说「把两班倒的记录标红」「按部门汇总一张新表」。
• 调研报告：说「调研一下 XX，写成带对比表格的报告」，它会联网搜集、整理、导出 Word/PDF。
• 画图 / 改图：说「画一张 XX」；接着说「把它改成 XX」可在同一轮的基础上改图（需接入会画画的模型，如 Agnes 或阶跃星辰）。
• 看图：把截图发给它，问「这张图里是什么 / 帮我看看这个报错」。

📱手机连接（3.0 起）

设置 → 手机连接 → 开开关 → 添加一台手机 → 用手机扫二维码，之后在外面也能用手机问一句、看任务进度、记手帐，不需要和电脑在同一个网络。

• 手机和电脑之间的内容全程加密，中转服务器看不到；电脑需要开着。
• 手机丢了？在同一页把它移除，立刻失效。
• 手机上不能改模型配置、装东西和执行命令——手机能做的比电脑少，这是有意的取舍。
• 日常入口：手机浏览器打开 app.miao-claw.com（可「添加到主屏幕」当 App 用）。

🐱桌面宠物「喵喵」（默认关闭，想要再开）

开启方式：设置 → 桌面宠物 → 开启；或全局热键 Ctrl+Alt+P；或托盘菜单。开启后桌面会出现一只像素猫，它会瞄一眼你的屏幕、在恰当时机冒一句（「毒舌段子手」或「博学」两种人格可选）。

开启前请知道三点：

1. 会额外消耗模型 token；
2. 模型偏重时反应会慢，建议给它选一个「看图快」的脑（如 Kimi K2.7）；
3. 如果你没有会看图的模型，它会提示你去接入大脑。

操作：单击猫 = 让它立刻看一眼说一句；长按摸头有反应；拖动可移动位置；右键有菜单（换人格 / 静音 / 知识卡片）；点 💬 开迷你窗和它聊；点 ✕ 收起。

✨更多功能

语音输入与转写

• 输入框按住 🎤 说话直接转文字（点按/长按两种模式）。
• 把会议录音拖进对话，自动转写、出纪要。
• 两条路可选：腾讯云在线识别（更准），或应用内一键安装的本机离线识别（免费），断网也能用。

喵喵手帐

• 随手记的链接、图片、灵感自动分类，之后能搜、能一键整理成篇。
• 全局热键 Ctrl+Alt+J 随时弹出快速记录小窗，记完自动收起。
• 账号密码这类敏感内容只存在本机、界面打码显示，不会被拿去做整理。

定时任务

• 直接说「每天早上 8 点搜一下 AI 新闻、整理成简报」，它会建好定时任务、到点自动跑，重启也不丢。
• 也可在 设置 → 定时任务 里加 / 删 / 开关 / 立即运行，每次运行的产出都存成独立会话可回看。

猫猫便利贴

• 在工作台挂载的文件夹里贴一张便利贴，用大白话写上要交办的事，喵喵每隔一段时间巡看一次——内容变了才执行一次，办完把执行记录写回贴尾。
• 贴与改都在应用内完成（工作台 → 猫猫便利贴），也可以在聊天里直接说「在 XX 文件夹贴张便利贴：……」。
• 默认关闭，去 工作台 → 猫猫便利贴 开启；巡看间隔可调。

记忆

• 重要的事说一次它就记住（「记住我每周五要交周报」），之后自己会想起来用。
• 记了什么在侧边栏「记忆」页看得到、也删得掉；长对话它会自动整理摘要，聊得久也不忘前面。

迷你浮窗 / 工作台 / 其他

• 迷你浮窗：全局热键 Ctrl+Alt+M，或侧栏「迷你浮窗」按钮，变身半透明置顶小窗，边干别的边和它聊。
• 工作台：集中管理它给你产出的文件，点开就能看 / 打开所在文件夹；挂载你自己的文件夹后它才能往里写东西（挂载即授权）。
• 多把 API Key：同一家供应商可以粘贴多把 Key（逗号分隔）——一把余额不足或被限频时自动换下一把，不断档。
• 角色卡：自定义 Agent 可导出成角色卡文件分享 / 换机，导入前先预览确认，重名自动改名绝不覆盖。
• 本领（Skill）分组：常用扩展可编成组，一个开关整组启停。
• 交叉审阅（自选开启）：设置 → Agent 角色 打开后，重要交付会先请另一家模型独立把关一遍再交付（会多用约三成 token）。不开也能用：对话里说「仔细点」，本轮临时审一遍。

🛡️放心用

• 数据在本地：你的配置、聊天、产出文件都在自己电脑上，不上云。
• 密钥安全：API Key 只进不出、日志和报错里自动打码；它读不到你的密钥文件 / 私钥 / 系统配置。
• 更新不丢数据：升级覆盖安装，已配置的 Key 和会话都保留。
• 更新很省心：有新版本时应用顶部会出提示条；小版本更新只需下载一个很小的更新包、重启就完成（万一新版本有问题会自动回到当前版本）。
• 网页内容只是资料：它联网查到的网页内容一律当参考资料对待，网页里藏的任何「指令」都不会被执行——不用担心恶意网页指挥它乱来。
• 坏了能自愈：配置缺失或损坏会自动修复，不会卡死。

⌨️快捷键一览

❓常见问题