为 AIRI 接入 AI 大脑OpenAI、Claude、Ollama、DeepSeek 等 20 大模型配置指南【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址: https://gitcode.com/moeru-ai/airiAIRIMoeru AI / airi是一个自托管、完全归你拥有的 Grok 风格 AI 伴侣与 waifu「灵魂容器」目标是接近 Neuro-sama 的体验支持实时语音聊天、玩 Minecraft 和 Factorio可在 Web / macOS / Windows 上运行。而让这位 AI 伴侣真正「活起来」的第一步就是为 AIRI 接入大模型——本文带你用最少的步骤完成OpenAI、Claude、Ollama、DeepSeek等 20 大模型的配置让你的 AI 伴侣拥有自己的「大脑」。AIRI 大模型是干什么的为什么先配置聊天模型在 AIRI 的架构里大模型LLM是 AI 伴侣的「意识」核心文字回复你说的话经过 ASR语音识别转成文字后由大模型生成回复实时语音聊天大模型的回复再经 TTS语音合成变成 AIRI 的声音场景玩法Minecraft、Factorio 等玩法也依赖大模型做决策。所以「配置聊天服务商 选择模型」是 AIRI 新手指南里排在最前面的官方步骤官方手册称为配置聊天模型。一口气看全AIRI 支持哪些大模型服务商打开设置 → 服务商 → 聊天你就能看到侧栏「服务商 → 聊天服务商」中的完整清单。AIRI 内置了 20 多家服务商主流选择如下分类服务商适合人群国际主力OpenAI、AnthropicClaude、Google Gemini、xAI已有海外 API Key 的用户高性价比DeepSeek、MoonshotKimi、MiniMax、智谱、字节火山引擎中文场景、追求性价比聚合平台OpenRouter、AIHubMix、AtlasCloud一个 Key 用多家模型高速推理Groq、Cerebras、Together、Fireworks、Mistral、NVIDIA在意响应速度本地运行Ollama、LM Studio隐私优先、不想付 API 费用云厂商Amazon Bedrock、Azure OpenAI、Azure AI Foundry、Cloudflare Workers AI企业级部署这些服务商的前端定义统一注册在 providers/registry.ts每家服务商的接入代码都在 providers/ 目录 下每种服务商还配有独立的官方配置文档位于 docs/content/zh-Hans/docs/manual/config/providers/consciousness/ 目录共 37 份指南可按需查阅。三步通用配置流程API Key → Ping → 选模型无论选哪家云端服务商配置流程都遵循同一套三步走获取 API Key登录服务商控制台创建并复制 API Key注意保密不要泄露填入 AIRI打开设置 → 服务商 → 聊天选择服务商粘贴 API Key一般无需修改默认 Base URL验证并选模型点击Ping API测试连通性与密钥是否正确成功后点击选择模型拉取模型列表并选中。 配置完服务商凭据后还需要在设置 → 意识页面同时选中「服务商 模型」才会真正生效——这是新手最容易漏掉的一步。OpenAI 与 DeepSeekOpenAI 兼容 API 一键配置DeepSeek、OpenAI 等服务商的聊天接口都是 OpenAI 格式AIRI 为它们做了专门入口OpenAI进入设置 → 服务商 → 聊天 → OpenAI粘贴 API Key保留默认 Base URLhttps://api.openai.com/v1Ping 后选模型即可DeepSeek进入DeepSeek入口粘贴 API Key默认地址为https://api.deepseek.com/v1其余步骤相同其他兼容服务如果你的服务商明确提供「OpenAI 兼容」的聊天接口如部分聚合平台可改用OpenAI 兼容 API入口并填写服务商文档给出的根地址不要带/chat/completions后缀。详细步骤与排查方法可参考官方文档OpenAI 与兼容 API 配置指南DeepSeek 配置指南Ollama 本地大模型免费、离线、数据不出门如果你希望AI 对话数据完全留在自己设备上Ollama 是最省心的选择——开源本地大模型框架默认无需 API Key安装 Ollama 后用终端确认ollama --version下载并启动一个模型例如ollama run qwen2在 AIRI 中打开设置 → 服务商 → 聊天 → Ollama保留默认 Base URLhttp://localhost:11434/v1/Ping API通过后选择刚下载的模型。两个常见坑AIRI 与 Ollama不在同一台设备时请填写局域网地址仅在可信网络中开放出现 CORS 报错时需要为 Ollama 设置OLLAMA_ORIGINS允许 AIRI 的来源访问不要把本地服务直接暴露到公网。更完整的步骤与排查见 Ollama 配置指南偏好图形界面的用户也可查看 LM Studio 配置指南。ClaudeAnthropic配置要点使用 Claude 时在设置 → 服务商 → 聊天 → Anthropic中填入 Anthropic API Key 即可官方入口已预设好 Base URL。Ping 成功后在模型列表中选择 Claude 系列模型再到「意识」页面启用。完整步骤与常见问题可参考 Anthropic 配置指南。验证大模型是否生效发送第一条消息配置全部完成后回到聊天界面发一条简短消息例如「你好」✅ 收到文字回复 → 大脑已成功接入❌ 没有回复 → 检查「意识」页面是否同时选中了服务商和模型仅保存凭据不会自动启用❌ Ping 失败 → 依次检查 API Key、账户额度、Base URL 与网络连接本地服务则确认进程正在运行、端口一致。聊天跑通之后就可以继续为 AIRI 配置语音输入与输出让 ta 开口说话官方手册为配置语音输入与输出。延伸阅读资源路径聊天模型配置总览llm.md语音配置TTS/ASRaudio.md37 份服务商专属指南providers/consciousness/服务商注册表源码providers/registry.ts聊天服务商设置页settings/providers/chat/至此你的 AIRI 已经拥有了来自 OpenAI、Claude、DeepSeek 或本地 Ollama 的「大脑」。接下来给它配上声音、换上喜欢的角色形象一个属于你自己的 AI 伴侣就正式上线了 【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址: https://gitcode.com/moeru-ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
