LibreChat

LibreChat 是一个可自部署的多模型聊天平台，适合团队搭建接近 ChatGPT 的 Web 体验，并集中管理用户、模型、插件和对话。

使用 Xikapi 时，可以在 librechat.yaml 中配置 custom endpoint，把 Xikapi 暴露为一个 OpenAI 兼容模型入口。

LibreChat 有什么用

场景	LibreChat 可以做什么
团队聊天平台	提供统一 Web 入口和账号体系
多模型入口	把不同供应商配置成多个 endpoint
插件与工具	接入搜索、工具和外部能力
对话管理	保存、检索和分享对话
自部署	自己控制部署、用户和配置

推荐配置顺序

1. 部署 LibreChat。
2. 准备 .env 和 librechat.yaml。
3. 在 custom endpoint 中添加 Xikapi。
4. 设置默认模型和标题模型。
5. 重启服务并测试。

文档入口

• 安装与部署
• 配置 Xikapi 模型
• 常见报错处理

参考文档

• LibreChat 文档
• Custom Endpoints

新手验收清单

开始前

• 从 Xikapi 控制台复制 API Key 和一个当前可用的模型 ID；不要猜测或照抄其他工具页的模型名。
• 先完成 1 分钟首次调用，确认 Key、模型和网络本身可用。
• 打开本工具的“配置 Xikapi 模型”页面。字段名称可能不同，但必须以该页规定的 provider、地址和模型格式为准。

配置完成的标志

1. 使用纯文本测试消息或最小任务得到正常回复。
2. 没有 401、403、404 或 model not found。
3. 再单独打开流式输出、图片、工具调用、知识库或自动化等高级能力；不要一次全开。

密钥、版本与求助

• API Key 只放在工具的私密设置、环境变量或服务端 Secret 中；不要导出、提交或截图完整 Key。
• 工具版本不同会改变字段名称和界面位置。遇到差异时，优先查看本页末尾的官方文档，再参考本工具的报错页。
• 求助时提供工具版本、模型 ID、状态码和已打码错误文本；完整 Key、Token、Cookie 和私人资料不应发送。