Перейти к основному содержанию
LiteLLM — это open-source LLM-шлюз, который предоставляет единый API для более чем 100 провайдеров моделей. Направляйте OpenClaw через LiteLLM, чтобы получить централизованное отслеживание расходов, журналирование и гибкость переключения бэкендов без изменения конфигурации OpenClaw.
Зачем использовать LiteLLM с OpenClaw?
  • Отслеживание расходов — Видите, сколько именно OpenClaw тратит на всех моделях
  • Маршрутизация моделей — Переключайтесь между Claude, GPT-4, Gemini, Bedrock без изменений конфигурации
  • Виртуальные ключи — Создавайте ключи с лимитами расходов для OpenClaw
  • Журналирование — Полные журналы запросов/ответов для отладки
  • Резервные варианты — Автоматическое переключение при недоступности основного провайдера

​
Быстрый старт

​
Конфигурация

​
Переменные окружения

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" },
    },
  },
}

​
Расширенная конфигурация

​
Генерация изображений

LiteLLM также может обеспечивать работу инструмента image_generate через OpenAI-совместимые маршруты /images/generations и /images/edits. Настройте модель изображений LiteLLM в agents.defaults.imageGenerationModel: 
{
  models: {
    providers: {
      litellm: {
        baseUrl: "http://localhost:4000",
        apiKey: "${LITELLM_API_KEY}",
      },
    },
  },
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "litellm/gpt-image-2",
        timeoutMs: 180_000,
      },
    },
  },
}
Loopback-URL LiteLLM, такие как http://localhost:4000, работают без глобального переопределения частной сети. Для прокси, размещенного в LAN, задайте models.providers.litellm.request.allowPrivateNetwork: true, потому что API-ключ будет отправлен на настроенный хост прокси.
Создайте выделенный ключ для OpenClaw с лимитами расходов:
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 может направлять запросы моделей к разным бэкендам. Настройте это в LiteLLM config.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 обрабатывает маршрутизацию.
Проверьте панель управления или API LiteLLM:
# Key info
curl "http://localhost:4000/key/info" \
  -H "Authorization: Bearer sk-litellm-key"

# Spend logs
curl "http://localhost:4000/spend/logs" \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY"
  • По умолчанию LiteLLM работает на http://localhost:4000
  • OpenClaw подключается через прокси-стиль OpenAI-совместимой конечной точки LiteLLM /v1
  • Формирование запросов, предназначенное только для нативного OpenAI, не применяется через LiteLLM: нет service_tier, нет Responses store, нет подсказок для prompt cache и нет формирования payload для совместимости с reasoning OpenAI
  • Скрытые заголовки атрибуции OpenClaw (originator, version, User-Agent) не внедряются для пользовательских базовых URL LiteLLM
Общую конфигурацию провайдеров и поведение failover см. в Провайдерах моделей.

​
Связанные материалы

LiteLLM Docs

Официальная документация LiteLLM и справочник API.

Model selection

Обзор всех провайдеров, ссылок на модели и поведения failover.

Configuration

Полный справочник конфигурации.

Model selection

Как выбирать и настраивать модели.