OpenClaw подключение к Claude: 2 способа настройки — режим совместимости с OpenAI vs нативный формат Claude. Полное руководство

Примечание автора: Пошаговое руководство по настройке двух способов подключения в OpenClaw: совместимого режима OpenAI и нативного формата Claude. Включает полный код JSON-конфигурации, список поддерживаемых моделей и сравнение ключевых различий.

В OpenClaw (Open WebUI) есть два способа подключения больших языковых моделей: совместимый режим OpenAI (openai-completions) и нативный формат Claude (anthropic-messages). Многие пользователи не понимают разницы между ними, что приводит либо к использованию неправильного формата для моделей Claude, либо к упущению продвинутых функций, таких как Prompt Caching, которые доступны в нативном формате.

Основная ценность: Прочитав эту статью, вы освоите полную настройку обоих способов подключения в OpenClaw, поймёте, какой формат использовать для каждой модели, и сможете сразу скопировать код конфигурации для использования.

Сравнение двух способов подключения OpenClaw

Краткое описание двух способов подключения OpenClaw

Запомните простое правило: для моделей серии Claude используйте anthropic-messages, для всех остальных моделей используйте openai-completions. Самый наглядный признак отличия — это baseUrl: в режиме совместимости с OpenAI в конце есть /v1, а в нативном формате Claude — нет.

Руководство по настройке режима совместимости OpenClaw с OpenAI

Когда использовать режим совместимости с OpenAI

Режим совместимости с OpenAI (openai-completions) — это самый универсальный способ подключения в OpenClaw, подходящий для всех больших языковых моделей, кроме Claude. Большинство сервисов-прокси API используют этот стандартизированный формат OpenAI.

Полный код конфигурации для режима совместимости с OpenAI

Ниже приведена полная конфигурация для подключения GPT-5.4 через APIYI:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-ваш_API-ключ",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-ваш_API-ключ",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      }
    }
  }
}

Ключевые моменты настройки режима совместимости с OpenAI

🎯 Важное напоминание: /v1 в конце baseUrl нельзя опускать — это стандартный путь для протокола совместимости с OpenAI. Зарегистрируйтесь на сайте APIYI apiyi.com, чтобы получить API-ключ и бесплатный лимит.

Сценарии использования нативного формата Claude

Нативный формат Claude (anthropic-messages) — это эксклюзивный способ подключения к моделям серии Claude. Использование нативного формата даёт доступ к уникальным продвинутым функциям Claude, таким как Prompt Caching, Extended Thinking и обработка PDF.

Полный код конфигурации для нативного формата Claude

Ниже приведена полная конфигурация для подключения к моделям Claude через APIYI:

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-ваш_API-ключ",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-ваш_API-ключ",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-haiku-4-5-20251001",
            "name": "Claude Haiku 4.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Ключевые моменты конфигурации нативного формата Claude

🎯 Ключевое отличие: baseUrl для нативного формата Claude не содержит /v1. Это самая частая ошибка новичков — если подключение Claude выдаёт ошибку, сначала проверьте, не добавлен ли случайно /v1 в конце URL.

Конфигурация OpenClaw для одновременного использования двух форматов

На практике вам, скорее всего, понадобится использовать и универсальные модели, и модели Claude одновременно. В этом случае нужно настроить в OpenClaw два провайдера (provider):

Объединённый код конфигурации для двух провайдеров

Разместите оба провайдера в одном конфигурационном файле, и в OpenClaw вы сможете свободно переключаться между моделями:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-ваш_API-ключ",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      },
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-ваш_API-ключ",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

🎯 Важное замечание: Оба провайдера могут использовать один и тот же API-ключ. Один ключ от APIYI (apiyi.com) одновременно поддерживает формат, совместимый с OpenAI, и нативный формат Claude. Не нужно получать несколько ключей.

Устранение распространённых ошибок в двух форматах OpenClaw

Самая частая ошибка при настройке — несоответствие между baseUrl и типом API. Ниже приведены типичные ошибки и способы их решения:

🎯 Быстрая памятка по устранению ошибок: Формат OpenAI — с /v1, формат Claude — без /v1. Запомнив это, можно избежать 80% ошибок конфигурации. Если возникнут другие проблемы, загляни в центр документации APIYI на apiyi.com для полного руководства по подключению.

Часто задаваемые вопросы

Итог

Ключевые моменты двух способов подключения OpenClaw:

1. Универсальные модели используйте openai-completions: GPT, Gemini, DeepSeek, GLM, Kimi, Grok, Minimax и все другие модели, кроме Claude. BaseUrl должен содержать /v1.
2. Серия Claude используйте anthropic-messages: claude-sonnet-4-6, claude-opus-4-6, claude-haiku и т.д. BaseUrl НЕ должен содержать /v1, требуется заголовок anthropic-version.
3. Сосуществование двух провайдеров — лучшая практика: Настройте один и тот же API-ключ для двух провайдеров, чтобы свободно переключаться между всеми моделями в OpenClaw.

Рекомендуем получить API-ключ через APIYI apiyi.com. Один ключ даёт доступ ко всем основным моделям, включая GPT, Claude, Gemini, DeepSeek, и поддерживает как OpenAI-совместимый, так и нативный Claude форматы.

📚 Справочные материалы

1. Центр справки APIYI: Полное руководство по настройке подключения OpenClaw

   • Ссылка: help.apiyi.com
   • Описание: Содержит подробную документацию по подключению для различных платформ и актуальные списки моделей.

2. Документация Anthropic API: Спецификация нативного формата API Claude

   • Ссылка: platform.claude.com/docs/en/api/messages
   • Описание: Полный список параметров и формат ответа для Messages API.

3. Документация по совместимости OpenAI SDK: Какие параметры игнорируются в Claude

   • Ссылка: platform.claude.com/docs/en/api/openai-sdk
   • Описание: Полный список поддерживаемых и неподдерживаемых параметров.

4. Документация Open WebUI: Руководство по настройке нескольких провайдеров в OpenClaw

   • Ссылка: docs.openwebui.com
   • Описание: Настройка провайдеров, управление моделями и настройка агентов.

Автор: Техническая команда APIYI
Технические обсуждения: Добро пожаловать в комментарии. Больше материалов можно найти в документации APIYI docs.apiyi.com.