使用指南

从安装到第一次对话。

跟着下面走一遍,大约十分钟。每一步都和软件里看到的一样。

PDF · 6 页 · 约 1 MB,方便打印或离线阅读。

1安装

  • 系统Windows 10 或 Windows 11(64 位)。Windows 7 / 8 无法安装,安装程序一打开就会提示。
  • 磁盘安装包约 1 GB,安装后约 3 GB。
  • 网络使用云端模型时需要联网;用 Ollama 本地模型可以离线。
  1. 下载安装包(官网下载的文件名是 Aivy-OS-Setup-2.6.5.exe,GitHub 上是 Aivy.OS.Setup.2.6.5.exe),双击运行,按提示安装。安装时有进度条,一般一两分钟。如果 Windows 提示「已保护你的电脑」,点「更多信息」→「仍要运行」——这是 Windows 对没有购买微软签名证书的软件的统一提示。
  2. 第一次打开会慢一些:系统正在检查新程序的文件(杀毒软件扫描)。等待页上会显示「已等」多久,好了会自动进入,不要重复打开。

如果 Windows 防火墙弹出「已经阻止此应用的部分功能(AivyOS.exe)」,点「取消」即可。在本机使用不受影响。

2第一次打开

  1. 软件许可协议 如果出现,阅读后勾选同意,按页面提示继续。
  2. 创建你的 AI 伴侣 填三样:AI 的名字(随你取;Aivy OS 是软件的名字)、她怎么称呼你、认证密码(输两次)。认证密码以后用来确认「是你」,请记住它。
  3. 语义搜索配置 语义模型已经随安装包内置,通常不用改,直接点「完成设置」。
  4. 基因组(灵魂) 会弹出一个编辑器,里面是 AI 的性格和说话方式,已经有默认内容。不想改就直接点「保存并重启」,确认框里再点一次「保存并重启」,倒数 3 秒后程序会自动重启一次。
  5. 选模型、填 Key 重启后出现启动配置:
    • 在 Provider 里选一家模型服务(还没有 Key?见下一节);
    • 把 API Key 粘进去——输入框下面写着去哪里获取,点「去获取 ↗」直接打开那个页面;
    • 点模型框右边的「获取模型」,能用的模型都列出来,点一个就填好,也可以手动输入;
    • 接口地址已按厂商填好,一般不用改;用中转服务时才换成它给的地址;
    • 保持「记住选择」勾选,点「启动系统」。
  6. 认出你 进入主界面后,在输入框里输入认证密码并发送(输入框里提示的「唤醒密码」就是它)。她认出你,就可以开始了。每次重新打开软件,都要再发一次——没认证时她只把你当访客:能聊天、上网查、看你发来的文件,动你电脑和数据的事都不做。
启动配置:选好厂商后,API Key 输入框下面写着去哪里获取,模型框右边有「获取模型」
启动配置:选好厂商,Key 下面就告诉你去哪里拿;模型点「获取模型」来选。

3申请模型 Key

任选一家即可,之后随时可以再加。国内用户推荐 DeepSeek 或通义千问:直连、注册简单、价格低。

启动配置里选去哪里创建 Key说明
DeepSeekDeepSeek 开放平台 · API Keys充值后即可使用
阿里通义千问 (百炼)阿里云百炼控制台 → API-KEY(密钥管理)语音也可以用同一个 Key(语音地域选北京时)
Moonshot KimiKimi 开放平台 · API Keys
智谱 GLM智谱开放平台 · API Keys
OpenAIOpenAI 平台 · API keys需要海外网络和海外支付方式
Google GeminiGoogle AI Studio需要海外网络和海外支付方式
Anthropic ClaudeAnthropic 控制台 · API Keys需要海外网络和海外支付方式
Ollama (本地)不需要 Key:装好 Ollama,用 ollama pull 下载一个模型完全在本机运行;速度取决于你的电脑
通用API (OpenAI兼容)你所用服务商的后台接口地址填服务商给的,通常以 /v1 结尾

三件事:Key 创建后往往只完整显示一次,当场复制存好;Key 等于你的账户余额,别发给任何人;提示余额不足(quota)就是该去对应平台充值了。

4开启语音

以阿里云百炼为例:地址、模型和默认音色都已经预填好,你只需要一个密钥。

  1. 先完成第 2 节最后一步的认证——没认证时,语音页只会显示「需要先认证」。
  2. 在 阿里云百炼控制台 的「API-KEY」页面创建并复制密钥。密钥要和地域一致:北京和新加坡的密钥不通用。模型也用通义千问的话,可以用同一个 Key(地域选北京)。
  3. 点主界面右上角的「设置」,切到「语音」页。「语音服务」里已经选好「阿里云百炼」,「地域」是「北京」。
  4. 把密钥粘进「密钥(API Key)」,点「验证并保存」(按回车也行)。她会真的连一次服务、念一句再听一遍,大约 15 秒,通过了才会保存。
  5. 第一次通过后,状态卡里会问「开启前确认一下:只有你在用吗?」。点「确认,只有我」,语音对话就开了,以后不再问;点「先不开」就先不开。
  6. 状态卡写着「可以开始了」,就说明整条线路都通了(卡片变绿、四行都打勾;实时对话没通过时会自动改成标准模式,卡片是黄色,也能用)。想换音色,在「选择音色」里点一张卡片,就会换上并念一句。
  7. 点「开始语音对话」,或者发送键左边的声波按钮,开口说话。她说话时你随时可以插话;点右上角的 × 结束。
设置 → 语音,第一次打开:状态卡写着「还没设置」,阿里云百炼已选中,地域北京,密钥框旁边是「验证并保存」
第一次打开:粘贴密钥,点「验证并保存」。
验证通过后:状态卡变绿写着「可以开始了」,四项检查都打勾,下面是「开始语音对话」
验证通过:四项都打勾,点「开始语音对话」。

想让她的提醒、后台任务完成的消息也念出来,打开「允许主动开口」(默认关闭;微信消息不会被念出来)。用其他语音服务时,在「语音服务」里点「其他服务」(要支持 OpenAI 兼容的识别和合成接口),填「服务地址」、模型和密钥,点「连接并检查」,通过了才会换上。

改了地域或模型后检查不通过:点「恢复默认」(状态卡上,或「高级设置」里「模型」旁边)。地域回到北京、业务空间清空、模型回到推荐值,密钥不动(音色用不了时会换成推荐音色),改完会自动再检查一次。

5日常使用

换模型
输入框旁的模型按钮(鼠标停上去显示「切换模型」)随时切换,不用重启。正在回答的这一轮用原来的模型做完,下一句就用新的。要加新模型,在菜单最下面点「配新模型 → 设置」。
打断她
回答或执行时,发送键会变成停止键,点一下就停;语音里直接开口就行。
预览台
她做好的表格、文档、PDF、网页、代码会在右侧打开,不用切窗口。
撤回改动
右上角「改动」里按时间列着她改过的代码和配置文件,不满意可以撤回。认证后才会出现。
代码工作区
右上角「IDE Workspace」进入:文件树、编辑器、对话在同一个窗口。
交代长期的事
直接说「每天早上八点提醒我……」「这件事帮我盯着」,她会到点自己醒来去做。
后台在做什么
交给后台的事在跑时,输入框上方会出现「后台 1」这样的小标识。鼠标停上去能看到每项在做什么,点一下可以钉住。
对话很长时
输入框旁的小圆环是这段对话占了多少。到圆环上那条刻度线时,较早的对话会自动整理,原文都留着;点圆环可以调「整理线」。

6员工 BOT 团队

她手下有五位员工,可以把活分出去,几件事一起做。不用额外配置:填好模型 Key 就能用,员工默认跟主模型走。认证后,聊天区左边会多一列「团队」,点头像打开员工卡,能看到这位员工在做什么。

怎么用
直接跟她说「让小探查一下……」「让阿工改一下……」,她会把活派下去,做完告诉你结果。
五位员工
小探(侦察员)查资料、找东西;分析师(分析员)理清楚再出方案;阿工(执行员)动手改文件;核对员专门挑错;监控员负责盯变化(想定期看,跟她说多久看一次)。名字和头像都能在员工卡的「配置」里改;名字、岗位、人格、技能、模型也可以直接跟她说,还能让她招新员工。
招人和技能
点员工栏的「+」或跟她说一声就能招新员工,最多再加 20 位。员工卡「配置 › 技能」里能从装好的技能里挑,每人最多 5 项。
改动放在哪
执行员的改动先放在工作间,原文件不动,员工卡的「工作间」里能看到改了哪几行。她看过差别再决定合并;不想合并,跟她说一声。合并后 7 天内也能撤回,合并之后又改过的文件不会动。员工卡上开了「能跑命令」的员工,她跑的命令可能直接改到原文件,只给放心的活打开。
想省钱
到「设置 › 模型 › 员工默认模型」换一个便宜的,也可以在员工卡的「配置 › 模型」里给某一位单独配。默认跟主模型走,主模型贵的话员工也贵。
看到「模型没配好」
头像角上出现「!」,鼠标停上去能看到原因,多半是这家还没填钥匙。到「设置 › 模型」填上;或者换回跟主模型:员工卡里选「跟着默认」,员工默认模型的厂商选「跟主模型一样」。
时间
员工的时间由她自己定。到点了,她决定加时、收尾还是重来,有事会告诉你。

7装技能、接 MCP

技能是她学会的一套做法,MCP 是接给她的一整套外部工具。都在对话里说一声就行,不用自己改配置。

贴链接装技能
把技能的 Git 仓库地址发给她,说「装上」。她会下载、装好依赖、加载,装好就能用。来路不熟的仓库,她会先问你一声。电脑里已有的技能文件夹,把路径发给她也一样。
把做法存成技能
把你的一套做法讲清楚,最后说「存成技能」。她会写成一份技能收进技能库,以后遇到同样的事就照着做。
插件市场
把插件市场的 Git 地址发给她,说「添加这个插件市场」。她会列出里面能装的插件,你看中哪个说一声,就装上了。
接上 MCP 服务
把 MCP 服务的名字或说明页链接发给她,说「接上」。在本机运行的服务多数用 Node.js 启动;远程服务要支持 Streamable HTTP,把地址和钥匙给她。
按需连接
MCP 平时不常驻,开机也不自动连。要用哪个,她自己连上,这件事做完再断开。接过的、在设置里登记过的,下次说名字就能连,不用再给配置。
  • 要先装用链接装技能、添加插件市场,电脑上要有 Git;本机的 MCP 服务多数要用 Node.js。还没装的话,跟她说一声,她可以替你装上。
  • 设置里「设置」→「能力」→「MCP 服务管理」用指示灯显示每个服务:绿灯是正在用,暗着是没连,黄灯是上次没连上、并写明原因,不用再逐个开关。正在用 MCP 时,对话框下方和语音界面左上角也会出现一个小标记。
  • 压缩包只认 Aivy OS 导出的技能包(里面带 skill.json)。别处下载的压缩包,先解压,再把文件夹路径发给她。

8数据与卸载

  • 数据在哪对话、记忆、设置都在本机的 %LOCALAPPDATA%\AivyOS;语音密钥单独加密保存在 %USERPROFILE%\.aivyos。
  • 谁能访问默认只信任本机:来自局域网和其他设备的连接一律拒绝。要远程使用,得你亲自在配置里打开并设置访问口令。
  • 卸载卸载时会问你:「保留我的数据」——重装后接着用;或「完全删除」——连同记忆、设置、语音密钥一起删干净,删除后无法恢复。

9常见问题

她把我当访客,很多事不肯做

还没认证,或者密码输错了。每次重新打开软件都要认证一次:在输入框里输入创建 AI 时设的认证密码并发送(输入框提示里叫「唤醒密码」,是同一个)。

提示 401、Key 无效

Key 复制错了、多了空格,或已经失效。去厂商后台重新创建一个,粘贴时别带空格。

提示找不到模型(model not found)

模型名写错了。点模型框右边的「获取模型」,从列表里选,不要手打。

连接失败、超时

先确认网络能访问该厂商。接口地址被改过的话,官方厂商请恢复预填的地址;用中转服务才换成它给的地址(通常以 /v1 结尾)。

第一次打开很慢

杀毒软件在扫描新安装的程序文件,等它扫完就好,之后会快很多。可以把 Aivy OS 的安装文件夹加入杀毒软件的信任列表。

语音没反应

先看「设置 → 语音」最上面的状态卡,它会直接写现在差什么。再确认:已经认证;「启用语音对话」和「仅我一人使用」都开着;Windows 允许了麦克风;点「重新检查」或「检查一下」,写着「可以开始了」就通了(第 4 行是「!」或「–」是在用标准模式,也能用)。从声波按钮进不去时,弹窗里点「前往语音设置」。

语音提示「密钥没有通过」或「密钥或地域不对」

要用阿里云百炼控制台创建的密钥,地域要和语音页选的「地域」一样(北京和新加坡的不通用)。第一次填的直接在密钥框里重新粘贴,保存过的点「更换」再粘贴,然后点「验证并保存」。

技能装不上

先确认电脑装了 Git:在命令提示符里输入 git --version,能看到版本号就行,没有就让她替你装。地址用仓库首页的地址;压缩包只认 Aivy OS 导出的格式,别的先解压再发文件夹路径。还不行,把她回复里的报错原样发回给她,让她换个办法再试。

MCP 连不上

本机的服务:先确认装了 Node.js;提示找不到 npx 的话,让她改用 npx.cmd 再连一次。远程的服务:确认对方支持 Streamable HTTP,地址和钥匙没有填错。上次没连上的,「设置」→「能力」里那盏黄灯会写明原因。

弹出防火墙提示

点「取消」即可。Aivy OS 默认只在本机使用,不需要放行外部网络访问。

还有别的问题

发邮件到 4828797@qq.com,或在 GitHub 提交问题。