環境準備
設定前請確認:- 已安裝並啟動可用的 LibreChat,建議 v0.7.5 或更高版本。
- 已在 AIHubMix 控制台建立 API Key,通常為
sk-***格式。 - 可以修改 LibreChat 安裝目錄中的
.env檔案。它通常位於 LibreChat 專案根目錄,與package.json、docker-compose.yml同級。 - 檔案位置通常是
你的安裝路徑/LibreChat/.env。如果不存在,可將同目錄下的.env.example複製一份並重新命名為.env。
設定 .env
開啟 LibreChat 專案根目錄下的 .env,新增或修改以下內容:
.env,可以使用 LibreChat 的使用者自填模式:
user_provided 表示 LibreChat 會在介面中請目前使用者自行填寫 API Key。兩種方式下,模型都會出現在 OpenAI 端點中。
如目前 API 主網域不可用,可改用備用網域:
OPENAI_MODELS。如果只想顯示部分模型,可以新增逗號分隔的列表:
OPENAI_MODELS,或保留 .env 中 # OPENAI_MODELS=... 的註解狀態。
重新啟動 LibreChat
修改.env 後必須重新啟動 LibreChat:
- 使用本機腳本啟動:重新執行原本的 LibreChat 啟動腳本。
- 使用原始碼或 npm 啟動:進入
.env所在的 LibreChat 專案根目錄,重新執行原本的啟動命令。 - 使用 Docker 部署:在
docker-compose.yml所在目錄執行docker compose restart,或重新啟動對應容器。
效果說明
重新啟動後,在 LibreChat 的端點/模型選擇區選擇 OpenAI,再選擇要使用的 AIHubMix 模型。如果未設定OPENAI_MODELS,模型列表會由 AIHubMix 返回。

參考資源
- AIHubMix:aihubmix.com
- LibreChat:librechat.ai
- LibreChat 本地安裝文件:librechat.ai/docs/local/npm
- LibreChat
.env.example:github.com/danny-avila/LibreChat/blob/main/.env.example
最後更新:2026-07-03