Как подключить GPT API к OpenClaw

OpenClaw подключает пользовательские OpenAI-compatible endpoints через models.providers. Для рабочего провайдера нужно объявить Base URL, API adapter, секрет и каталог model ID, а затем выбрать модель в формате provider/model.

Сначала зарегистрируйтесь, пополните баланс и только после зачисления выберите модель. Для основной универсальной работы используйте gpt-5.6-terra; для экономичных шагов — gpt-5.6-luna. Отдельный ключ создайте на странице API-ключей.

Сначала проверьте API

curl https://api.apiprovider.pro/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIPROVIDER_API_KEY" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "user", "content": "Ответь одной строкой: API подключён."}
    ]
  }'

Если прямой запрос не проходит, сначала исправьте ключ, баланс, endpoint или model ID. Конфигурация OpenClaw не устранит ошибку доступа к API.

Как получить GPT API-ключ Настройка первого запроса

Добавьте пользовательского провайдера

Ниже приведён фрагмент openclaw.json в формате JSON5. Он добавляет два model ID и выбирает Terra как основную модель:

{
  agents: {
    defaults: {
      model: { primary: "apiprovider/gpt-5.6-terra" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      apiprovider: {
        baseUrl: "https://api.apiprovider.pro/v1",
        apiKey: "${APIPROVIDER_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.6-terra",
            name: "GPT-5.6 Terra",
            input: ["text"],
            contextWindow: 1000000,
            maxTokens: 128000,
          },
          {
            id: "gpt-5.6-luna",
            name: "GPT-5.6 Luna",
            input: ["text"],
            contextWindow: 1050000,
            maxTokens: 128000,
          },
        ],
      },
    },
  },
}

Значение api: "openai-completions" использует маршрут /v1/chat/completions. Внутри models[] указываются provider-local ID без префикса. При выборе модели OpenClaw добавляет префикс: apiprovider/gpt-5.6-terra.

Контекст и max output взяты из актуального публичного каталога на дату проверки. Перед изменением модели сверяйте документацию и цены.

Используйте RU endpoint

Если Gateway работает через российский маршрут, замените только baseUrl:

baseUrl: "https://api.ru.apiprovider.pro/v1"

Ключ, model ID и API adapter остаются теми же.

Безопасно передайте ключ

Задайте APIPROVIDER_API_KEY в окружении процесса Gateway или используйте поддерживаемый OpenClaw SecretRef. Не помещайте действующий ключ в репозиторий, общий openclaw.json, промпты или логи.

Перед изменением существующей конфигурации сначала получите текущий объект и добавьте новый provider с merge-семантикой. Не заменяйте целиком models.providers, если там уже есть другие интеграции.

После изменения конфигурации примените её штатным способом вашей установки и проверьте, что OpenClaw видит обе модели. Не публикуйте конфиг со значением секрета при диагностике.

Какую модель выбрать

• apiprovider/gpt-5.6-terra — основная универсальная модель после пополнения;
• apiprovider/gpt-5.6-luna — экономичные массовые и подготовительные шаги.

Если добавляете другие model ID, сначала подтвердите их через GET /v1/models, затем внесите отдельные записи в models.providers.apiprovider.models.

Как выбрать GPT-модель OpenAI-compatible API: общая схема

Проверка после настройки

1. Убедитесь, что модель отображается как apiprovider/gpt-5.6-terra.
2. Создайте безопасную тестовую задачу без конфиденциальных данных.
3. Проверьте ответ, model ref и расход в кабинете.
4. Убедитесь, что ключ не попал в логи или экспорт конфигурации.
5. Проверьте fallback и лимиты до включения автоматических задач.

При 401 проверьте секрет, при 402 — баланс, при 404 — model ID, при 429 — частоту запросов. Для 5xx используйте только ограниченные повторы с паузой.

Частые вопросы

Почему модели записаны дважды?

models.providers.apiprovider.models[] регистрирует provider-local модели, а agents.defaults.model.primary выбирает одну из них в формате provider/model.

Можно ли указать только agents.defaults.models?

Нет. Этот раздел управляет видимостью и metadata, но сам по себе не регистрирует новую runtime-модель пользовательского провайдера.

Какой API adapter нужен?

Для проверенного /v1/chat/completions используйте openai-completions.

Нужен ли отдельный ключ для OpenClaw?

Технически нет, но отдельный ключ упрощает отзыв доступа и контроль расходов установки.

Следующий шаг

Создайте аккаунт, пополните баланс, выпустите отдельный ключ и добавьте provider без удаления существующих настроек. Начните с Terra, а Luna подключите для экономичных этапов.