OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

LiteLLM

LiteLLM — это LLM-шлюз с открытым исходным кодом и единым API для более чем 100 провайдеров моделей. Направляйте OpenClaw через LiteLLM для централизованного учёта затрат, журналирования, использования виртуальных ключей с лимитами расходов и переключения на резервные серверные системы без изменения конфигурации OpenClaw.

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

Первоначальная настройка (рекомендуется)

bash
openclaw onboard --auth-choice litellm-api-key

Для неинтерактивной настройки с удалённым прокси-сервером явно укажите URL прокси-сервера:

bash
openclaw onboard --non-interactive --accept-risk --auth-choice litellm-api-key \  --litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"

Ручная настройка

  • Запустите прокси-сервер LiteLLM

    bash
    pip install 'litellm[proxy]'litellm --model claude-opus-4-6

  • Подключите OpenClaw к LiteLLM

    bash
    export LITELLM_API_KEY="your-litellm-key"openclaw

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

    json5
    {  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/claude-opus-4-6.

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

    LiteLLM может обеспечивать работу инструмента image_generate через совместимые с OpenAI маршруты /images/generations и /images/edits. Модель изображений по умолчанию — gpt-image-2; другую модель можно настроить в agents.defaults.imageGenerationModel:

    json5
    {  models: {    providers: {      litellm: {        baseUrl: "http://localhost:4000",        apiKey: "${LITELLM_API_KEY}",      },    },  },  agents: {    defaults: {      imageGenerationModel: {        primary: "litellm/gpt-image-2",        timeoutMs: 180_000,      },    },  },}

    Локальные URL LiteLLM (http://localhost:4000, 127.0.0.1, ::1, host.docker.internal) работают без глобального разрешения доступа к частной сети. Для прокси-сервера в локальной сети задайте models.providers.litellm.request.allowPrivateNetwork: true, поскольку ключ API отправляется на этот хост.

    Расширенные возможности

    Виртуальные ключи

    Создайте отдельный ключ для 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 выполняет маршрутизацию.

    Просмотр использования
    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, не применяется при использовании настроенного базового URL LiteLLM: без service_tier, без Responses store, без подсказок для кэша промптов и без формирования полезной нагрузки для уровня усилий рассуждения OpenAI.
    • Скрытые заголовки атрибуции OpenClaw (originator, version, User-Agent) отправляются только проверенным нативным конечным точкам OpenAI, поэтому они не добавляются при использовании пользовательского базового URL LiteLLM.

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

    Документация LiteLLM

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

    Обзор всех провайдеров, ссылок на модели и поведения при переключении на резервные системы.
    Конфигурация

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

    Выбор и настройка моделей.
    Was this useful?
    On this page

    On this page