| read_when |
summary |
title |
x-i18n |
| Ви хочете спрямувати OpenClaw через проксі LiteLLM |
| Вам потрібне відстеження витрат, журналювання або маршрутизація моделей через LiteLLM |
|
Запускайте OpenClaw через LiteLLM Proxy для уніфікованого доступу до моделей і відстеження витрат |
LiteLLM |
| generated_at |
model |
provider |
source_hash |
source_path |
workflow |
| 2026-04-12T10:19:21Z |
gpt-5.4 |
openai |
766692eb83a1be83811d8e09a970697530ffdd4f3392247cfb2927fd590364a0 |
providers/litellm.md |
15 |
|
LiteLLM
LiteLLM — це шлюз LLM з відкритим кодом, який надає уніфікований API до понад 100 постачальників моделей. Спрямуйте OpenClaw через LiteLLM, щоб отримати централізоване відстеження витрат, журналювання та гнучкість перемикання між бекендами без змін у конфігурації OpenClaw.
**Чому варто використовувати LiteLLM з OpenClaw?**
- Відстеження витрат — Бачте, скільки саме OpenClaw витрачає на всі моделі
- Маршрутизація моделей — Перемикайтеся між Claude, GPT-4, Gemini, Bedrock без змін конфігурації
- Virtual keys — Створюйте ключі з лімітами витрат для OpenClaw
- Журналювання — Повні журнали запитів/відповідей для налагодження
- Резервні перемикання — Автоматичне перемикання у разі збою, якщо ваш основний постачальник недоступний
Швидкий старт
**Найкраще для:** найшвидшого шляху до робочого налаштування LiteLLM.
<Steps>
<Step title="Запустіть онбординг">
```bash
openclaw onboard --auth-choice litellm-api-key
```
</Step>
</Steps>
**Найкраще для:** повного контролю над встановленням
і конфігурацією.
<Steps>
<Step title="Запустіть LiteLLM Proxy">
```bash
pip install 'litellm[proxy]'
litellm --model claude-opus-4-6
```
</Step>
<Step title="Спрямуйте OpenClaw до LiteLLM">
```bash
export LITELLM_API_KEY="your-litellm-key"
openclaw
```
Ось і все. Тепер OpenClaw працює через LiteLLM.
</Step>
</Steps>
Конфігурація
Змінні середовища
export LITELLM_API_KEY="sk-litellm-key"
Файл конфігурації
{
models: {
providers: {
litellm: {
baseUrl: "http://localhost:4000",
apiKey: "${LITELLM_API_KEY}",
api: "openai-completions",
models: [
{
id: "claude-opus-4-6",
name: "Claude Opus 4.6",
reasoning: true,
input: ["text", "image"],
contextWindow: 200000,
maxTokens: 64000,
},
{
id: "gpt-4o",
name: "GPT-4o",
reasoning: false,
input: ["text", "image"],
contextWindow: 128000,
maxTokens: 8192,
},
],
},
},
},
agents: {
defaults: {
model: { primary: "litellm/claude-opus-4-6" },
},
},
}
Розширені теми
Створіть окремий ключ для OpenClaw з лімітами витрат:
```bash
curl -X POST "http://localhost:4000/key/generate" \
-H "Authorization: Bearer $LITELLM_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{
"key_alias": "openclaw",
"max_budget": 50.00,
"budget_duration": "monthly"
}'
```
Використовуйте згенерований ключ як `LITELLM_API_KEY`.
LiteLLM може маршрутизувати запити до моделей на різні бекенди. Налаштуйте це
у своєму `config.yaml` LiteLLM:
```yaml
model_list:
- model_name: claude-opus-4-6
litellm_params:
model: claude-opus-4-6
api_key: os.environ/ANTHROPIC_API_KEY
- model_name: gpt-4o
litellm_params:
model: gpt-4o
api_key: os.environ/OPENAI_API_KEY
```
OpenClaw і далі запитуватиме `claude-opus-4-6` — маршрутизацією керуватиме LiteLLM.
Перевіряйте панель керування LiteLLM
або API:
```bash
# Інформація про ключ
curl "http://localhost:4000/key/info" \
-H "Authorization: Bearer sk-litellm-key"
# Журнали витрат
curl "http://localhost:4000/spend/logs" \
-H "Authorization: Bearer $LITELLM_MASTER_KEY"
```
- LiteLLM за замовчуванням працює на `
http://localhost:4000`
- OpenClaw підключається через OpenAI-сумісну `/v1` кінцеву точку LiteLLM
у стилі проксі
- Власне формування запитів лише для OpenAI не застосовується через LiteLLM:
немає `service_tier`, немає `store` для Responses, немає підказок кешу промптів
і немає формування OpenAI reasoning-compat payload
- Приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`) не додаються для користувацьких базових URL LiteLLM
Загальні відомості про конфігурацію постачальників
і поведінку резервного перемикання див.
у [Model Providers](/uk/concepts/model-providers).
Пов’язане
Офіційна документація LiteLLM
і довідник API.
Огляд
усіх постачальників, посилань на моделі та поведінки резервного перемикання.
Повний довідник конфігурації.
Як вибирати та налаштовувати моделі.