# LobeChat 接入指南

LobeChat 是一款现代化的开源聊天框架，支持网页部署与桌面客户端。本文介绍如何让它通过 UModelverse 平台调用模型。

## **系统要求**

-   网络连接。
    
-   自行部署时需要 [Docker](https://www.docker.com/) 或 [Node.js](https://nodejs.org/)（任选其一）。
    

## **1. 获取 API Key**

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。可用模型见 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)。

## **2. 部署并配置**

LobeChat 通过环境变量接入 OpenAI 兼容服务。将 `YOUR_API_KEY` 替换为您的 UModelverse API Key。

### 方式一：Docker 部署

```
docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY=YOUR_API_KEY \
  -e OPENAI_PROXY_URL=https://api.modelverse.cn/v1 \
  -e OPENAI_MODEL_LIST="+claude-sonnet-4-6,+gpt-5.2" \
  lobehub/lobe-chat
```

部署完成后访问 `http://localhost:3210` 即可使用。

### 方式二：环境变量说明

| 环境变量 | 值 |
| --- | --- |
| `OPENAI_API_KEY` | 您的 UModelverse API Key |
| `OPENAI_PROXY_URL` | `https://api.modelverse.cn/v1` |
| `OPENAI_MODEL_LIST` | 以 `+模型名` 形式添加 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)，多个用逗号分隔 |

## **3. 使用模型**

打开页面后，在 OpenAI 服务商下选择已添加的 UModelverse 模型即可开始对话。如未显示，可在「设置 → 语言模型 → OpenAI」中确认 API Key、接口代理地址与模型列表已正确填写。

## **常见问题**

### 提示认证失败或无法连接？

请逐项确认：

1.  `OPENAI_API_KEY` 来自 UModelverse 平台，复制完整且无空格。
    
2.  `OPENAI_PROXY_URL` 为 `https://api.modelverse.cn/v1`。
    
3.  `OPENAI_MODEL_LIST` 中的模型是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一。