企业官网建设流程全解析

AIRI 开源AI伴侣部署指南：15分钟完成首次语音对话与Minecraft陪玩

【免费下载链接】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 伴侣。按这篇部署指南操作，你部署完会得到一个能进行实时语音对话、还能陪你进 Minecraft 打怪建家的伙伴，数据和配置都掌握在你手里。

三分钟第一次对话：AIRI Web 版三步走

Web 版是验证"它到底能不能用"最快的路径：不用装任何环境，也不用管依赖版本，三分钟看到角色回你第一句话，就说明模型链路已经通了，后面所有工作都只是加功能。这条路只覆盖浏览器，桌面端和容器化在后面单独讲。

1. 用浏览器打开 AIRI 网页版（官方 README 里有在线演示入口；如果你已经自己跑起来了，直接开终端提示的本地地址），首页点击"开始吧"进入模型配置页。
2. 在服务商选择页挑一个你熟悉的大模型服务，填入 API 密钥；如果选的是"OpenAI 兼容"站点，还要补一行 Base URL（也就是那家服务商 API 的访问地址）。
3. 从模型列表里选一个非思考模型——带思考链的模型每句话都要先"想一想"，响应明显变慢，会影响后面的语音对话体验。然后在输入框发出你的第一句话。

按你的设备选部署路线：从浏览器到 Docker 挑一条

跑通网页版之后，下一个问题是程序放在哪里。同一套代码拆成了网页（apps/stage-web）、桌面（apps/stage-tamagotchi）、移动端（apps/stage-pocket）几个形态，对普通用户最有用的是前两者。下面按设备各给一条最短路线，选一条即可，不要全装。

浏览器：打开即用或本地起一份

如果你只是想体验功能、不想管环境，停在网页版就够了；想自己掌控一份（也顺便熟悉源码结构），就在仓库根目录起开发服务器，pnpm dev启动的正是 Web 版：

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

Windows：一条 winget 命令

终端里执行winget install MoeruAI.AIRI，或者去官方 release 页下载安装包。想本地跑模型、要显卡加速或者准备玩游戏的，选桌面版。

macOS：用 Homebrew 装

brew install --cask airi

装完直接打开应用即可，桌面版默认能调用 Apple Metal 做本地推理，比网页版能干的事多。

Linux：AppImage 直接跑

从官方 release 页下载 AppImage，双击即可运行，不需要额外装运行时。如果你的机器没有图形界面（比如一台常开的服务器），就别走这条路，直接看下一段。

AIRI Docker 部署：两条命令出一个容器

容器就是把程序和它的运行环境打包成一个镜像，任何装了 Docker 的机器都能原样跑起来。AIRI 的镜像由apps/stage-web/Dockerfile构建，包含网页版和文档，容器内用 nginx 监听 80 端口，所以宿主机映射到 3000 即可：

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

跑起来后浏览器访问localhost:3000。这种路线适合"给家里局域网或一台小服务器部署一份，多台设备共用"的场景。

从 API 密钥到第一句对话：补齐三处配置

密钥是"大脑"的燃料，后面三处配置则决定这个角色的"人设"。没有密钥她不会开口，没有角色卡她只是一个通用助手——所以这一步值得慢一点，把每处的作用搞明白，后面调性格、换模型心里才有数。模型选择、角色卡这些都作用在 AI 核心源码 描述的推理与角色层上。

先选服务商和拿 key。AIRI 支持 OpenAI、Claude、DeepSeek、Google Gemini、Ollama（本地模型，无需 key）等二十多家，完整清单见服务商配置文档。Key 都去各家官方控制台或开放平台的应用管理页领取，复制后填进 AIRI 对应的服务商配置项。

第一处：模型选择。它决定回复质量的天花板，建议选响应快的非思考模型；同一张角色卡下也可以给不同机体模块绑不同模型，先拿一个主力模型跑通再说。

第二处：语气与记忆。角色卡（Character Card）是描述角色名称、性格、说话方式的一组提示词，相当于人设说明书；记忆则靠上下文窗口和内置的浏览器端数据库维持，切换角色卡会整套切换人设和模型。

第三处：角色名称与形象。在舞台（Stage）上挑选内置的 VRM 或 Live2D 模型，首页右上角可以切换角色卡与形象，名称和人设都跟着角色卡走。

让伙伴真正用起来：语音、游戏与接入渠道三条路

到这一步 AIRI 已经能打字聊天了，但"真正用起来"意味着她要有声音、能陪你打游戏、还能住进你常待的聊天软件里。这三条路互相独立、可以各开各的，建议先开语音，再碰游戏。

AIRI 语音对话：让她开口，也让她听见你

语音分两半：语音合成（TTS，把文字变成声音）和语音识别（ASR，把你的话变成文字），两者可以只配一边。配好后你得到的是一次不用打字的自然对话——她说给你听，你直接对她讲。开启方式：设置 → 服务商 → 语音合成里填入凭据，再到"发声"页选模型和音色、播放测试文本；"听觉"页同理配置识别服务并选麦克风。注意内置的 Kokoro TTS 不支持中文，中文用户要另加一家服务商，详见语音配置文档。

AIRI 游戏互动：陪她玩 Minecraft 和 Factorio

游戏互动是 AIRI 区别于普通聊天机器人的地方：Minecraft 这条线已经可用，她会通过 Mineflayer 连进服务器接收上下文、执行游戏内动作；Factorio 方向有独立的 airi-factorio 子项目，目前处于 PoC 阶段，能帮你盯着工厂流水线。开启方式在仓库的 integrations 目录：把模板复制成本地配置，填上你的服务器地址再启动：

cp integrations/minecraft/.env integrations/minecraft/.env.local pnpm -F @proj-airi/minecraft-bot dev

安全提醒只有一条：只连你自己搭建或完全信任的服务器，别连来路不明的公共服。更多细节看Minecraft 集成文档。

插件生态：把角色拉进 Discord 和 Telegram

这两条渠道的作用是让角色离开 AIRI 主界面、住进你日常聊天里：Discord 里她能接消息、进语音频道，Telegram 里你能随时 @ 她。开启方式：在 Discord 开发者控制台创建应用和 Bot、开启 Server Members 与 Message Content 权限，把 Token 等凭据存进integrations/discord-bot/.env.local，然后pnpm -F @proj-airi/discord-bot start；Telegram 同样在 integrations 目录下配置。步骤细节分别见Discord 机器人文档和Telegram 机器人文档。

踩坑速查：出问题先对号入座

新手第一周遇到的问题九成在下面这六类里。每一条都按"现象 → 原因 → 一句话解法"写，先对现象再动手。

• 该说话时没有声音→ "发声"页的服务商、模型、音色三样缺一样，或只用了不支持中文的内置 Kokoro → 换一家支持中文的 TTS 服务商并在测试区放一段试听。
• 语音输入没有文字出来→ 麦克风权限没给，或选错了输入设备 → 在系统/浏览器授权后，回"听觉"页选对麦克风再说一句短句。
• 回复明显慢半拍→ 选了带思考链的模型 → 换成非思考模型，流畅度立竿见影。
• 密钥被拒，报 401 一类错误→ key 抄错、余额为零，或 OpenAI 兼容站点漏填 Base URL → 重新粘贴密钥并补齐 Base URL，两家都查一遍。
• 启动时提示端口被占用→ Docker 映射的 80/3000 或开发端口已被别的进程占掉 → 换一个空闲端口，-p 3001:80这类写法即可。
• 浏览器里 3D 形象不显示或卡顿→ 浏览器的 GPU 链路没走通 → 换支持 WebGPU 的新版浏览器，或直接上桌面版走本地 CUDA/Metal。

收个尾：先跑网页版，再谈自托管

建议你先按"三分钟"那节的三步把网页版跑通，顺手把模型、角色卡和形象都摸一遍，这一步不花钱不装环境。上手之后再挑桌面版或 Docker 路线自托管一份，按需打开语音和游戏开关。哪一步卡住了，先翻仓库里官方文档的中文手册和 integrations 目录，上面这些坑基本都有对应页面。

【免费下载链接】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