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

Подключение OpenClaw

OpenClaw подключается через файл конфигурации ~/.openclaw/openclaw.json в домашней директории пользователя. Достаточно один раз добавить нашего провайдера, перечислить модели и указать модель по умолчанию — устанавливать плагины или проходить отдельную авторизацию не нужно.

Что потребуется

Как устроена конфигурация

Все правки делаются в одном файле — ~/.openclaw/openclaw.json — и сводятся к трём пунктам:

1.Провайдер — секция models.providers: endpoint, API-ключ и список моделей.

2.Модели — массив models[].id внутри провайдера: ID модели из каталога Wormsoft + отображаемое имя.

3.Модель по умолчанию — agents.defaults.model.primary.

Формат ссылки на модель

Модель по умолчанию указывается в формате <ID провайдера>/<ID модели>:

Модель в конфиге (id)Ссылка для primary
wormsoft/code/highwormsoft/wormsoft/code/high
deepseek/deepseek-v4.1-flash:fastwormsoft/deepseek/deepseek-v4.1-flash:fast
xiaomi/mimo-v2.6-prowormsoft/xiaomi/mimo-v2.6-pro

Пример базовой конфигурации

Рабочий конфиг, в котором ничего лишнего. Замените TOKEN на свой API-ключ и сохраните как ~/.openclaw/openclaw.json:

{
  "gateway": {
    "mode": "local"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "wormsoft": {
        "baseUrl": "https://ai.wormsoft.ru/api/gpt",
        "apiKey": "TOKEN",
        "api": "openai-completions",
        "models": [
          {
            "id": "wormsoft/code/high",
            "name": "Code High"
          },
          {
            "id": "deepseek/deepseek-v4.1-flash:fast",
            "name": "DeepSeek"
          },
          {
            "id": "xiaomi/mimo-v2.6-pro",
            "name": "Mimo 2.6"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "wormsoft/wormsoft/code/high"
      }
    }
  }
}

Что значат поля

ПолеЗначение
gateway.mode"local" — гейтвей работает локально, на вашей машине.
models.mode"merge" — наш провайдер добавляется к встроенному каталогу OpenClaw. Поставьте "replace", чтобы оставить только провайдеров из конфига.
models.providers.wormsoftID провайдера. Имя произвольное, но именно оно становится префиксом в ссылках на модели (wormsoft/...).
baseUrlБазовый URL нашего API.
apiKeyAPI-ключ из личного кабинета. В примере — заглушка TOKEN, замените на свой.
apiПротокол обмена: openai-completions — наш endpoint совместим с OpenAI Chat Completions.
models[].idID модели — точно как в каталоге Wormsoft.
models[].nameОтображаемое имя модели в интерфейсе OpenClaw.
agents.defaults.model.primaryМодель по умолчанию в формате <ID провайдера>/<ID модели>.

Проверьте подключение

1. Выполните openclaw models list — в списке должен появиться провайдер wormsoft с тремя моделями.

2. Отправьте агенту тестовый запрос «Привет!» — если всё настроено верно, ответ придёт через наш API.

Полезные команды:

  • сменить модель в чате: /model
  • назначить модель по умолчанию из CLI: openclaw models set wormsoft/wormsoft/code/high

Возможные проблемы

Gateway не стартует
конфиг не прошёл валидацию: опечатка, лишний или неизвестный ключ. Выполните openclaw doctor (или openclaw doctor --fix) — он укажет на проблему.
unauthorized (401)
неверный API-ключ: не заменили заглушку TOKEN или неверный API ключ — проверьте его в личном кабинете.
Модель не находится
проверьте ссылку на модель: префикс провайдера + точный id из конфига. Помните про задвоенный префикс — wormsoft/wormsoft/code/high.
Изменения не применяются
убедитесь, что правите ~/.openclaw/openclaw.json (а не другой файл) и JSON валиден. Затем выполните openclaw gateway restart.
429
см. страницу Лимиты и ошибки