人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载本文以 Project AIRIAIRI-0.12.0-beta.5桌面版说明书为主体系统讲解 AIRI 的安装方式、初始化引导、桌面端与网页端界面操作以及「设置」中角色卡、机体模块、场景、角色模型、服务来源、连接和系统等全部配置项。读完本文你将能够独立完成 AIRI 的安装与模型接入、熟练使用主窗口、系统托盘与聊天窗口并为角色配置语音、视觉、绘图、网络搜索及各类集成服务。阅读前说明本文对应版本为AIRI-0.12.0-beta.5主要讲解 Windows 桌面端与部分网页端的特性。需要留意以下几点说明书内容由社区参与者探索整理可能与实际版本存在偏差请以自己实际体验为准截图可能与当前版本不同步软件部分位置为英文且未提供翻译译文以实际界面为准版本更新可能改变部分内容若与实际界面不一致请自行对照最新版本处理。第一章 · 安装前往 Project AIRI 最新发行版页面在Assets中下载与设备对应的文件然后打开安装包并按提示完成安装。表中的版本号会随最新发行版变化以实际为准平台设备要下载的文件Windowsx64 或 Windows 11 ARM64AIRI-版本号-windows-x64-setup.exemacOSApple 芯片M 系列AIRI-版本号-darwin-arm64.dmgmacOSIntel 芯片AIRI-版本号-darwin-x64.dmgLinuxx64 Debian 系统例如 UbuntuAIRI-版本号-linux-amd64.debLinuxx64 RPM 系统例如 Fedora、openSUSEAIRI-版本号-linux-x86_64.rpmLinuxARM64 Debian 系统例如 UbuntuAIRI-版本号-linux-arm64.debLinuxARM64 RPM 系统例如 Fedora、openSUSEAIRI-版本号-linux-aarch64.rpmAndroid华为鸿蒙和其它安卓设备AIRI-版本号-android.apkiOS/iPadOSiPhone、iPadAIRI-版本号-ios.ipa各平台安装注意点Windows安装程序提供「为自己安装」和「为所有人安装」两种方式。为自己安装无需管理员权限但仅当前用户可访问为所有人安装需要管理员权限但此电脑上所有用户都可使用。iPhone、iPad目前仅提供 ipa 文件需要手动签名后安装暂不提供详细安装教程项目组未来会发布 TestFlight 应用测试链接。华为鸿蒙目前暂不提供原生鸿蒙软件若使用纯血鸿蒙系统请使用卓易通安装安卓版软件。第二章 · 初步配置开始使用 AIRI 前需要至少准备一个聊天服务商和可用模型。云端服务通常需要创建 API Key 或登录账号本地服务则需要先启动模型服务。按下面步骤完成初始化打开 AIRI进入初始化引导设置。选择您的语言。如果想使用自己的 AI 模型点击「配置您自己的 AI 服务来源」若想使用官方提供的 AI 模型点击「登录」。不确定选哪个服务商时建议从 AIRI 官方提供商、OpenRouter、OpenAI 兼容提供商 或本地的 Ollama 中选择一个进行配置。若使用自己的 AI 模型选中准备的服务来源点击「下一步」填入 API Key必要时可更改 base URL点击「下一步」再点击一次「下一步」选择打算使用的模型点击「保存并继续」。若使用官方提供的 AI 模型参考 AIRI 官方提供商 完成登录。完成以上步骤后AIRI 就能回复消息了。::: tip 只需先配置聊天 聊天服务商和模型配置成功后AIRI 就能回复消息。之后可以按需添加语音合成TTS、语音识别ASR/STT、视觉理解和艺术创作等能力可参考语音输入与输出、视觉理解或下文「绘图」一节了解如何配置。 :::::: warning API Key 安全 API Key、AccessKey Secret 和其他服务凭据只应保存在您的设备中不要提交到仓库、发到 Issue、截图或发送给他人。 :::关于聊天模型的配置细节可阅读配置聊天模型在「设置 → 服务商 → 聊天」选择服务商、填写 API Key、必要时填写 Base URL然后点击Ping API验证连通性再选择模型。若服务商不提供模型列表或 API Key 没有相应权限可以在「意识」页面手动输入与服务商文档完全一致的模型 ID。值得补充的是如果使用本地 Ollama 作为服务商需要保留默认 Base URLhttp://localhost:11434/v1/若 AIRI 显示网络或 CORS 错误可参考桌面版快速开始中的提示先设置系统环境变量OLLAMA_ORIGINS*再重启 Ollama详见 Ollama 配置页。第三章 · AIRI 界面介绍本章主要展示桌面端界面网页版/移动端可参考此部分其独有功能在文末「网页版特性补充」中介绍。 主窗口主窗口是展示虚拟角色形象的窗口共有五个选项「展开 ⌃」——点击可展开更多选项见下文。「打开聊天」——点击可打开聊天窗口。「听觉控制 ︎」——点击后可以与 AIRI 说话。点击后会打开「听力输入」面板先启用麦克风输入并选择麦克风若系统提示权限请求请允许 AIRI 使用麦克风配置语音识别服务后所说内容会被转写并发送到当前聊天会话。AIRI 正在说话时会暂停收音以避免把自己的语音再次识别进去。「扬声器」——暂略具体功能暂未测试。「移动 ✥」——鼠标左键长按并拖动即可改变主窗口在桌面上的位置。点击「展开 ⌃」后共有九个子选项「登录」——登录您自己的 AIRI 账号。「打开设置」——打开 AIRI 的设置界面。「切换角色」——切换角色卡。「刷新」——刷新主窗口。「移至屏幕中央」——将窗口移到屏幕中央。「切换到暗色模式」——切换界面背景为「亮 / 暗」。「取消置顶」——使人物模型不再保持置顶显示。「总是显示」/「悬停时隐藏」——使主窗口不影响鼠标光标对窗口下内容的点击从而不影响工作。「关闭」——一键关闭 AIRI。 系统托盘其他选项首先在任务栏找到 AIRI 的小图标。找不到时Windows 上可能需要在任务栏点击「显示隐藏的图标⌃」展开macOS 上图标可能隐藏在刘海后面尤其是 MacBook 内置显示屏可打开系统设置 → 菜单栏显示或隐藏菜单图标。右键小图标可以看到十个选项「显示」——召唤主窗口一般用不上。「调整大小」——调整主窗口大小并使其居中含四个子选项「推荐450x600」——设置为推荐大小「全高」——使主窗口的高占满桌面高「半高」——使主窗口的高为桌面高的一半「全屏」——使主窗口填满整个桌面。「对齐到」——对齐到桌面特定位置含「居中、左上、右上、左下、右下」五个子选项。「设置」——打开设置界面。「关于」——打开关于窗口可查看版本号、访问项目主页、更新 AIRI 并选择更新通道。「打开快速操作」——打开浮动输入框。输入给 AIRI 的简短请求后按 Enter窗口会隐藏并以通知显示处理结果按 Esc 取消。「打开小部件」——打开小部件窗口。地图、天气、艺术创作或扩展提供的小部件会显示在这里未运行相关工具或扩展时窗口可能为空。「打开字幕」——打开字幕。只有启用 TTS 服务才能在 AIRI 说话时显示出文字默认鼠标光标悬停时隐藏。「字幕浮窗」——含两个子选项「跟随窗口」默认选中字幕位置跟随主窗口移动取消选中则字幕位置独立和「重置位置」。「退出」——一键关闭 AIRI。 设置界面本节仅介绍设置界面里有什么具体功能介绍见第四章。可以通过两种方式打开设置界面在主窗口点击「展开」后选择「打开设置」或右键系统托盘小图标选择「设置」。设置界面包括九大内容「AIRI 角色卡」——选择和配置角色的人设。「机体模块」——配置 AIRI 的各种功能包括意识、发声、听觉、视觉、短期记忆、长期记忆、Discord、X / Twitter、网络搜索、我的世界、异星工厂、MCP 服务器、同步音律。「场景」——配置 AIRI 的场景背景。「角色模型」——选择和设置角色的模型。「记忆体」——功能暂未发布。「服务来源」——配置 LLM、TTS、STT、Artistry 服务的来源。「Data」——译为「数据」管理 AIRI 的各种数据。「连接」——配置您的 WebSocket 服务器地址。「系统」——含「通用」「配色方案」「窗口快捷方式」「开发者」四个子选项。 聊天窗口在主窗口点击「打开聊天」即可打开聊天窗口。在这里可以和 AIRI 聊天。启用语音合成后AIRI 正在朗读回复时输入区会出现「停止朗读」按钮点击它只会停止当前语音播放不会取消已经生成的文字回复。点击输入区左侧的「对话」按钮或点击聊天窗口标题可打开对话列表。列表按最近更新时间显示每段对话的预览与同步状态您可以切换、删除对话或为当前角色新建对话。删除后通常无法恢复请先确认不再需要其中的内容。第四章 · 设置 AIRI 角色卡在这里可以上传、创建或直接修改默认的角色卡。角色卡可以导入或导出为 AIRI 角色卡包。卡包使用 Character Card V3 数据并可选地附带 Live2D、Spine 或 VRM 显示模型。导入时 AIRI 会校验包内的清单和角色卡数据格式不正确或缺少必需文件的包无法导入。创建新角色卡建议按下面的顺序配置填写身份部分包括名字、昵称、描述、创建者笔记。根据需要填写行为部分包括角色性格、场景周围环境、背景、情境和问候语。根据需要调整模块部分为角色配置特定的机体模块。根据需要配置 Artistry 部分为角色配置生成图片的功能。最后检查设置部分包括系统提示词、历史提示指令和版本。确认内容无误后点击「保存更改」或「保存并激活」完成角色卡创建推荐直接点击后者可省略第 7 步直接生效。创建完成后点击角色卡右下角的圈或点击角色卡后再点击激活正式启用这个角色卡。其中身份部分最重要的是名字和描述名字即角色正式名称如果设定了昵称昵称会被优先使用描述即人设的具体细节可以自由发挥也可以参考默认角色卡。补充说明参考默认角色卡编写设定时后半部分关于 ACT 标签的内容可以不添加创建者笔记仅为角色卡片备注不会影响 AIRI 回复结果。行为部分用于补充性格、场景与问候语模块部分可为该角色指定聊天、视觉、语音和显示模型Artistry 部分设置图片生成偏好设置部分包含系统提示词、历史提示指令和版本信息。 机体模块在这里可以配置 AIRI 的各种功能。 意识可参考配置聊天模型进行配置。这是 AIRI 的「大脑」聊天模型配置成功后AIRI 才能生成文字回复。如果「服务商」保存了凭据但 AIRI 没有回复请回到意识页面确认同时选中了服务商和模型——仅保存服务商凭据不会自动启用它。 发声可参考语音输入与输出进行配置。如果不想让 AIRI 发声请选择「无」。补充说明先选择服务商和模型再选择该模型提供的音色不同服务商显示的字段会不同Pitch音调仅对支持该参数的服务商和模型生效。配置完成后可在发声页面输入一段测试文本并播放听到声音即表示配置成功。 听觉可参考语音输入与输出进行配置。如果暂不使用语音输入请选择「无」。名词解释STT是「语音转文本」Speech-to-Text的缩写也称自动语音识别ASR。它的目标是让计算机听懂人类的语音并将其转换成对应的文字。第一次在 macOS 上使用语音输入功能时需要进行一次性麦克风权限授权看到提示时请选择允许Allow否则功能无法正常使用。除此之外您还可以启用Auto-send transcribed text自动发送转录文本实现自动发送关闭该功能则可以调整转录结果后再手动发送通过Auto-send delay自动发送延迟调整发送延迟。如果您想测试麦克风在界面中间部分点击「start monitoring」开启监听必要时调整Sensitivity灵敏度。想测试 STT 功能在界面最下方点击「start speech-to-text」开始测试然后在Transcription Result下查看识别结果。 视觉可参考配置视觉进行配置。视觉模块会把捕获的画面发送给支持图像输入的模型。AIRI 不维护独立的视觉 API 凭据它为每个聊天服务商提供对应的视觉配置项并复用该服务商的字段如 API Key、Base URL、Azure 资源信息或 Amazon Bedrock Region因此需要先完成对应聊天服务商的配置。视觉服务商与聊天服务商一一对应且仍须在模型列表中选择明确支持图像输入的模型。::: warning 使用屏幕视觉前需要启动 Vision Capture 仅配置视觉服务商和模型时无需开启此工具。如需让 AIRI 分析屏幕或窗口请前往「系统 → 开发者 → Vision Capture」授予屏幕录制权限选择要捕获的窗口或显示器然后点击「Start ticker」。如需将识别结果提供给 AIRI 对话再开启「Publish to character」。Vision Capture 是当前的桌面端调试开发工作流离开该页面会停止捕获循环。完整步骤见桌面端开发者工具。 ::: 网络搜索请阅读网络搜索配置指南使用你自己的Tavily API Key在「设置 → 机体模块 → 网络搜索」开启「启用网络搜索」并粘贴 API Key出现「网络搜索已就绪」后即可返回聊天。启用后AIRI 会在合适的对话中自行调用搜索工具并在回答中附上实际使用的来源链接搜索词会被发送至 Tavily因此不要在搜索词中包含 API Key、密码等敏感信息。 绘图在这里可以为 AIRI 配置艺术创作的能力。可参考「配置 → 服务商 → 艺术创作服务商」了解如何配置并使用不同 AI 提供商创作作品。::: warning 请使用支持工具调用的聊天模型 艺术创作不是由角色直接生成图片AIRI 会向当前的聊天模型提供已配置图像服务的工具再由模型调用该工具提交生成任务。因此聊天模型和服务商必须支持Tool Calling / Function Calling工具函数调用。在「设置 → 意识Consciousness」中选择服务商后请选择该服务商明确标注支持工具调用的模型仅支持普通文本对话、或服务商未透传工具调用的模型可能只会文字回复、拒绝生成或完全不会向所选图像服务提交任务。配置后先让角色执行一次简单的图片请求确认 AIRI 已发起工具调用任务完成并返回图片后AIRI 才会显示结果。 ::: 短期记忆 / 长期记忆两个功能均正在开发中敬请期待如有实现该功能的想法欢迎通过 issues 或 PR 提出建议。 DiscordDiscord 集成需要从源码运行机器人服务才能让 AIRI 进入 Discord 服务器的消息和语音频道阅读 Discord 机器人集成指南在 Discord Developer Portal 创建应用和 Bot启用Server Members Intent与Message Content Intent并配置 Bot Token。在本地配置模型和语音服务凭据。从仓库根目录启动 Discord 机器人服务。按集成指南操作复制integrations/discord-bot/.env为.env.local填写DISCORD_TOKEN、DISCORD_BOT_CLIENT_ID及聊天模型与语音服务配置然后运行pnpm -F proj-airi/discord-bot start启动。::: warning 凭据安全 Discord Bot Token、模型 API Key 和语音服务凭据只应保存在本地配置文件中不要提交、截图或发送这些配置。 ::: X / Twitter请阅读 X / Twitter 集成指南在「设置 → 机体模块 → X / Twitter」启用集成分别填写 X Developer Platform 应用生成的 API Key、API Secret、Access Token 与 Access Token Secret 四项凭据并保存。注意「已配置」仅表示已保存凭据实际请求结果仍取决于应用权限、账号状态、访问套餐和速率限制。不要公开 API Key、API Secret 或访问令牌。 我的世界 MinecraftMinecraft 集成需要从源码运行本地智能体服务。请按照 Minecraft 智能体集成指南 配置受信任的服务器、AIRI 和模型服务然后启动智能体。集成通过 Mineflayer 连接 AIRI 与 Minecraft 服务器让智能体接收上下文、执行游戏内动作并回传状态它面向本地开发和维护当前实现正计划迁移到 Fabric 运行时。按集成指南操作复制integrations/minecraft/.env为.env.local填写 Minecraft 服务器、AIRI 与模型服务所需的配置。在桌面版「设置 → 连接」显示并复制Auth Token然后添加如下 AIRI 通道配置AIRI_WS_BASEURLws://localhost:6121/ws AIRI_CLIENT_NAMEminecraft-bot AIRI_WS_TOKENAuth Token from Settings → Connection主要字段还包括OPENAI_API_BASEURL服务商 API 根地址如https://api.deepseek.com注意不要加chat/completions后缀、OPENAI_API_KEY、OPENAI_MODEL默认模型 ID、OPENAI_REASONING_MODEL思考模型 ID、BOT_USERNAME、BOT_HOSTNAME、BOT_PORT一般 25565和BOT_VERSIONMinecraft 版本号。默认离线登录如需正版登录参考integrations/minecraft/.env中的说明。最后运行pnpm -F proj-airi/minecraft-bot dev启动在游戏中发送文字即可与 AIRI 交互。::: warning 安全提醒 不要将 Minecraft 智能体连接到不受信任的公共服务器。它会驱动本地 Minecraft 会话和网络连接恶意服务器可能造成非预期行为。 ::: 异星工厂 Factorio请阅读异星工厂集成指南在「设置 → 机体模块 → 异星工厂Factorio」启用集成填写受信任服务器的地址、端口默认34197和游戏内用户名并保存。页面显示「已配置」仅代表三个字段已填写AIRI 不随附可直接部署的 Factorio 服务端集成是否能够实际连接取决于服务器和配套的服务端集成。 MCP 集成MCPModel Context Protocol让 AIRI 通过本地进程使用外部工具。在桌面端打开此页后可以添加服务器填写其命令、参数和环境变量先运行连接测试再点击「应用并重启」启动或重启 MCP 服务也可以打开配置文件或使用 JSON 编辑器批量维护配置。仅运行您信任的 MCP 服务器它们可在本机执行命令并访问您授予的环境变量。 同步音律同步音律会从屏幕捕获的音频分析节拍并将节拍信号发送给舞台效果。点击「开始屏幕捕获」后选择包含音频的屏幕或窗口可用「停止」结束捕获。页面提供灵敏度、最小节拍间隔及高级滤波参数并显示实时频谱和节拍可视化。首次使用可能需要授予系统屏幕录制权限。 场景Scenes在这里可以配置 AIRI 主界面的场景——可以简单理解为 AIRI 主界面的背景。包含两个预设点击其中一个预设中间的对勾鼠标光标移动上去才会显现即可启用场景点击「上传到场景库」可以导入自己的图片场景需要清除场景时点击「清除默认」。 角色模型在这里可以选择和设置角色的模型。AIRI 支持Live2D、VRM 3D、Spine 2D、MMD 和 Tachie五种模型。如果想切换现有模型点击「选择模型」打开模型选择界面当前版本默认可以看到两个 Live2D 模型和两个 VRM 3D 模型选中一个模型后点击「确认」完成切换。如果想导入自己的模型点击「导入」选择 Live2D、VRM、Spine、MMD 或 Tachie 格式。::: info Godot Stage实验性 「Switch to Godot Stage (Experimental)」会启动独立的 Godot 舞台渲染器再次点击「Back to Built-in Stage」可切回内置舞台。Godot Stage 目前只支持 VRM 模型。启动并选定 VRM 后可以在 Godot View 中调整相机 X/Y/Z、偏航、俯仰和视野角状态或模型加载错误会显示在该区域。 :::::: warning 导入模型前请注意旧版 Live2D 模型可能不被支持请尽量选择包括「*.moc3」的文件。导入 Live2D 模型前需要先将「模型文件夹」压缩为「*.zip」文件。Spine 模型也需要以「*.zip」导入VRM 使用单个「*.vrm」文件。 ::: 如果您选择的是 Live2D 模型按下面的顺序调整展开「缩放与位置」调整模型在主窗口中的大小和位置x 为横轴左右位置y 为纵轴上下位置。展开「动画」可以设置动作驱动器包含通用和 MAGIC 两种、鼠标跟踪、空闲眼部动作、眨眼及模式、空闲动画。选择 MAGIC 驱动器时还可以选择配置包括空闲/平静和说话/兴奋两种内置配置、是否忽略生成的嘴部开合、强制视线朝前。注意MAGIC 驱动在展示模型全身时会出现整个模型上下晃动的情况这是开发者参考 neuro 以及 vts 的工作逻辑后设定的正常情况推荐启用 MAGIC 驱动时仅展示模型的半身。展开「模型参数」可以设置渲染缩放、帧率FPS、投影、重置为默认参数、清除模型缓存以及模型涉及的各种参数。如果想要设置待机动画请确保模型压缩包中包含动画文件。如果还需要表情功能可以再展开「表情」启用「表情系统」。启用语音合成时AIRI 会在朗读结束后自动恢复 Live2D 的嘴部状态。模型可用的参数、待机动画和表情由模型文件本身决定启用表情系统后只会显示该模型实际提供的表情若没有表情或动画文件对应选项不会产生效果。 如果您选择的是 Spine 2D 模型Spine 模型提供独立的设置面板可以调整缩放、X/Y 位置、皮肤、变体、待机动画、动画混合时间和播放速度也可以限制帧率与调整渲染比例。若模型包含可用的皮肤、变体或动画它们会出现在对应下拉选项中缺少的资源不会显示。 如果您选择的是 VRM 3D 模型先展开「场景」然后设置 Model Position模型位置、视角调整度、相机距离画面缩放、模型朝向Y 轴旋转、模型注视方向等内容。内置舞台中的位置、旋转、相机距离与注视方向会保存到当前设置。 记忆体功能暂未发布如有实现想法欢迎通过 issues 或 PR 提出建议。 服务来源「服务来源」是 AIRI 连接模型和语音能力的入口。先在这里保存服务商凭据再到对应功能页面选择服务商及模型。可以按用途选择分类聊天配置让 AIRI 回复消息的 LLM这是开始使用 AIRI 的必要配置。视觉让 AIRI 能看见图片。语音合成TTS让 AIRI 朗读回复随后在「机体模块 → 发声」中选择模型和音色。语音识别ASR/STT把麦克风语音转换为文字随后在「机体模块 → 听觉」中选择模型。艺术创作配置图片生成服务随后在「机体模块 → Artistry」中使用。如果跳过了初始化配置引导建议先完成聊天服务商的配置选择服务商填写 API Key 或登录账号如服务商要求再填写 Base URL、区域等高级字段然后使用Ping API验证连通性。验证后进入「机体模块 → 意识」选择服务商和模型并发送一条消息确认 AIRI 能回复。注意切换聊天服务商后原先选择的聊天模型会被清空需要回到「机体模块 → 意识」为新服务商重新选择模型。服务商配置涉及的关键字段可参考通用配置说明字段含义填写建议API Key服务商签发的访问令牌直接粘贴完整密钥不要添加引号或空格。Base URL服务商 API 的根地址仅在服务商文档要求时修改填写完整的https://或http://地址。模型聊天、语音或识别所使用的模型 ID优先从 AIRI 的列表中选择列表加载失败再按服务商文档手动填写。音色TTS 朗读时使用的 voice ID先选择模型再选择该模型支持的音色。区域部分云服务用于确定接入节点必须与服务商控制台中的项目或服务区域一致。验证失败时按以下顺序排查确认账户已开通对应服务且有可用额度重新复制 API Key检查是否有多余空格或换行将 Base URL 恢复为服务商默认值或与服务商官方文档逐字核对确认网络、代理和防火墙允许访问选择服务商明确支持的模型不要把展示名称当作模型 ID。配置提示不确定服务商的字段、验证方式或报错含义时阅读通用配置说明。配置聊天模型阅读配置聊天模型可在「配置 → 服务商 → 聊天服务商」中了解如何配置不同聊天提供商。配置语音输入输出阅读语音输入与输出语音合成、语音识别和艺术创作服务商也分别位于侧栏「服务商」菜单中。视觉理解使用与聊天服务商相同的凭据并须选择支持图像输入的聊天模型详情见配置视觉。技术性建议服务商列表以 AIRI 当前版本为准。若服务商不在列表里但支持 OpenAI 兼容接口可使用OpenAI 兼容 API配置Base URL 和模型 ID 必须按照该服务商的官方文档填写仅 API 地址以/v1结尾或密钥以sk-开头不能保证服务兼容。 数据Data在这里可以管理 AIRI 的各种数据。::: warning 不可恢复操作 该部分可以删除或清理相关数据而且无法恢复请谨慎操作。在执行删除和重置操作前建议再确认一遍内容。 :::「打开应用数据文件夹」和「重置桌面设置和状态」仅在桌面版可用网页/移动版 App 不可用。 连接「连接」用于配置 AIRI 的服务通道。可以设置 WebSocket 地址并在需要加密传输时启用 TLS。桌面端还可选择仅本机访问、允许局域网访问或填写高级主机名暂不可用并设置访问令牌页面会提供二维码方便其他设备连接。仅在受信任的网络中开放局域网访问并妥善保管访问令牌。::: tip macOS 可能需要管理员验证 启用安全 WebSocket 时AIRI 会将本地证书加入 macOS 登录钥匙串系统可能要求使用 Touch ID 或输入 Mac 登录密码授权此操作。验证指纹或登录密码以继续。 ::: 系统 通用在这里可以设置程序主题、语言等内容主题选项默认亮色点击后面的按钮可以切换到暗色模式。语言选项可以设置界面语言选择会在重启 AIRI 后保留。控制岛图标大小选项可以更改主窗口右下角三个按键的大小。最后可以设置是否允许收集使用数据及崩溃分析或阅读隐私政策点击「隐私政策」打开。 配色方案在这里可以更改主题颜色启动 RGB 选项使主题颜色像 RGB 灯带那样自动变化。拖动下方的黑线或在彩色条中点击来更改主题颜色。其下方是颜色效果预览。也可以直接选择下方的预设来改变主题颜色。::: tip 颜色预设 选择颜色预设时应该点击任意一个圆而不是点击方框。 ::: 窗口快捷方式在这里可以修改Spotlight全局快捷键。Spotlight 是「打开快速操作」所使用的浮动输入框点击当前快捷键。按下想使用的新组合键必须包含 Cmd、Ctrl、Alt 或 Super 中至少一个修饰键。若快捷键已被其他应用占用AIRI 会提示冲突按 Esc 取消录制。点击「重置」可恢复默认快捷键。使用 Spotlight按下已设置的快捷键会打开快速操作输入框输入请求后按 Enter 发送给 AIRI按 Esc 关闭。 开发者此页面用于开发、排障和验证实验功能普通用户不需要操作。完整的工具说明见桌面端开发者工具。该页面提供按问题类型选择工具的参考例如页面报错或网络请求用「开发者工具」聊天上下文与 WebSocket 用 Context Flow、WebSocket Inspector插件加载问题用 Plugin Host Debug屏幕视觉输入用 Vision Capture依次完成在「设置 → 服务商 → 视觉」选好视觉服务商和支持图像输入的模型 → 打开「系统 → 开发者 → Vision Capture」并完成屏幕录制授权 → 选择窗口或显示器后点击「Start ticker」→ 需要时将识别结果加入对话上下文时开启「Publish to character」→ 测试完成后点击「Stop ticker」全局快捷键验证用 Global Shortcut。网页版特性补充 网页版主界面在网页版可以看到角色模型并直接与之对话。大体上分为三个部分角色模型空间、聊天框、其他。 聊天框聊天框分为上下两部分上半部分是显示和记录聊天记录的区域下半部分是输入框可以打字与角色对话。输入框下方有两个按钮发送方式选择通过什么方式确认发送消息和开启语音输入。 其他部分上方区域包括三个选项关于、角色卡、账号及设置。第三个选项中包含账号信息、档案/Flux/设置、登出三块内容。档案登录 AIRI 后可以管理账号信息查看并修改显示名称管理密码和已关联的登录方式例如 GitHub、Google也可以在危险操作区注销或删除账号。头像当前由账号资料显示暂不支持上传新头像。FluxFlux 是 AIRI 官方服务使用的余额单位。登录后可查看当前余额、使用统计和流水记录在开放购买的地区或版本中还可选择套餐并进入结算。使用官方聊天、视觉或语音服务时相关请求可能消耗 Flux第三方服务商的费用仍由该服务商单独结算。参考AIRI 官方提供商每个新账户有 150 电量每次对话会消耗部分电量目前仅支持在 AIRI 网页版充值桌面版暂不支持直接充值。设置同桌面端设置详见上文第四章。下方区域包括六个选项对话、静音语音、位置及大小、删除聊天记录、切换亮暗、背景。对话在这里管理对话。请注意不同对话之间相互独立。静音语音暂略。位置及大小点击后会在选项左边出现三个新选项 x、y、scale 以及网页界面左边竖着的条。x 即模型 x 轴位置y 即模型 y 轴位置scale 即模型缩放大小可以通过点击并拖动网页界面左边竖着的条来调整这三个参数。删除聊天记录点击即可一键清除全部聊天记录。::: warning 谨慎操作 点击删除无法恢复请谨慎操作 :::切换亮暗可以切换界面「亮色」或「暗色」。背景可以更改主界面的背景。历史特性 常见问题 常见问题从早期版本升级后如果曾经改动过模型的大小和位置模型可能会「消失」。遇到该问题时请在模型设置界面重置模型的缩放和位置。 特性 H3-1-1在过去的其中几个版本中主窗口右上角还可以看到「websocket 状态」选项位于右上角点击可打开连接设置在这里可以配置 WebSocket 服务器地址。 特性 H4-1-1在之前的版本中创建完角色卡后必须手动激活现在推荐直接使用「保存并激活」一键生效。总结至此您已经掌握了 Project AIRI 从安装、初步配置到日常使用的完整路径先通过发行版安装包完成安装再在初始化引导中配置聊天服务商与模型随后熟悉主窗口、系统托盘、聊天窗口和设置界面九大板块最后按需为角色配置机体模块意识、发声、听觉、视觉、绘图、网络搜索及各平台集成、导入与微调角色模型、管理服务来源与数据、设置连接与系统偏好并可在网页版使用档案、Flux 等账号能力。遇到升级后模型「消失」等问题时可参考「常见问题」小节解决。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐Project AIRI 使用手册安装、初始配置与桌面端全功能设置指南Project AIRI 使用手册安装、初始配置与桌面端全功能设置指南 导读 本篇技术指南基于 docs/content/en/docs/manual/tam人工智能AI 应用大模型AI Agent交互助手语音数字人后端前端桌面应用移动开发GUI 自动化MCP 服务AIRI 桌面端与网页端使用手册安装、初始配置、界面操作与全量设置指南AIRI 桌面端与网页端使用手册安装、初始配置、界面操作与全量设置指南 本文依据仓库中的官方说明书 韩文版 https://link.gitcode.com人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端Project AIRI 桌面版配置指南主题配色、显示模型切换与 Live2D/VRM 模型导入Project AIRI 桌面版配置指南主题配色、显示模型切换与 Live2D/VRM 模型导入 本指南聚焦 Project AIRI自托管 AI 伴侣桌人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端上一篇vscode-generator-code高级技巧自定义扩展模板开发指南下一篇Sunshine 完整指南如何用 Moonlight 快速跑通第一路游戏串流创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考