Перейти к основному содержимому

OpenClaw

OpenClaw — агентская платформа с каналами связи, планировщиком задач и подключаемыми инструментами. Модели задаются в конфигурации платформы.

Провайдер

В файле конфигурации openclaw.json добавьте провайдера в раздел models.providers:

{
"models": {
"providers": {
"itg-aiaas": {
"baseUrl": "https://<адрес_шлюза>/v1",
"api": "openai-completions",
"apiKey": {
"source": "env",
"id": "AIAAS_API_KEY"
},
"models": [
{
"id": "opr.deepseek4_flash.chat_completions",
"name": "opr.deepseek4_flash.chat_completions",
"api": "openai-completions",
"reasoning": true,
"input": ["text"],
"contextWindow": 1048576,
"maxTokens": 8192
}
]
}
}
}
}

Ключ не хранится в конфигурации — он берётся из переменной окружения, имя которой указано в apiKey.id. Это удобно: конфигурацию можно держать под контролем версий, ключ в неё не попадёт.

export AIAAS_API_KEY="<ВАШ_КЛЮЧ>"

Параметры модели

ПолеНазначение
idПолный идентификатор модели на шлюзе
apiПротокол — openai-completions
reasoningПоддерживает ли модель режим рассуждений
inputТипы входных данных: text, при поддержке — image
contextWindowРазмер контекстного окна
maxTokensОграничение на длину ответа

Значения контекста и возможностей по каждой модели — на странице доступные модели.

Ссылки на модели

В остальных частях конфигурации модель указывается с префиксом провайдера через косую черту:

itg-aiaas/opr.deepseek4_flash.chat_completions

Если нужно разрешить все модели провайдера без перечисления, поддерживается шаблон:

"itg-aiaas/*": {}

Это удобно на старте, но лишает контроля над тем, какие модели фактически используются, — а от модели зависит стоимость обращения. Для рабочих конфигураций перечисляйте модели явно.

Проверка

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

Если не работает

СимптомПричина и что делать
401 UnauthorizedПеременная окружения не задана в том окружении, где работает агент. Проверьте, что она видна процессу, а не только вашей оболочке
Модель не находитсяИдентификатор в ссылке должен совпадать с id в блоке models целиком, включая префикс провайдера
Работает из терминала, но не из фоновой задачиФоновые процессы не наследуют переменные оболочки. Задайте ключ в окружении службы