企业官网建设流程全解析

如何拥有一个实时语音、能陪玩的 AI 虚拟伴侣：AIRI 自托管部署与使用全解

【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi

AIRI 是一个完全开源、可自托管的 AI 虚拟伴侣项目：它会说话、能听你语音、支持 VRM / Live2D 形象，还能真正进 Minecraft 和你一起打怪、在 Discord 和 Telegram 里陪聊。因为部署在你自己的设备或服务器上，对话记录、角色设定和 API 密钥都由你自己掌控，不依赖任何第三方账号体系。下面按"先跑起来，再逐个解锁功能"的顺序，带你从零走到一个可以语音对话的 AI 伴侣。

一个不止于聊天的 AI 伴侣

市面上"接入大模型 API 就能聊"的网页应用很多，AIRI 的差别在于它是一个完整的运行平台：浏览器、Windows、macOS、移动端都支持，内置实时语音识别与合成管线，桌面版还能调用本地 GPU（NVIDIA CUDA、Apple Metal）做推理。更特别的是它的"动手能力"——项目内置了 Minecraft 机器人服务，可以帮你收集材料、盖房子；Factorio 玩法也有专门的配套实现。

它的设计思路接近 Neuro-sama：一个能看、能听、能玩、能聊的"赛博生命"，但 AIRI 把这套能力完全开源，让你在自己机器上就能复刻。

跑起来：三条上手路径按你的环境选

AIRI 用 pnpm 管理 monorepo，克隆仓库后先执行pnpm install。之后根据你的环境选一条路径：

在浏览器里先试水

只想感受效果的读者，启动 Web 版开发服务器即可，pnpm dev默认拉起的 apps/stage-web/ 就是浏览器版：

git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi pnpm install pnpm dev

浏览器版基于 WebGPU、WebAudio、Web Worker 等技术构建，适合作为第一个体验入口，也能帮开发者快速验证功能边界。

把桌面版装到系统里

桌面版（stage-tamagotchi）功能最全，支持窗口模式、系统托盘、本地 GPU 加速。各大平台都有一键安装渠道：

• Windows：winget install MoeruAI.AIRI或 Scoop（scoop bucket add airi后scoop install airi/airi）
• macOS：brew install --cask airi
• Linux：从 Releases 页面下载 AppImage / Snap 包

如果你是开发者，也可以从源码启动桌面版：pnpm dev:tamagotchi。

用 Docker 构建一个可长期运行的 Web 服务

想在服务器上长期跑一个"随时打开网页就能聊"的实例，项目自带 apps/stage-web/Dockerfile。构建过程会编译 Web 版、文档站和 UI 组件库，最终打包进 nginx 镜像：

docker build -t airi-web -f apps/stage-web/Dockerfile . docker run -d -p 3000:80 --name airi airi-web

容器对外暴露 80 端口，映射到本机 3000 即可访问。注意：AIRI 的大模型能力来自你在界面里配置的 API 密钥，而不是环境变量——容器只负责托管前端与文档。

第一次对话：从启动向导到接入大模型

无论哪种方式启动，首次进入都会看到 "Welcome to AIRI" 引导页，提示你设置第一个 AI 服务商。点 "Let's do it!" 后按界面指引填入密钥即可。

AIRI 通过内置的 xsai 层统一接入大模型，官方支持的提供商超过 30 家，常见的包括：OpenAI、Anthropic Claude、DeepSeek、Google Gemini、xAI、Groq、Mistral，以及本地方案Ollama 和 vLLM（意味着可以完全离线运行）。完整清单可以在文档里按厂商逐页查看：

• 中文文档：docs/content/zh-Hans/docs/
• 各服务商配置说明：docs/content/zh-Hans/docs/manual/config/providers/

选好模型后，你可以在角色设定中定义 TA 的名字、性格、说话方式——本质上是提示词工程，写一段人物小传即可。角色卡模板放在 docs/content/zh-Hans/docs/manual/tamagotchi/character-card-template.md。

让 TA 开口说话：实时语音链路怎么配置

AIRI 的语音由三段管线组成，都支持在设置面板里独立选择厂商：

• 耳朵（ASR）：客户端侧语音识别，把麦克风输入转成文字，支持多种语言
• 触发（VAD）：客户端说话检测，决定什么时候轮到 TA 回话
• 嘴巴（TTS）：多厂商语音合成，包括 ElevenLabs、Microsoft/Azure Speech、OpenAI 兼容接口、阿里云模型，以及本地 Kokoro TTS——本地方案不依赖网络，隐私也更好

配置入口在设置页的 speech / transcription 分区，文档逐厂商给了配置示例：

• TTS 配置：docs/content/zh-Hans/docs/manual/config/providers/speech/
• 语音总览：docs/content/zh-Hans/docs/manual/config/audio.md

从聊天到游戏：Minecraft、多平台与记忆

AIRI 最有意思的部分在聊天之外：

• Minecraft 陪玩：integrations/minecraft/ 内置了一个四层认知架构的机器人（感知 → 反射 → 意识 → 行动），LLM 负责规划"盖房子"这类任务，再拆成收集木材、合成木板、建造墙体等动作逐步执行。配置.env.local后运行pnpm -F @proj-airi/minecraft-bot dev即可连接服务器。官方提醒：只把它连到你信任的本地/私人服务器
• Factorio：有独立的 airi-factorio 子项目在推进工厂自动化玩法
• 社交平台聊天：Discord 语音/文字频道（integrations/discord-bot/）、Telegram 机器人（integrations/telegram-bot/）都有现成实现，让 TA 的陪伴不限于一台电脑
• 记忆：浏览器内嵌 DuckDB WASM 数据库，为长期记忆打基础，相关实现在 packages/drizzle-duckdb-wasm/ 与 packages/memory-pgvector/
• 形象：支持 VRM 与 Live2D 模型，自动眨眼、视线跟随、待机眼动都有；渲染层在 packages/stage-ui-three/ 和 packages/stage-ui-live2d/

桌面版还支持"窗口模式"等玩法——把 TA 做成桌面上一个可拖动、可缩放、鼠标悬停可淡入淡出的小窗口，工作时就在屏幕角落陪着：

移动端则由 apps/stage-pocket/ 基于 Capacitor 打包，iOS / Android 均可安装：

卡住了？对照这份排错清单

• 首次启动没有声音：确认浏览器已授予麦克风权限；桌面版检查系统默认音频输入/输出设备
• API 请求失败：核对密钥、Base URL 与模型名三件套；本地部署 Ollama/vLLM 时确认服务已在localhost监听
• 语音响应慢或断断续续：把 TTS 换成延迟更低的厂商，或改用本地 Kokoro；嘈杂环境下先开启 VAD 灵敏度调节
• Minecraft 机器人连不上：检查.env.local中服务器地址与端口；该服务只建议用于可信服务器
• 桌面版性能不佳：优先确认显卡驱动已启用 CUDA / Metal 加速，浏览器版遇到复杂场景可切到桌面版

继续深入：文档与源码入口

想自己动手改点什么，这些目录是最好的起点：

• 官方文档总入口：docs/README.zh-CN.md
• AI 核心与角色系统：packages/core-agent/、packages/core-character/
• 语音管线：packages/pipelines-audio/、packages/audio/
• 桌面版应用：apps/stage-tamagotchi/，Web 版：apps/stage-web/
• 服务端（API / 认证 / 数据库）：server/

AIRI 目前仍处于快速迭代阶段，桌面版与 Godot 渲染引擎等新方向都在持续推进。从浏览器里的一次pnpm dev开始，先让 TA 开口说话，再逐步解锁语音、游戏和多平台——这就是拥有自己 AI 伴侣的完整路径。

【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi