---
title: LibreChat | RunAPI
description: 为 RunAPI 配置 LibreChat custom endpoint，在 Docker 中挂载 YAML，重启并验证聊天。
url: https://runapi.ai/zh-CN/docs/resources/application-practices/librechat.md
canonical: https://runapi.ai/zh-CN/docs/resources/application-practices/librechat
locale: zh-CN
---

> HTML version: https://runapi.ai/zh-CN/docs/resources/application-practices/librechat
> Site index for agents: https://runapi.ai/llms.txt

# LibreChat

LibreChat custom endpoint 属于部署配置，不是普通用户的 Connection 表单。你需要能够修改 LibreChat
部署文件，并从[身份验证指南](https://runapi.ai/zh-CN/docs/guides/authentication)创建标准 RunAPI API Key。

## 安装 LibreChat

按照 [LibreChat 官方本地安装指南][1]完成安装，或使用现有部署。先确保 LibreChat 正常运行，再添加 custom
endpoint。



[1]: https://www.librechat.ai/docs/local

## 添加 RunAPI endpoint

在 LibreChat 部署目录创建或更新 `librechat.yaml`。请将 `YOUR_RUNAPI_MODEL_ID`
替换为[模型目录](https://runapi.ai/zh-CN/models)中的当前 identifier。

```yaml
version: 1.3.13
endpoints:
  custom:
    - name: "RunAPI"
      apiKey: "${RUNAPI_API_KEY}"
      baseURL: "https://runapi.ai/v1"
      models:
        default: ["YOUR_RUNAPI_MODEL_ID"]
        fetch: true
      titleConvo: true
      titleModel: "current_model"
      modelDisplayLabel: "RunAPI"
```

将 Key 存在 `.env` 中，不要直接写入 YAML：

```shell
RUNAPI_API_KEY=YOUR_RUNAPI_API_TOKEN
```

使用 Docker Compose 时，确认 `docker-compose.override.yml` 已挂载配置文件：

```yaml
services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml
```

修改任一文件后都要重启 LibreChat deployment。

## 选择模型

`models.default` 确保至少有一个已知 model。启用 `models.fetch: true` 后，LibreChat
还会请求当前 model inventory。即使启用了自动发现，也应保留一个有效的默认 identifier，避免发现暂时不可用时整个
endpoint 无法使用。

## 验证连接

重启后，在 endpoint selector 中选择 **RunAPI**，选择已配置 model，然后发送 `只回复
connected。`。收到正常回复即表示部署配置和 model request 都已生效。

## 排查问题

* **endpoint selector 中没有 RunAPI：** 检查 YAML 缩进，确认
  `docker-compose.override.yml` 已挂载文件，然后重启 API container。
* **endpoint 出现但身份验证失败：** 确认 `.env` 为 API container 定义了
  `RUNAPI_API_KEY`；若 container 环境仍是旧值，请重新创建 container。
* **没有自动发现的 models：** 在 `models.default` 中保留一个当前 identifier，确认 `baseURL`
  以 `/v1` 结尾，并检查 API container logs。
* **LibreChat 忽略修改后的 YAML：** 核对 volume mount 的 host path 与 container
  path 是否指向刚编辑的文件。

通用协议行为请查看 [LLM API
快速开始](https://runapi.ai/zh-CN/docs/guides/llm-api/quickstart)。请求和响应字段请查看 [Chat
Completions API 参考](https://runapi.ai/zh-CN/docs/api/openai/chat-completions)。

---

## More from RunAPI

- [Home](https://runapi.ai/.md)
- [模型](https://runapi.ai/zh-CN/models.md)
- [AI 视频 API 对比](https://runapi.ai/zh-CN/ai-video-api-comparison.md)
- [OpenClaw 集成](https://runapi.ai/zh-CN/openclaw.md)
- [OpenClaw 最佳 API](https://runapi.ai/zh-CN/best-api-for-openclaw.md)
- [OpenClaw 图片生成](https://runapi.ai/zh-CN/openclaw-image-generation.md)
- [Hermes 智能体集成](https://runapi.ai/zh-CN/hermes-agent.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [Claude API 定价](https://runapi.ai/zh-CN/claude-api-pricing.md)
- [ChatGPT API 定价](https://runapi.ai/zh-CN/chatgpt-api-pricing.md)
- [OpenAI API 定价](https://runapi.ai/zh-CN/openai-api-pricing.md)
- [Gemini API 定价](https://runapi.ai/zh-CN/gemini-api-pricing.md)
- [Claude Code 定价](https://runapi.ai/zh-CN/claude-code-pricing.md)
- [Claude Code API](https://runapi.ai/zh-CN/claude-code-api.md)
- [Claude Code 对比 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Claude Max 对比 API](https://runapi.ai/zh-CN/claude-max-vs-api.md)
- [Requesty 替代方案](https://runapi.ai/zh-CN/requesty-alternative.md)
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [Skills](https://runapi.ai/zh-CN/skills.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [反馈](https://runapi.ai/)
- [联系](mailto:support@runapi.ai)
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-CNicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "TechArticle",
    "headline": "LibreChat",
    "description": "为 RunAPI 配置 LibreChat custom endpoint，在 Docker 中挂载 YAML，重启并验证聊天。",
    "url": "https://runapi.ai/zh-CN/docs/resources/application-practices/librechat",
    "mainEntityOfPage": "https://runapi.ai/zh-CN/docs/resources/application-practices/librechat"
  }
]
```