librechat 接入三方api的大模型

一、最简单接法
1）先准备环境变量

在 .env 里加一行，比如：

THIRD_API_KEY=sk-xxxxx

LibreChat 文档建议在配置里通过环境变量引用 key。

2）在 librechat.yaml 里加自定义端点

这是最常用模板：

endpoints:
  custom:
    - name: "ClawAPI"
      apiKey: "${THIRD_API_KEY}"
      baseURL: "https://clawapi.vip/v1"
      models:
        default:
          - "claude-sonnet-4-6"
          - "claude-sonnet-4-6-thinking"
          - "gpt-5.4"
        fetch: false
      titleConvo: true
      titleModel: "claude-sonnet-4-6"
      summarize: false
      modelDisplayLabel: "ClawAPI"

这里面这些字段是官方支持的自定义端点配置思路：

endpoints.custom

name

apiKey

baseURL

models.default

models.fetch

titleConvo

titleModel

modelDisplayLabel

二、每一项是什么意思
name

前端显示的端点名字，比如 ClawAPI。这个名字后面也可以在别的配置里被引用。

apiKey

填你的三方 key。官方支持直接写字符串，也支持 ${环境变量}。如果你想让用户自己在前端填 key，也可以写 user_provided。

baseURL

三方接口地址。通常填到 /v1 这一层。

models.default

你想在前端下拉框里展示的模型列表。

models.fetch

true：LibreChat 尝试从三方接口拉模型列表

false：只使用你手动写的 models.default

如果你第三方平台的模型列表接口不标准，建议先设成 false。

三、如果你的接口参数不是标准 OpenAI 风格

LibreChat 文档说明：自定义端点默认会使用 OpenAI 的默认参数格式。如果你的供应商更像 Google 那类参数格式，可以通过 customParams.defaultParamsEndpoint 改默认参数模板。

例如：

endpoints:
  custom:
    - name: "MyThirdAPI"
      apiKey: "${THIRD_API_KEY}"
      baseURL: "https://api.clawapi.vip/v1"
      models:
        default:
          - "my-model"
      customParams:
        defaultParamsEndpoint: "openAI"

大多数三方 OpenAI 兼容接口，保持 openAI 逻辑就行。

四、如果你想让界面更干净

LibreChat 还有 modelSpecs，可以帮你把模型显示得更友好，做排序或限制模型展示。官方文档说明它可以简化模型 UI 体验。

例如：

modelSpecs:
  enforce: false
  prioritize: true
  list:
    - name: "Claude 4.6"
      label: "Claude Sonnet 4.6"
      preset:
        endpoint: "ClawAPI"
        model: "claude-sonnet-4-6"

    - name: "GPT-5.4"
      label: "GPT-5.4"
      preset:
        endpoint: "ClawAPI"
        model: "gpt-5.4"

五、配完后怎么生效

如果你是 Docker 部署，改完 librechat.yaml 和 .env 后，一般要：

docker compose down
docker compose up -d

或者至少重启 LibreChat 容器，让新配置加载。