話提供商接入到語音與角色卡配置)
人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手【免費(fèi)下載鏈接】airi 自托管、歸你擁有的 Grok 風(fēng)格 AI 伴侶與 waifu / 賽博生命靈魂容器目標(biāo)是接近 Neuro-sama 的高度支持實(shí)時(shí)語音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。項(xiàng)目地址https://gitcode.com/moeru-ai/airi點(diǎn)擊查看免費(fèi)下載本文基于 Project AIRI 官方 Web 版手冊(cè)docs/content/en/docs/manual/web/index.md整理而成并結(jié)合倉庫源碼補(bǔ)充實(shí)現(xiàn)細(xì)節(jié)。你將學(xué)會(huì)在瀏覽器中首次啟動(dòng) AIRI、選擇并驗(yàn)證聊天提供商與模型、完成首次對(duì)話以及如何開啟 TTS 語音輸出、ASR 語音輸入等交互能力最后掌握角色卡Character Card的切換與自定義。首次啟動(dòng)選擇語言與接入方式在瀏覽器中打開 AIRI Web 版后界面右上角有一個(gè)地球globe按鈕可以隨時(shí)切換界面語言。首次使用時(shí)你有兩種接入方式可選Setup with your provider使用你自己的大模型 API 提供商推薦自托管場景。Sign in登錄并使用 AIRI 官方提供商official provider無需自行準(zhǔn)備 API Key。從倉庫的引導(dǎo)流程測試 onboarding.browser.test.ts 可以看到這兩個(gè)入口分別觸發(fā)官方登錄與自帶提供商兩條配置路徑Sign in按鈕走認(rèn)證登錄Setup with your provider則進(jìn)入提供商選擇卡片其中OpenAI Compatible是測試覆蓋的典型選項(xiàng)const providerCard screen.getByText(OpenAI Compatible)。無論走哪條路徑最終配置結(jié)果都會(huì)持久化到本地localStorage鍵為settings/providers/configured下次打開會(huì)自動(dòng)回填表單。選擇 Chat 提供商點(diǎn)擊Setup with your provider后進(jìn)入提供商選擇界面?？芍苯舆x擇官方列表中的聊天提供商例如OpenAIDeepSeekOllama本地部署如果你的服務(wù)實(shí)現(xiàn)了 OpenAI API 協(xié)議但不在預(yù)設(shè)列表中請(qǐng)選擇OpenAI Compatible然后分別填寫API Key提供商簽發(fā)的訪問令牌粘貼完整 key不要加引號(hào)或多余空格Base URL該服務(wù)文檔中記錄的基礎(chǔ)接口地址。下圖是手冊(cè)中給出的 API 配置示例截圖以 SiliconFlow 為例展示 OpenAI Compatible 形式下 API Key 與 Base URL 的填寫位置關(guān)于這些通用字段的取值規(guī)范倉庫的通用配置指南 common.md 有更完整的說明遠(yuǎn)程服務(wù)一律使用https://僅在可信的本地服務(wù)上使用http://Base URL 需要與提供商官方文檔逐字符比對(duì)否則驗(yàn)證會(huì)失敗。選擇模型并保存選定提供商后從模型列表中選擇一個(gè)兼容的聊天模型然后點(diǎn)擊Save and Continue完成向?qū)?。提示推理模型Reasoning models的響應(yīng)耗時(shí)通常更長。如果你更看重對(duì)話速度可以選擇非推理模型。模型選擇與提供商配置是兩個(gè)獨(dú)立步驟Providers 頁面負(fù)責(zé)保存憑據(jù)Modules 頁面的模型列表才決定實(shí)際使用的模型。AIRI 會(huì)在切換提供商后自動(dòng)重新拉取該提供商的模型目錄providerModels與isLoadingModels狀態(tài)詳見 provider.ts 中的模型列表邏輯。開始第一次對(duì)話配置完成后在主頁底部的聊天輸入框中輸入文本并發(fā)送AIRI 就會(huì)基于你選擇的模型進(jìn)行回復(fù)。對(duì)話會(huì)話由chatstore 管理chat.ts發(fā)送的消息會(huì)攜帶當(dāng)前角色卡與模塊上下文進(jìn)入對(duì)話流程。讓 AIRI 擁有眼睛、耳朵和嘴巴除了純文本對(duì)話AIRI Web 版還支持語音合成說話、語音識(shí)別聽等交互能力。這些能力分為提供商配置與模塊啟用兩步入口統(tǒng)一在右上角Settings → Modules。讓 AIRI 說話TTS打開Settings → Providers → Speech選擇一個(gè)語音提供商并填寫憑據(jù)打開Settings → Modules → Speech選擇剛才配置的提供商、模型model和音色voice。從源碼看語音模塊speech.ts是 Web 版語音能力的核心 store值得了解的實(shí)現(xiàn)細(xì)節(jié)包括配置項(xiàng)持久化activeSpeechProvider、activeSpeechModel、activeSpeechVoiceId分別持久化在settings/speech/active-provider、settings/speech/active-model、settings/speech/voice三個(gè) localStorage 鍵中額外調(diào)節(jié)參數(shù)pitch音高默認(rèn) 0、rate語速默認(rèn) 1、ssmlEnabledSSML 開關(guān)默認(rèn)關(guān)閉SSML 支持目前僅 ElevenLabs、Microsoft Speech、Azure Speech以及阿里云 cosyvoice-v2alibaba-cloud-model-studio等提供商支持 SSML 語法supportsSSML計(jì)算屬性語音目錄動(dòng)態(tài)加載切換提供商或模型時(shí)會(huì)通過loadVoicesForProvider拉取對(duì)應(yīng)音色列表availableVoices并根據(jù)模型重新推薦默認(rèn)音色合成鏈路最終通過generateSpeech來自xsai/generate-speech發(fā)起 TTS 請(qǐng)求對(duì)雙向 WebSocket 傳輸?shù)牧魇教峁┥倘绻俜搅魇?TTS則走streamSpeech流式管線streaming-pipeline.ts。啟用語音輸入ASR/STT打開Settings → Providers → Transcription選擇轉(zhuǎn)寫提供商并填寫憑據(jù)打開Settings → Modules → Hearing選擇提供商與模型并選擇一個(gè)可用的麥克風(fēng)返回主頁點(diǎn)擊麥克風(fēng)按鈕即可打開聽力Hearing控制面板。聽力模塊hearing.ts的實(shí)現(xiàn)要點(diǎn)配置持久化activeTranscriptionProvider/activeTranscriptionModel持久化在settings/hearing/active-provider、settings/hearing/active-model自動(dòng)發(fā)送autoSendEnabled默認(rèn)關(guān)閉與autoSendDelay默認(rèn) 2000ms控制識(shí)別文本是否自動(dòng)作為消息發(fā)出置信度過濾confidenceThreshold用于按verbose_json分段的平均對(duì)數(shù)概率avg_logprob過濾低置信度文本CONFIDENCE_THRESHOLD_DISABLED -3表示關(guān)閉過濾實(shí)時(shí)與文件雙模式支持流式輸入inputAudioStreamPCM16 編碼與錄音文件WAV兩種轉(zhuǎn)寫輸入Web Speech API、Sherpaw、Apple Speech、阿里云 NLS 等走STREAM_TRANSCRIPTION_EXECUTORS注冊(cè)的流式執(zhí)行器瀏覽器內(nèi)置方案選擇browser-web-speech-api時(shí)無需模型即可直接使用瀏覽器語音識(shí)別能力configured恒為 true。兩種能力的完整配置與排錯(cuò)流程可進(jìn)一步閱讀倉庫中的 audio.md語音輸入輸出總覽與各提供商的專項(xiàng)文檔例如 speech/openai.md、transcription/openai.md。視覺捕獲目前僅限桌面版屏幕與窗口捕獲Vision Capture目前僅在Desktop 版可用Web 版暫不支持。若需為 AIRI 配置視覺理解能力請(qǐng)參見視覺提供商與模型配置vision.md桌面版 Vision Capture 工作流見該文檔中的桌面開發(fā)者工具指引視覺模塊在 Web 側(cè)仍可通過 vision.ts 配置提供商與模型如圖像理解模型、捕獲間隔 Capture interval但實(shí)際的屏幕幀采集入口僅在桌面端System → Developer → Vision Capture提供。角色卡定義 AIRI 的身份與行為AIRI 內(nèi)置了一張名為ReLU的角色卡其立繪素材見 relu.avif。你可以使用主頁右上角的角色切換器在不同角色間切換或在Settings中管理創(chuàng)建、編輯、刪除、搜索角色卡。角色管理頁面位于 Web 端設(shè)置中心apps/stage-web/src/pages/settings/characters/index.vue提供關(guān)鍵詞搜索按角色的英文名與描述過濾、新建角色、編輯與刪除等操作刪除需要二次確認(rèn)。角色卡內(nèi)容一張角色卡定義 AIRI 的name名字description描述personality性格scenario場景設(shè)定greetings開場問候語這些字段共同決定了 AIRI 的身份與行為風(fēng)格。從角色卡 storeairi-card.ts的系統(tǒng)提示詞拼裝邏輯可以看到systemPrompt、description、personality、scenario以及 Artistry 模塊的widgetInstruction會(huì)被依次拼接以空行分隔作為發(fā)送給模型的系統(tǒng)提示詞resolveSystemPrompt因此這幾項(xiàng)內(nèi)容會(huì)直接影響每次對(duì)話的上下文。角色卡設(shè)置與模塊偏好角色卡不僅可以描述身份還能存儲(chǔ)模塊偏好——例如某個(gè)角色偏好使用特定的語音提供商、音色、模型選擇。因此切換配置文件時(shí)可以同時(shí)切換角色及其關(guān)聯(lián)的模型選擇實(shí)現(xiàn)角色 × 模型 × 語音的一體化切換。這在實(shí)現(xiàn)層面由兩處狀態(tài)共同支撐airi-card-active-id當(dāng)前激活的角色卡 ID默認(rèn)defaultairi-card-module-defaults各模塊speech、hearing、vision、artistry、consciousness 等的默認(rèn)選擇快照切換角色卡時(shí)會(huì)以該快照覆蓋運(yùn)行時(shí)模塊設(shè)置。應(yīng)用卡片時(shí)會(huì)通過resolveModuleSelection把卡片內(nèi)嵌的模塊選擇應(yīng)用到各運(yùn)行時(shí) storeuseRuntimeModuleStores中注冊(cè)了 artistry、consciousness、speech、stageModel、vision 五個(gè)模塊實(shí)現(xiàn)切卡即切配置。配置驗(yàn)證與常見排查配置完成后可按以下順序驗(yàn)證鏈路是否可用詳細(xì)字段與排錯(cuò)步驟見 common.md聊天在輸入框發(fā)送消息確認(rèn)模型正常回復(fù)語音輸出進(jìn)入 Speech 模塊點(diǎn)擊播放預(yù)覽音色無聲音時(shí)依次檢查提供商/模型/音色是否已選、系統(tǒng)輸出設(shè)備與音量、API Key 與賬戶額度語音輸入在 Hearing 模塊點(diǎn)擊Start Monitoring后說一句短句確認(rèn)識(shí)別區(qū)出現(xiàn)對(duì)應(yīng)文字無輸出時(shí)檢查麥克風(fēng)權(quán)限與輸入設(shè)備選擇視覺桌面版捕獲一個(gè)不含敏感信息的窗口觸發(fā)一次視覺分析確認(rèn) AIRI 能收到畫面描述。如果驗(yàn)證失敗通用排查順序?yàn)榇_認(rèn)賬戶有額度/配額 → 重新復(fù)制 API Key去掉首尾空格與換行→ 恢復(fù)默認(rèn) Base URL 并與官方文檔比對(duì) → 確認(rèn)網(wǎng)絡(luò)、代理、防火墻可達(dá) → 選擇提供商明確支持且支持圖像輸入的模型不要用顯示名當(dāng)模型 ID。結(jié)語至此你已經(jīng)掌握 AIRI Web 版從首次啟動(dòng)、接入任意 OpenAI 兼容聊天提供商、完成首次對(duì)話到開啟 TTS 語音輸出與 ASR 語音輸入、以及基于角色卡切換角色 模型 語音配置的完整路徑。更深入的提供商專項(xiàng)配置Speech / Transcription / Vision / Artistry 等可繼續(xù)閱讀 docs/content/en/docs/manual/config/index.md 目錄下的各提供商文檔。贊分享人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手【免費(fèi)下載鏈接】airi 自托管、歸你擁有的 Grok 風(fēng)格 AI 伴侶與 waifu / 賽博生命靈魂容器目標(biāo)是接近 Neuro-sama 的高度支持實(shí)時(shí)語音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。項(xiàng)目地址https://gitcode.com/moeru-ai/airi點(diǎn)擊查看免費(fèi)下載相關(guān)推薦AIRI Web 版快速上手指南聊天提供者配置、語音交互與角色卡片實(shí)戰(zhàn)AIRI Web 版快速上手指南聊天提供者配置、語音交互與角色卡片實(shí)戰(zhàn) 本篇技術(shù)指南圍繞 AIRI 項(xiàng)目的 Web 版使用流程展開講解從首次啟動(dòng)、語言切換、人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手后端AIRI 語音合成接入指南配置 OpenAI 兼容 TTS 服務(wù)提供商AIRI 語音合成接入指南配置 OpenAI 兼容 TTS 服務(wù)提供商 本文介紹如何在 AIRImoeru ai/airi中將任何實(shí)現(xiàn) OpenAI Sp人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手后端AIRI 網(wǎng)頁版上手指南從配置大腦到語音交互與角色卡定制AIRI 網(wǎng)頁版上手指南從配置大腦到語音交互與角色卡定制 本文導(dǎo)讀 本文以 AIRI 官方網(wǎng)頁版手冊(cè)為主線完整講解網(wǎng)頁版從零起步的完整流程——先為 A人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手后端上一篇BetterNCM插件管理器5步解決網(wǎng)易云音樂功能擴(kuò)展難題下一篇AI-HF_Patch終極指南3步讓AI-Shoujo游戲體驗(yàn)提升300%的秘密創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 AIRI Web 版使用指南：從對(duì)話提供商接入到語音與角色卡配置
人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手【免費(fèi)下載鏈接】airi 自托管、歸你擁有的 Grok 風(fēng)格 AI 伴侶與 waifu / 賽博生命靈魂容器目標(biāo)是接近 Neuro-sama 的高度支持實(shí)時(shí)語音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。項(xiàng)目地址https://gitcode.com/moeru-ai/airi點(diǎn)擊查看免費(fèi)下載本文基于 Project AIRI 官方 Web 版手冊(cè)docs/content/en/docs/manual/web/index.md整理而成并結(jié)合倉庫源碼補(bǔ)充實(shí)現(xiàn)細(xì)節(jié)。你將學(xué)會(huì)在瀏覽器中首次啟動(dòng) AIRI、選擇并驗(yàn)證聊天提供商與模型、完成首次對(duì)話以及如何開啟 TTS 語音輸出、ASR 語音輸入等交互能力最后掌握角色卡Character Card的切換與自定義。首次啟動(dòng)選擇語言與接入方式在瀏覽器中打開 AIRI Web 版后界面右上角有一個(gè)地球globe按鈕可以隨時(shí)切換界面語言。首次使用時(shí)你有兩種接入方式可選Setup with your provider使用你自己的大模型 API 提供商推薦自托管場景。Sign in登錄并使用 AIRI 官方提供商official provider無需自行準(zhǔn)備 API Key。從倉庫的引導(dǎo)流程測試 onboarding.browser.test.ts 可以看到這兩個(gè)入口分別觸發(fā)官方登錄與自帶提供商兩條配置路徑Sign in按鈕走認(rèn)證登錄Setup with your provider則進(jìn)入提供商選擇卡片其中OpenAI Compatible是測試覆蓋的典型選項(xiàng)const providerCard screen.getByText(OpenAI Compatible)。無論走哪條路徑最終配置結(jié)果都會(huì)持久化到本地localStorage鍵為settings/providers/configured下次打開會(huì)自動(dòng)回填表單。選擇 Chat 提供商點(diǎn)擊Setup with your provider后進(jìn)入提供商選擇界面?？芍苯舆x擇官方列表中的聊天提供商例如OpenAIDeepSeekOllama本地部署如果你的服務(wù)實(shí)現(xiàn)了 OpenAI API 協(xié)議但不在預(yù)設(shè)列表中請(qǐng)選擇OpenAI Compatible然后分別填寫API Key提供商簽發(fā)的訪問令牌粘貼完整 key不要加引號(hào)或多余空格Base URL該服務(wù)文檔中記錄的基礎(chǔ)接口地址。下圖是手冊(cè)中給出的 API 配置示例截圖以 SiliconFlow 為例展示 OpenAI Compatible 形式下 API Key 與 Base URL 的填寫位置關(guān)于這些通用字段的取值規(guī)范倉庫的通用配置指南 common.md 有更完整的說明遠(yuǎn)程服務(wù)一律使用https://僅在可信的本地服務(wù)上使用http://Base URL 需要與提供商官方文檔逐字符比對(duì)否則驗(yàn)證會(huì)失敗。選擇模型并保存選定提供商后從模型列表中選擇一個(gè)兼容的聊天模型然后點(diǎn)擊Save and Continue完成向?qū)?。提示推理模型Reasoning models的響應(yīng)耗時(shí)通常更長。如果你更看重對(duì)話速度可以選擇非推理模型。模型選擇與提供商配置是兩個(gè)獨(dú)立步驟Providers 頁面負(fù)責(zé)保存憑據(jù)Modules 頁面的模型列表才決定實(shí)際使用的模型。AIRI 會(huì)在切換提供商后自動(dòng)重新拉取該提供商的模型目錄providerModels與isLoadingModels狀態(tài)詳見 provider.ts 中的模型列表邏輯。開始第一次對(duì)話配置完成后在主頁底部的聊天輸入框中輸入文本并發(fā)送AIRI 就會(huì)基于你選擇的模型進(jìn)行回復(fù)。對(duì)話會(huì)話由chatstore 管理chat.ts發(fā)送的消息會(huì)攜帶當(dāng)前角色卡與模塊上下文進(jìn)入對(duì)話流程。讓 AIRI 擁有眼睛、耳朵和嘴巴除了純文本對(duì)話AIRI Web 版還支持語音合成說話、語音識(shí)別聽等交互能力。這些能力分為提供商配置與模塊啟用兩步入口統(tǒng)一在右上角Settings → Modules。讓 AIRI 說話TTS打開Settings → Providers → Speech選擇一個(gè)語音提供商并填寫憑據(jù)打開Settings → Modules → Speech選擇剛才配置的提供商、模型model和音色voice。從源碼看語音模塊speech.ts是 Web 版語音能力的核心 store值得了解的實(shí)現(xiàn)細(xì)節(jié)包括配置項(xiàng)持久化activeSpeechProvider、activeSpeechModel、activeSpeechVoiceId分別持久化在settings/speech/active-provider、settings/speech/active-model、settings/speech/voice三個(gè) localStorage 鍵中額外調(diào)節(jié)參數(shù)pitch音高默認(rèn) 0、rate語速默認(rèn) 1、ssmlEnabledSSML 開關(guān)默認(rèn)關(guān)閉SSML 支持目前僅 ElevenLabs、Microsoft Speech、Azure Speech以及阿里云 cosyvoice-v2alibaba-cloud-model-studio等提供商支持 SSML 語法supportsSSML計(jì)算屬性語音目錄動(dòng)態(tài)加載切換提供商或模型時(shí)會(huì)通過loadVoicesForProvider拉取對(duì)應(yīng)音色列表availableVoices并根據(jù)模型重新推薦默認(rèn)音色合成鏈路最終通過generateSpeech來自xsai/generate-speech發(fā)起 TTS 請(qǐng)求對(duì)雙向 WebSocket 傳輸?shù)牧魇教峁┥倘绻俜搅魇?TTS則走streamSpeech流式管線streaming-pipeline.ts。啟用語音輸入ASR/STT打開Settings → Providers → Transcription選擇轉(zhuǎn)寫提供商并填寫憑據(jù)打開Settings → Modules → Hearing選擇提供商與模型并選擇一個(gè)可用的麥克風(fēng)返回主頁點(diǎn)擊麥克風(fēng)按鈕即可打開聽力Hearing控制面板。聽力模塊hearing.ts的實(shí)現(xiàn)要點(diǎn)配置持久化activeTranscriptionProvider/activeTranscriptionModel持久化在settings/hearing/active-provider、settings/hearing/active-model自動(dòng)發(fā)送autoSendEnabled默認(rèn)關(guān)閉與autoSendDelay默認(rèn) 2000ms控制識(shí)別文本是否自動(dòng)作為消息發(fā)出置信度過濾confidenceThreshold用于按verbose_json分段的平均對(duì)數(shù)概率avg_logprob過濾低置信度文本CONFIDENCE_THRESHOLD_DISABLED -3表示關(guān)閉過濾實(shí)時(shí)與文件雙模式支持流式輸入inputAudioStreamPCM16 編碼與錄音文件WAV兩種轉(zhuǎn)寫輸入Web Speech API、Sherpaw、Apple Speech、阿里云 NLS 等走STREAM_TRANSCRIPTION_EXECUTORS注冊(cè)的流式執(zhí)行器瀏覽器內(nèi)置方案選擇browser-web-speech-api時(shí)無需模型即可直接使用瀏覽器語音識(shí)別能力configured恒為 true。兩種能力的完整配置與排錯(cuò)流程可進(jìn)一步閱讀倉庫中的 audio.md語音輸入輸出總覽與各提供商的專項(xiàng)文檔例如 speech/openai.md、transcription/openai.md。視覺捕獲目前僅限桌面版屏幕與窗口捕獲Vision Capture目前僅在Desktop 版可用Web 版暫不支持。若需為 AIRI 配置視覺理解能力請(qǐng)參見視覺提供商與模型配置vision.md桌面版 Vision Capture 工作流見該文檔中的桌面開發(fā)者工具指引視覺模塊在 Web 側(cè)仍可通過 vision.ts 配置提供商與模型如圖像理解模型、捕獲間隔 Capture interval但實(shí)際的屏幕幀采集入口僅在桌面端System → Developer → Vision Capture提供。角色卡定義 AIRI 的身份與行為AIRI 內(nèi)置了一張名為ReLU的角色卡其立繪素材見 relu.avif。你可以使用主頁右上角的角色切換器在不同角色間切換或在Settings中管理創(chuàng)建、編輯、刪除、搜索角色卡。角色管理頁面位于 Web 端設(shè)置中心apps/stage-web/src/pages/settings/characters/index.vue提供關(guān)鍵詞搜索按角色的英文名與描述過濾、新建角色、編輯與刪除等操作刪除需要二次確認(rèn)。角色卡內(nèi)容一張角色卡定義 AIRI 的name名字description描述personality性格scenario場景設(shè)定greetings開場問候語這些字段共同決定了 AIRI 的身份與行為風(fēng)格。從角色卡 storeairi-card.ts的系統(tǒng)提示詞拼裝邏輯可以看到systemPrompt、description、personality、scenario以及 Artistry 模塊的widgetInstruction會(huì)被依次拼接以空行分隔作為發(fā)送給模型的系統(tǒng)提示詞resolveSystemPrompt因此這幾項(xiàng)內(nèi)容會(huì)直接影響每次對(duì)話的上下文。角色卡設(shè)置與模塊偏好角色卡不僅可以描述身份還能存儲(chǔ)模塊偏好——例如某個(gè)角色偏好使用特定的語音提供商、音色、模型選擇。因此切換配置文件時(shí)可以同時(shí)切換角色及其關(guān)聯(lián)的模型選擇實(shí)現(xiàn)角色 × 模型 × 語音的一體化切換。這在實(shí)現(xiàn)層面由兩處狀態(tài)共同支撐airi-card-active-id當(dāng)前激活的角色卡 ID默認(rèn)defaultairi-card-module-defaults各模塊speech、hearing、vision、artistry、consciousness 等的默認(rèn)選擇快照切換角色卡時(shí)會(huì)以該快照覆蓋運(yùn)行時(shí)模塊設(shè)置。應(yīng)用卡片時(shí)會(huì)通過resolveModuleSelection把卡片內(nèi)嵌的模塊選擇應(yīng)用到各運(yùn)行時(shí) storeuseRuntimeModuleStores中注冊(cè)了 artistry、consciousness、speech、stageModel、vision 五個(gè)模塊實(shí)現(xiàn)切卡即切配置。配置驗(yàn)證與常見排查配置完成后可按以下順序驗(yàn)證鏈路是否可用詳細(xì)字段與排錯(cuò)步驟見 common.md聊天在輸入框發(fā)送消息確認(rèn)模型正常回復(fù)語音輸出進(jìn)入 Speech 模塊點(diǎn)擊播放預(yù)覽音色無聲音時(shí)依次檢查提供商/模型/音色是否已選、系統(tǒng)輸出設(shè)備與音量、API Key 與賬戶額度語音輸入在 Hearing 模塊點(diǎn)擊Start Monitoring后說一句短句確認(rèn)識(shí)別區(qū)出現(xiàn)對(duì)應(yīng)文字無輸出時(shí)檢查麥克風(fēng)權(quán)限與輸入設(shè)備選擇視覺桌面版捕獲一個(gè)不含敏感信息的窗口觸發(fā)一次視覺分析確認(rèn) AIRI 能收到畫面描述。如果驗(yàn)證失敗通用排查順序?yàn)榇_認(rèn)賬戶有額度/配額 → 重新復(fù)制 API Key去掉首尾空格與換行→ 恢復(fù)默認(rèn) Base URL 并與官方文檔比對(duì) → 確認(rèn)網(wǎng)絡(luò)、代理、防火墻可達(dá) → 選擇提供商明確支持且支持圖像輸入的模型不要用顯示名當(dāng)模型 ID。結(jié)語至此你已經(jīng)掌握 AIRI Web 版從首次啟動(dòng)、接入任意 OpenAI 兼容聊天提供商、完成首次對(duì)話到開啟 TTS 語音輸出與 ASR 語音輸入、以及基于角色卡切換角色 模型 語音配置的完整路徑。更深入的提供商專項(xiàng)配置Speech / Transcription / Vision / Artistry 等可繼續(xù)閱讀 docs/content/en/docs/manual/config/index.md 目錄下的各提供商文檔。贊分享人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手【免費(fèi)下載鏈接】airi 自托管、歸你擁有的 Grok 風(fēng)格 AI 伴侶與 waifu / 賽博生命靈魂容器目標(biāo)是接近 Neuro-sama 的高度支持實(shí)時(shí)語音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。項(xiàng)目地址https://gitcode.com/moeru-ai/airi點(diǎn)擊查看免費(fèi)下載相關(guān)推薦AIRI Web 版快速上手指南聊天提供者配置、語音交互與角色卡片實(shí)戰(zhàn)AIRI Web 版快速上手指南聊天提供者配置、語音交互與角色卡片實(shí)戰(zhàn) 本篇技術(shù)指南圍繞 AIRI 項(xiàng)目的 Web 版使用流程展開講解從首次啟動(dòng)、語言切換、人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手后端AIRI 語音合成接入指南配置 OpenAI 兼容 TTS 服務(wù)提供商AIRI 語音合成接入指南配置 OpenAI 兼容 TTS 服務(wù)提供商 本文介紹如何在 AIRImoeru ai/airi中將任何實(shí)現(xiàn) OpenAI Sp人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手后端AIRI 網(wǎng)頁版上手指南從配置大腦到語音交互與角色卡定制AIRI 網(wǎng)頁版上手指南從配置大腦到語音交互與角色卡定制 本文導(dǎo)讀 本文以 AIRI 官方網(wǎng)頁版手冊(cè)為主線完整講解網(wǎng)頁版從零起步的完整流程——先為 A人工智能AI AgentMCP 服務(wù)工具調(diào)用GUI 自動(dòng)化語音數(shù)字人交互助手后端上一篇BetterNCM插件管理器5步解決網(wǎng)易云音樂功能擴(kuò)展難題下一篇AI-HF_Patch終極指南3步讓AI-Shoujo游戲體驗(yàn)提升300%的秘密創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考