OpenClaw + laozhang.ai: подключение API и проверка модели

Чтобы подключить установленный OpenClaw к laozhang.ai, добавьте провайдера в models.providers, укажите https://api.laozhang.ai/v1, API Key и модель, доступную вашей группе токена. Для описанного ниже подключения через Chat Completions используется адаптер openai-completions. Затем назначьте модель по умолчанию и проверьте её в нужной сессии: запись в списке моделей ещё не означает, что API отвечает или агент выполняет инструменты.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Начать разумно с gpt-5.4-mini, если ваш токен допускает эту модель: она есть в текущем каталоге и в рекомендациях сервиса для Chat Completions с инструментами. Это основание для первого пробного подключения, а не результат нашего теста OpenClaw. LaoZhang сообщает о собственных проверках потоковых вызовов инструментов 5 октября 2026 года. Рекомендации сервиса.

Что нужно для подключения именно LaoZhang API

На 7 октября 2026 года публичная документация LaoZhang предусматривает одобрение корпоративного доступа через белый список; для регистрации указан Gmail. Поэтому новый пользователь сначала должен получить разрешённый доступ, а уже затем настраивать OpenClaw. Немедленная регистрация и бесплатный стартовый баланс здесь не обещаются. Сервис использует предоплату с последующим списанием за фактическое потребление. Условия доступа, тарификация.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Для самой настройки подготовьте:

• API Key LaoZhang. Учётный AccessToken аккаунта не заменяет ключ для API.
• Точную группу токена и доступный ей ID модели. Публичный каталог показывает предложение сервиса, а не права вашего конкретного ключа.
• Действующий файл конфигурации OpenClaw и способ запуска Gateway: терминал, служба или контейнер. От этого зависит, где процесс получает секрет.
• Сохранённую копию своей конфигурации, чтобы добавление провайдера не уничтожило каналы, агентов, инструменты и другие настройки.

В каталоге на дату обновления модели Claude временно отключены из-за нехватки ресурсов. Не переносите старую конфигурацию Sonnet или Opus в новый рабочий пример без повторной проверки доступности. Число моделей в общем каталоге также не равно числу подходящих моделей для агента: там присутствуют изображения, аудио и другие типы API. Текущий каталог.

Добавьте провайдера в openclaw.json

По умолчанию конфигурация находится в ~/.openclaw/openclaw.json; переменная OPENCLAW_CONFIG_PATH может задавать другой путь. Файл поддерживает JSON5, но имена и типы полей проходят строгую проверку схемы. Работайте с конфигурацией того экземпляра, который запускает ваш Gateway. Конфигурация OpenClaw.

Ниже приведён фрагмент для добавления в существующий файл. Он не заменяет весь файл и не содержит настройки ваших каналов или инструментов. Если разделы models, providers или agents.defaults уже есть, объедините их содержимое, сохранив существующие записи; два одинаковых ключа верхнего уровня создавать не нужно.

{
  "models": {
    "mode": "merge",
    "providers": {
      "laozhang": {
        "baseUrl": "https://api.laozhang.ai/v1",
        "apiKey": "${LAOZHANG_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.4-mini",
            "name": "GPT-5.4 Mini через LaoZhang"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "laozhang/gpt-5.4-mini"
      }
    }
  }
}

Здесь соединяются два разных идентификатора. gpt-5.4-mini — точный ID модели, передаваемый сервису LaoZhang. laozhang/gpt-5.4-mini — полный идентификатор для выбора модели внутри OpenClaw: имя вашего провайдера плюс ID. Если назовёте провайдера иначе, измените и префикс в primary.

mode: "merge" оставляет существующий набор провайдеров и добавляет новый. Это также режим по умолчанию: отсутствие этой строки само по себе не отключает встроенных провайдеров. replace выбирают намеренно, когда требуется заменить набор. Правила пользовательских провайдеров.

Почему важны endpoint и адаптер

В поле baseUrl указан базовый адрес с одним /v1. Дописывать /chat/completions к этому значению в данном примере не нужно: путь запроса определяется адаптером. openai-completions соответствует Chat Completions, где запрос использует messages, а ответ — choices. LaoZhang также документирует Responses, но там другой формат, с input и output, и требуется соответствующий адаптер OpenClaw. Протоколы LaoZhang, адаптеры OpenClaw.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Поддержка OpenAI-совместимого адреса не означает поддержку каждого параметра каждой модели. Не переносите произвольно настройки рассуждения, max_tokens, изображения или флаги совместимости от другого провайдера. В частности, сервис описывает ошибки отдельных сочетаний параметров GPT6 в Chat Completions; наличие той же модели в Responses не делает эти настройки взаимозаменяемыми. Для первого подключения оставьте пример небольшим и добавляйте параметры только по документации выбранной модели. Совместимость инструментов.

Передайте ключ процессу Gateway

Ссылка ${LAOZHANG_API_KEY} убирает секрет из показанного фрагмента, но не создаёт саму переменную. Ключ должен быть доступен процессу, который запускает Gateway. Если Gateway работает как служба или в контейнере, экспорт переменной в другом окне терминала не передаст её уже работающему процессу.

OpenClaw читает окружение родительского процесса, .env в рабочем каталоге и ~/.openclaw/.env. Значения из файлов не перекрывают уже заданные переменные процесса. Это полезно помнить, если вы обновили ключ в .env, а служба продолжает использовать старое значение. Необязательный импорт окружения из оболочки включается отдельно. Порядок загрузки переменных.

Практический порядок такой: определите способ запуска своего Gateway, передайте LAOZHANG_API_KEY через его обычный механизм секретов и оставьте в JSON только ссылку. Не выводите значение командой echo, не отправляйте его в чат и не включайте файл с секретом в Git. Отсутствующая или пустая переменная остаётся неразрешённой ссылкой с предупреждением; это повод исправить доступность секрета для нужного процесса.

Если у вас уже используются SecretRef или отдельный models.json агента, сохраняйте эту организацию. У объединения конфигураций есть собственные правила приоритета: непустой baseUrl в совпадающей записи агентского models.json может иметь приоритет, а ссылки на секреты обрабатываются отдельно. Поэтому исправление только общего openclaw.json не всегда меняет адрес, который реально использует агент. Объединение настроек провайдера.

Разрешите модель и проверьте применение изменений

Модель по умолчанию, разрешённый выбор модели и текущая модель сессии решают разные задачи. agents.defaults.model.primary задаёт основной вариант, но не отменяет ограничения и не обязательно заменяет явно выбранную модель в существующей сессии.

В актуальной схеме OpenClaw, начиная с v2026.8.1, явные ограничения выбора задаёт agents.defaults.modelPolicy.allow — массив полных идентификаторов моделей. Для отдельного агента agents.entries.*.modelPolicy.allow заменяет политику по умолчанию. Карта agents.defaults.models хранит псевдонимы и настройки; считать её обязательным белым списком для любой современной установки неверно. Если ограничение уже настроено, дополните его полным идентификатором laozhang/gpt-5.4-mini в действующем массиве allow, сохранив остальные разрешения. Например, добавьте строку "laozhang/gpt-5.4-mini" к уже разрешённым моделям; отсутствие политики или пустой массив означают неограниченный выбор, поэтому очищать список ради исправления ошибки не следует. Выбор и политика моделей.

На старой или ещё не мигрированной установке прежняя карта моделей может продолжать ограничивать выбор. В этом случае ориентируйтесь на версию и диагностическое сообщение, а не удаляйте карту ради прохождения проверки. doctor --fix способен изменять конфигурацию и сохранять неразрешённые ограничения; это процедура ремонта, а не универсальная проверка без изменений.

После редактирования проверку схемы можно выполнить командой:

openclaw config validate

Успешная проверка говорит о допустимой конфигурации, но не подтверждает права ключа или ответ модели. Для JSON5 завершающая запятая сама по себе не обязательно ошибка; важны разбор файла и схема, а не только внешнее сходство с обычным JSON.

Изменения провайдеров, основных и резервных моделей поддерживают горячее применение. Режим hybrid используется по умолчанию; при off изменения ждут ручного перезапуска. Перезапускать Gateway после любой правки безусловно не требуется. Если внешняя правка некорректна, работающий процесс может сохранить последнюю исправную конфигурацию: содержимое файла на диске ещё не подтверждает применённые настройки. Проверьте сообщения о загрузке и ошибки своего экземпляра. Горячее применение конфигурации.

Проверьте модель, ответ и инструмент по отдельности

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

1. Найдите модель в конфигурации нужного агента

openclaw models list --provider laozhang

В списке должна появиться объявленная модель. Это проверка её присутствия в наборе OpenClaw, а не запрос к каталогу LaoZhang. Пустой список сначала связывайте с выбранным агентом, именем провайдера, активным файлом и объединением настроек. Строка в списке не доказывает валидность ключа.

openclaw models status показывает другую информацию, включая выбранные модели и источники авторизации. Команда может разрешать ссылки на секреты; даже успешный status --check не заменяет реальный ответ API. Команды моделей.

2. Проверьте выбор внутри нужной сессии

В интерфейсе чата OpenClaw используйте:

/model laozhang/gpt-5.4-mini

Проверьте показанный идентификатор текущей модели. Если интерфейс отклоняет выбор как запрещённый, исправляйте разрешение для этого агента и сессии. Если вы хотите вернуться к модели по умолчанию и убрать явное закрепление, используйте /model default. Изменение primary в конфигурации не снимает такое закрепление автоматически. Правила выбора модели.

3. Получите короткий ответ

Отправьте простой запрос, например: «Ответь одним словом: связь». Убедитесь, что ответ относится к текущей попытке и что сессия использует нужный полный идентификатор. Один ответ проверяет этот запрос и выбранный путь подключения; он не подтверждает все модели, длительную нагрузку или поддержку инструментов.

Если при проверке допускается резервная модель, выясните, какая модель фактически ответила. Иначе успешный ответ другого провайдера можно ошибочно принять за успех LaoZhang.

4. Проверьте уже разрешённый инструмент

Для рабочего агента выберите небольшой несекретный тестовый файл в его разрешённой области и попросите прочитать его существующим инструментом. В содержимом должна быть строка, которую агенту не сообщали в запросе. Затем сопоставьте вызов инструмента, его результат и ответ агента с этой строкой.

Фраза модели «я прочитал файл» не подтверждает выполнение. Нужны запись о вызове и возвращённый результат. Если агент лишь описывает, как прочитал бы файл, отдельно проверьте поддержку tools выбранной моделью и доступность инструмента для агента. Не расширяйте файловые или сетевые разрешения только ради теста. В Chat Completions ответ с tool_calls может содержать пустой обычный текст; такой промежуточный ответ сам по себе не означает сетевую ошибку. Формат Chat Completions.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Почему models scan не проверяет LaoZhang

openclaw models scan предназначен для бесплатного набора OpenRouter; по умолчанию он способен делать реальные проверки и менять конфигурацию. Для определения моделей вашего токена LaoZhang эта команда не подходит.

Прямой режим models status --probe выполняет настоящие запросы. Его нельзя трактовать как бесплатную проверку конфигурации: нужны разрешение на расходы и исключительное управление состоянием, включая остановку Gateway и завершение очистки перед возобновлением работы. Для обычной проверки подключения удобнее начать с описанного короткого запроса в своей сессии. Назначение scan и probe.

Если подключение не работает

Сначала отделите ошибки выбора модели в OpenClaw от ответа API LaoZhang. При отказе локальной политики запрос может вообще не попасть к провайдеру. Если API вернул HTTP-код, прочитайте также тело ошибки: одинаковый код не всегда означает одну причину.

Коды и форматы API описаны в руководстве LaoZhang. Для обращения в поддержку достаточно безопасного описания: время, модель, HTTP-код, сообщение ошибки и тип запуска Gateway. Перед передачей журналов удалите ключи, приватные запросы и содержимое файлов; не предполагайте, что любые журналы содержат полные и безопасные для публикации запросы.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Стоимость запросов и резервные модели

На 7 октября 2026 года публичная цена gpt-5.4-mini в группе по умолчанию составляет 0,75 USD за миллион входных и 4,50 USD за миллион выходных токенов; чтение кэша указано отдельно, 0,075 USD за миллион. Это тариф каталога, а фактическое списание зависит от группы токена, режима оплаты и учёта сервиса. Каталог моделей, правила расчёта.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Например, без кэша, при этих ставках и без дополнительного множителя запрос с 10 000 входных и 2 000 выходных токенов стоил бы:

10 000 / 1 000 000 × 0,75 = 0,0075 USD
 2 000 / 1 000 000 × 4,50 = 0,0090 USD
Итого:                         0,0165 USD

Это арифметический пример, а не измеренный расход сессии. Агент может делать несколько запросов, повторно передавать историю и получать результаты инструментов; длинная работа поэтому не равна одному такому запросу. Для своего бюджета ориентируйтесь на фактическое использование, а не на обещание фиксированной суммы в месяц. Поля cost в локальном описании модели не изменяют тариф сервиса; значение ноль там не делает API бесплатным.

Резервные модели добавляют в agents.defaults.model.fallbacks только после проверки их доступности и подключения. Например, если отдельно настроенная и разрешённая модель laozhang/gpt-4o-mini подходит вашей задаче, её можно добавить в этот список. Само упоминание в fallbacks не создаёт провайдера и не выдаёт права токену.

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

Резервирование не оценивает качество ответа и не подбирает самую дешёвую модель. Две модели через один LaoZhang API могут зависеть от общего баланса или одной недоступной инфраструктуры, поэтому их наличие не гарантирует восстановления при сбое всего сервиса. Для возврата с закреплённой модели к обычному выбору используйте /model default, а для оценки расходов сравнивайте реально использованные модели и токены.

Вопросы о подключении OpenClaw к laozhang.ai

Нужен ключ OpenAI или ключ LaoZhang?

Для адреса https://api.laozhang.ai/v1 нужен API Key LaoZhang. Ключ другого провайдера и AccessToken аккаунта его не заменяют. Имя модели GPT не означает, что запрос пойдёт напрямую в OpenAI. Авторизация LaoZhang.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Можно ли сейчас выбрать Claude через LaoZhang?

На дату обновления, 7 октября 2026 года, каталог помечает Claude как временно отключённые модели. Старый ID в конфигурации не подтверждает доступность. Возвращайтесь к такому подключению после проверки актуального каталога и прав своей группы токена. Каталог LaoZhang.

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

В сессии может быть явно закреплена другая модель или действовать настройка конкретного агента. /model default снимает закрепление и возвращает выбор по умолчанию; затем проверьте показанный полный идентификатор. Изменение только primary не гарантирует замену модели во всех существующих сессиях. Выбор модели в OpenClaw.

Означает ли успешный models status, что ключ работает?

Нет. Статус и наличие источника ключа не подтверждают успешный запрос к модели. Нужен реальный ответ выбранной модели, а для агента с инструментами — отдельно подтверждённый вызов разрешённого инструмента. Режим --probe делает реальные запросы и требует отдельной подготовки состояния. Команды моделей.

Даёт ли подключение GPT через LaoZhang доступ к подписке ChatGPT или Codex?

Нет: этот пример настраивает платный маршрут API через LaoZhang. Название провайдера или модели в OpenClaw не подтверждает доступ к нативному продукту Codex и не переносит лимиты подписки ChatGPT. Условия этого маршрута определяют токен и тарификация LaoZhang. Протоколы и ключи, оплата API.

Если ваша следующая задача — сравнить облачный API с локальными Ollama и LM Studio, используйте руководство по настройке LLM в OpenClaw. Для нынешнего подключения достаточно закрепить проверенный путь: доступный токен, точный ID, подходящий адаптер, правильная модель сессии и подтверждённый результат инструмента.