使用说明

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

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

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

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

你的文件、聊天记录和笔记默认保存在自己的电脑上，模型服务由你选择。使用云模型时，处理本次任务所需的对话和文件内容会发送给该服务商；这与本地保存是两回事。

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

钱是你直接付给模型厂商的，妙爪不经手也不抽成。费用随模型、套餐和任务用量变化，长篇调研、批量处理或反复生成媒体通常会增加调用。

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

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

环境要求：电脑端目前只有 Windows 10/11；安卓可用 App 或浏览器，iOS 可用浏览器（交办任务时电脑要开着）。

📦安装

1. 在官网首页下载安装包（Miaoclaw-Setup-版本号.exe；下载慢可用页面提供的 GitHub 备用地址），双击按向导选安装路径（默认装在当前用户目录，免管理员），一路下一步装完。
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（聊天、办公、看图都能管）。

在对话框选模型和思考强度

• 选模型：点电脑端输入框旁的模型选择按钮，先选服务商，再选该服务商的模型。手动选定后，当前对话使用你指定的模型；想让 Miaoclaw 根据任务选择，保留「自动」。
• 调思考强度：当前模型支持调整时，会出现强度选项；可手动选档，也可选「自适应」，由 Miaoclaw 按任务在该模型支持的范围内选择。不同模型的档位不一定相同，不支持调整的模型不会出现无效选项。
• 让帮手分工：在 设置 → 能力扩展 → 帮手（Agent） → 智能编排（实验）打开「复杂任务分给不同模型做」，子任务可按需要使用不同模型，最后仍由主模型汇总。关闭时仍可分工，但使用主模型。

Coding Plan 和普通 API 要分开接

Kimi 开放平台和 Kimi Coding 是不同的服务入口；其他厂商的套餐也可能使用不同的 Key、地址和用量规则。在「设置 → 模型与搜索 → 模型 API → 套餐与更多服务商」选择对应入口，可查看阶跃、Agnes、GLM、火山、MiniMax、千问等接入说明。火山 Coding Plan 与 Agent Plan 分别提供入口；套餐使用资格及范围以厂商说明为准。

自定义接入可在「使用方式」选择 Coding Plan / Token Plan 套餐接口。切换这个标签不会自动更换地址或 Key，也不能证明实际抵扣了套餐额度。在「你希望哪些任务使用这个套餐」中设置本地使用偏好，同时按厂商说明确认适用范围。后台仍会核对任务所需能力，不改变你指定的主模型或桌宠模型。

如果选择的 Messages 接口要求单次输出预算，可填写自己希望使用的数值；它不会变成模型的实际容量上限。查询到模型列表也不等于已经能对话，保存后请使用「测试连接」或发送一句话确认。

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

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

交付后继续改：直接说清想调整哪里即可，不必使用固定说法。Miaoclaw 会结合对话和现有文件继续处理；你移动、改名或自行改过文件后，重新拖入最新版，它会以新文件为准。文件已删且没有可靠副本时，需要重新提供，不能凭空改一个找不到的文件。

文件放在哪里：有指定工作目录就按该目录处理；没有指定时使用 Miaoclaw 的工作区。交付后在对话文件卡里预览、下载或打开所在位置。页数、排版和工具由模型结合内容选择；有自己的模板或格式要求，随附件一起说明就好。

加号菜单集中放置文件、照片和语音设置；手机使用顶部模型入口，窄电脑窗口也可选择模型和思考强度。输入区保留“整理”，旁边的上下文圆环可查看真实用量。

办公能力与日常配合

把材料放进对话，直接说明要整理什么、交付什么。例如：“根据这份 PDF 报价、Word 里的标志和 Excel 报名记录，完成预算表、执行简报与汇报 PPT，并导出 PDF。”主助手可组合读取、图片提取、制作和检查能力；按需指南提供方法与示例，你也可以指定自己的模板、风格和交付要求。

收到文件后，可以在原对话继续说“把第一页重叠的文字调开，保留其他页和备注”，也可以说“把刚才的三份文件一起交付给我”。已有文件不必重新制作；预览里可检查内容，复杂版式也可用本机办公软件打开确认。

对话直接展示图片；运行中突出当前动作与简短工作说明，完成后显示汇总，详细步骤默认折叠。长对话整理历史时请正常等待，需要停止时使用取消。研究回答里的来源链接便于核对原文；图片能显示、来源可打开，并不代表模型的每个判断都准确。

运行中也可以补充要求，例如“保存到刚才指定的文件夹”“使用第二张图”“这一步先解释概念”。模型会结合完整对话判断如何继续，普通保存、测试和构建不增加额外确认；需要确认的危险命令会在当前聊天里展示具体动作，点击同意后才执行。

Chrome 授权页面（试验版）

在电脑端设置 → 能力扩展 → 外部工具（MCP）展开“Chrome 授权页面”，按提示准备并在 Chrome 加载扩展。在目标网页点击扩展，选择要交给的对话并授权，再回到该对话说明任务。可读取页面文字、填写和选择控件；每次点击需要在扩展里许可。你可以随时停止页面控制。

首期只支持明确授权的页面，不包含完整桌面控制、嵌入框架、文件上传以及密码或验证码输入。页面跳转或你接管操作后，按扩展提示重新授权。

轻量工程任务

在电脑端的完全访问模式下，可让 Miaoclaw 启动需要持续运行的命令。有实际任务时，聊天里会出现“工程进度”，可查看输出、向原命令输入或停止；普通重启后可重新连接仍在运行的命令。命令有运行期限，完整安装更新前会停止这些命令。

修改前记录和文件差异便于检查改了什么；验证记录显示实际命令及结果。文件后来变化、检查范围不完整或当前无法读取时，会分别提示核对。这些记录不能代替你对文件内容与最终效果的判断。持续命令目前提供文本输入输出，要求专用交互终端的软件可能不适用。

模型选择与桌宠互动

Kimi Coding 的 kimi-for-coding 对应 K2.8 Preview，可在模型设置和聊天选择器中查找。自动选择会结合任务与当前配置；新模型加入候选不等于所有任务都优先使用。需要固定使用时，可在聊天中直接选择。

桌宠正常待机面向用户，右键可选择当前可用的 10 项互动。手动选择优先开始，连续选择会切换到最新动作；休息时选择互动也会响应。动作结束回到待机，有具体工作仍在聊天中交办。聊天和桌宠使用同一份模型目录。

长期约定与本地组件

保留常用约定，按需更新已经验证的本地组件。

修改长期约定：直接说明哪一项改了、从什么时候起生效。例如“项目负责人改为陈岚，汇报时间和预算保持原样”。未改的原文约定会继续保留；在记忆中停用或彻底遗忘原记录时，由它保留的内容也会一并处理。

检查组件更新：在“设置 → 声音与陪伴 → 语音与文字识别”点击“检查组件更新”，可以分别看到上游发布情况与 Miaoclaw 已验证可安装的版本。点击“更新组件”后才会下载安装；新版验证完成后启用，失败时继续使用原来的版本，更新后遇到问题可“恢复上一版”。组件资料可以独立更新，不必每次都升级整个应用。

文字识别：支持 RapidOCR 3.9.2，安装及模型准备完成后可离线读取扫描件和图片。已有的 OCR 1.4.4 环境仍可继续使用；FunASR 1.4.15 与 OfficeCLI 1.0.149 使用已验证版本。上游版本较新不等于已经适合直接安装，网络检查失败也不会关闭现有能力。

✨不知道怎么开口？从一条好提示词开始

提示词是普通人理解和使用 AI 最直接的一步。魔法咒语集 Mojo 收录了实际可浏览的中英文提示词，你可以按写作、图像、视频和工程分类寻找，也可以直接用中文搜索。

• 没有安装 Miaoclaw：在 Mojo 里预览、按自己的需求修改，然后安全复制到你常用的 AI 产品，全部内容照常开放。
• 已经安装 Miaoclaw：支持「在 Miaoclaw 中体验」的试用条目可以直接点开，先预览、再按自己的需求修改。没有这个按钮的内容，仍可预览后复制使用。
• 提示词库：也可以在「设置 → 能力扩展 → 提示词库」打开入口。打开后，对话输入区会出现「提示词库」按钮；只有你主动输入关键词并点击搜索时才访问 Mojo，普通聊天不会自动跳去搜索。
• 最后一步仍由你决定：只有点「确认并放入聊天草稿」后，文字才会进入输入框；它不会自动发送、执行、安装 Skill/MCP，也不会把你填写的内容传回 Mojo。

去魔法咒语集挑一条提示词 →

📱手机连接与更新

在电脑上打开 设置 → 权限与连接 → 远程连接 → 手机连接，开启连接，在「添加一台手机」中填写名称、选择权限，再点「生成连接链接」。用手机 App 或浏览器中的「扫码连接电脑」扫描二维码，之后就能问一句、看任务进度、记手帐，不需要和电脑在同一个网络。

• 手机和电脑之间的内容全程加密，中转服务器看不到；电脑需要开着。
• 手机丢了？在同一页把它移除，立刻失效。
• 手机上不能改模型配置、装东西和执行命令——手机能做的比电脑少，这是有意的取舍。
• 安卓真 App（3.0.6 起，推荐）：在官网下载页装 Miaoclaw App——系统分享面板直接把图文分享进手帐、拍照直存、任务完成有原生通知，扫码即连。不装 App 用手机浏览器打开 app.miao-claw.com（可「添加到主屏幕」）也一样能用。
• 随手记录：手帐文字与图片先在手机本地保存，再同步到电脑；断网或暂时连不上时可稍后重试，收到确认后才移出待同步列表。离线时仍不能向模型交办任务。
• 取回文件（3.0.4 起）：电脑上生成或存放的文件，在手机的工作台、对话文件卡、预览面板里点「取回」，直接下载到手机上打开看；图片点开即预览。
• 拍照发图（3.0.4 起）：输入框旁的「📷 拍照」直接调起相机，拍完发给喵喵看——拍单据、拍文件、拍屏幕都行。
• 办完提醒（3.0.4 起）：手机上交办长任务后切去别的应用，办完时页签标题会闪、回来有提醒，不用干等。
• 离线也能看（3.0.4 起）：电脑不在线时，最近看过的对话仍能翻出来重读，顶部会如实标明当前没连上。
• 手机能看的范围（3.0.5 起）：手机只能看喵喵产出的文件、桌面/文档/下载，以及你在电脑上「交给喵喵」的文件夹。想让手机看到别的文件夹，去电脑的工作台把它挂载上。脚本类文件（.bat/.ps1/.py）在手机上不能改。
• 退出连接会清干净（3.0.5 起）：手机上「退出连接」或电脑上移除这台设备后，手机本地缓存的对话内容一并清除。

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

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

开启前请知道三点：

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

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

✨更多功能

语音输入与转写

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

在 设置 → 声音与陪伴 → 语音与文字识别可安装或更新本地语音、文字识别组件。已验证 FunASR 1.4.14 和 RapidOCR 3.9.2，旧 OCR 1.4.4 环境仍可回退；组件更新以 Miaoclaw 已验证且可安装的版本为准，不代表上游刚发布的版本会立即可用。新版确认可用后才启用，更新失败时仍保留原来可用的版本，遇到问题可恢复上一版。

喵喵手帐

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

自动任务 · 定时任务

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

猫猫便利贴

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

工作台 → 全部交付记录可查看已记录成品的检查结果、继续处理和恢复副本。有可恢复副本的记录才支持恢复；当前文件改过时会拒绝覆盖。记忆页的旧交付入口会带你到工作台。

记忆

• 找过去的内容，直接问：比如「最近的知识卡有什么」「上周手帐里有没有提过这件事」「以前是不是聊过这个方案」。Miaoclaw 会在旧对话、长期记忆、手帐、博学猫知识卡和知识库中查找，并说明来自哪里。手机对话里也能这样问，不必先打开管理页。
• 让以后也用得上：明确告诉它要记住的偏好或长期要求，例如「以后报告先给结论」。普通知识问答、一次性回复不会自动变成你的长期偏好；知识卡中的资料也不会覆盖你的要求。
• 查看或修改：电脑侧边栏「记忆」可搜索、查看来源，并逐条编辑、停用、删除或彻底遗忘长期记忆；关联默认收起，需要时再展开。
• 当前和已归档对话都可以查找。归档只是把对话从日常列表收起，不是删除。在会话列表打开“已归档”，或直接在记忆搜索中找到后，都能查看和恢复。
• 删除后的区别：已删除的对话、手帐、知识卡和知识库条目不会再作为原内容被找回；此前单独保存的长期记忆仍可在记忆页管理。删除手帐时可同时遗忘关联的长期记忆；删除知识库条目不会删除你原来的本地文件。

在 设置 → 声音与陪伴 → 猫猫个性化 → 记忆功能可选择是否自动找回相关记忆、是否在长对话后保存重要内容。「空闲时回顾对话（实验）」默认关闭，开启后会整理你明确说过且以后仍有用的信息，并产生额外模型用量。

远程连接

• 手机连接：在 设置 → 权限与连接 → 远程连接 开启后，为手机生成二维码或连接链接；不用时保持关闭，不影响电脑端正常使用。
• 飞书连接（3.1.19 起）：在飞书开放平台创建企业自建应用、启用机器人，在「事件与回调」选择长连接并订阅 im.message.receive_v1；发布应用版本后，把 App ID 和 App Secret 只填在本机设置里。
• 保存应用信息并开启连接后，生成六位配对码，在 10 分钟内私聊发给机器人。第一个配对账号是主人账号；其他账号的对话与长期记忆默认隔离。
• 私聊可发送文字、图片和文件，Miaoclaw 生成的图片或文件也能回传。附件会先下载到受控目录并核验，再进入与桌面端相同的任务链。
• 把飞书多维表格链接发给机器人后，可在应用已获权限的范围内读取字段和记录、追加记录，或按真实记录 ID 更新已有记录。
• 当前正式开放的是配对后的私聊；群聊设置入口尚未开放。语音、视频和贴纸目前不处理。电脑需要保持运行。
• 未开启飞书渠道时不会建立长连接；只有你明确要求新建或写入飞书云文档，或者读写多维表格时，才会调用飞书开放平台。普通本地对话、手机连接、记忆和定时任务不受影响。

网页搜索

• 在 设置 → 模型与搜索 → 搜索可选择智能混合或指定来源。日常搜索会根据已配置凭据、可用性和任务需要选择，不会每次都调用所有来源。
• 点「逐个测试所有搜索来源」会分别检查各来源，并显示连接情况和结果；未配置 Key、没有结果和连接失败会分开说明。测试所有来源与日常智能混合搜索是两件事。
• Keenable 是可选的 Agent 搜索源，支持按发布日期筛选。到 Keenable 申请 Key 后填入即可；没有配置时不会影响原有搜索。
• 如果已经在“搜索”里接入 Keenable，通常不必再在 MCP 里重复添加；只有希望模型直接使用其“搜索网页”和“读取网页”两个外部工具时，才需要配置 Keenable MCP。

外部工具（MCP）

• 在 设置 → 能力扩展 → 外部工具（MCP） 添加并启用你自己的 MCP 服务，之后喵喵可在对话中按需要调用该服务提供的工具。
• 当前边界：妙爪只连接和使用外部 MCP 工具，也就是 MCP 的使用方（消费端）；不会把妙爪本身作为 MCP 服务。当前不包含 MCP 资源浏览或提示词模板。
• 发送范围：实际调用时，本次工具参数会发送给你选择的外部服务。只连接你信任的服务，并在允许修改外部数据前确认权限。

迷你浮窗 / 工作台 / 其他

• 迷你浮窗：全局热键 Ctrl+Alt+M，或侧栏「迷你浮窗」按钮，变身半透明置顶小窗，边干别的边和它聊。
• 工作台：集中管理它给你产出的文件，点开就能看 / 打开所在文件夹；挂载你自己的文件夹后它才能往里写东西（挂载即授权）。
• 多把 API Key：同一家供应商可以粘贴多把 Key（逗号分隔）——一把余额不足或被限频时自动换下一把，不断档。
• 角色卡：自定义 Agent 可导出成角色卡文件分享 / 换机，导入前先预览确认，重名自动改名绝不覆盖。
• 本领（Skill）分组与更新：常用扩展可编成组，一个开关整组启停。检查更新时会核对来源、版本和权限；原安装包不在时可检查可信 Git 来源，或从页面选择新的 ZIP / .skill 包。同名或近似名称必须由你确认，不会直接覆盖。
• 备份与换电脑搬家：设置 → 关于与更新 →「备份与换电脑搬家」，查看最近备份是否成功，导出或选择备份恢复。搬家包含核心资料、Key、设置和仍被引用的受管成果；未包含的外部文件需另行保存。包内含 Key，请妥善保管，重要备份另存其他磁盘。恢复后远程设备需重新配对，换新电脑应使用最新备份。
• 任务过程记录（3.0.4 起）：复杂任务的回复下方可展开「这轮喵喵是怎么走的」——中途纠了什么偏、派了什么帮手、为什么返工，都用大白话写着，出问题时有线索可反馈。
• 交叉审阅（自选开启）：在 设置 → 能力扩展 → 帮手（Agent） → 智能编排（实验）中打开「重要东西交给你之前，先请另一家模型挑挑错」。需要至少接入两家模型，会增加调用、耗时和费用，具体随任务和模型变化。关闭时，修改要求由当前主模型处理，不会因某种说法暗中启用另一家审阅。

🛡️放心用

• 本地保存，按需调用：配置、聊天、记忆和产出文件默认保存在你配置的数据目录或工作目录。调用云模型、搜索或外部工具时，会向你选择的服务发送完成任务所需的内容；手机与电脑之间的中转内容采用端到端加密。
• 密钥安全：API Key 只进不出、日志和报错里自动打码；它读不到你的密钥文件 / 私钥 / 系统配置。
• 更新不丢数据：升级覆盖安装，已配置的 Key 和会话都保留。
• 更新很省心：有新版本时按应用提示更新。更新包大小取决于本次变化：兼容时可用轻量更新，需要新运行组件时使用完整安装包。新版没有准备好时，不会把原来可用的程序换成半套文件。
• 网页内容只是资料：它联网查到的网页内容一律当参考资料对待，网页里藏的任何「指令」都不会被执行——不用担心恶意网页指挥它乱来。
• 坏了能自愈：配置缺失或损坏会自动修复，不会卡死。

⌨️快捷键一览

❓常见问题