OpenClaw с OdiRouter позволяет агенту OpenClaw использовать пользовательского провайдера моделей, совместимого с OpenAI. Настройка занимает немного времени, однако идентификатор провайдера, формат API, базовый URL и идентификатор модели должны совпадать. Начните с актуального OdiRouter OpenClaw integration guide, затем используйте эту страницу для настройки и проверки подключения.
Что вам понадобится перед редактированием конфигурации
Установите или обновите OpenClaw в соответствии с его актуальной документацией. В руководстве по интеграции OdiRouter используется следующий путь первоначальной настройки:
npm install -g openclaw@latest
openclaw onboard --install-daemonСоздайте API-ключ OdiRouter перед добавлением провайдера. Не сохраняйте ключ в системе контроля версий, истории оболочки, скриншотах или сообщениях чата. OdiRouter getting-started documentation посвящён первоначальной настройке API-ключа и учётной записи.
OpenClaw может меняться в разных релизах. Если в вашей установке используются другие поля, команды или пути, воспользуйтесь актуальными руководствами по интеграции OpenClaw documentation и OdiRouter, а не адаптируйте старый пример.
Добавьте OdiRouter как провайдера OpenClaw
OpenClaw считывает пользовательских провайдеров моделей из ~/.openclaw/openclaw.json. В актуальном руководстве ниже перечислены все параметры провайдера.
Добавьте или объедините блок поставщика ниже. Замените ключ YOUR_API_KEY на вашем устройстве своим собственным ключом. Не следует указывать реальный ключ, если файл является общим.
{
"models": {
"providers": {
"odirouter": {
"api": "openai-completions",
"baseUrl": "https://api.odirouter.ai/v1",
"apiKey": "YOUR_API_KEY",
"models": [
{ "id": "gpt-5.6-sol", "name": "GPT-5.6 SOL" }
]
}
}
}
}Имя odirouter — это идентификатор поставщика, используемый в остальных настройках OpenClaw. Список моделей предоставляет OpenClaw одобренные идентификаторы моделей OdiRouter. Перед изменением идентификатора проверьте код OdiRouter model catalogue, поскольку наличие товара и названия могут меняться.
Установите модель для агента по умолчанию
После добавления провайдера укажите модель в формате provider-id/model-id. В приведённом выше примере для параметра default-agent установлено значение odirouter/gpt-5.6-sol.
{
"agents": {
"defaults": {
"model": {
"primary": "odirouter/gpt-5.6-sol"
},
"models": {
"odirouter/gpt-5.6-sol": {}
}
}
}
}Поддерживайте эту ссылку синхронизированной с блоком провайдера. Агент, указывающий на другого провайдера, не может использовать настроенные вами ключ или модель. Если вы добавляете резервные модели, добавьте каждую из них в массив models провайдера и в карту моделей агента.
Перезапустите и проверьте подключение
После сохранения конфигурации перезапустите шлюз:
openclaw gateway restart
openclaw models status --plain
openclaw agent --agent main -m "hi" --jsonКоманда статуса показывает, может ли OpenClaw разрешить провайдера и модель. Затем небольшой запрос агента проверяет путь к выбранной модели. Если это не удаётся, используйте ошибку, чтобы сузить поиск проблемы в конфигурации. Не вставляйте секрет в терминал или в запрос в службу поддержки.
Устранение распространённых несоответствий
OpenClaw сообщает, что у провайдера нет ключа API
Сначала проверьте models.providers.odirouter.apiKey. Убедитесь, что у него есть действительный локальный ключ OdiRouter и что запущенный процесс OpenClaw читает отредактированный вами файл. Затем проверьте, не определяет ли другой файл конфигурации тот же идентификатор провайдера.
OpenClaw не может найти выбранную модель
Сравните значение models.providers.odirouter.models, значение агента по умолчанию primary и карту agents.defaults.models. Идентификатор должен быть доступным идентификатором модели OdiRouter, а в полной справочной информации об агенте должен использоваться тот же идентификатор поставщика.
Запрос направляется на неверную конечную точку или завершается сбоем после обновления
Убедитесь, что API провайдера — openai-completions, а baseUrl точно соответствует https://api.odirouter.ai/v1. Затем сравните файл с актуальной документацией по конфигурации OdiRouter API reference и OpenClaw. Не используйте конечную точку, скопированную у другого провайдера.
Шлюз работает, но конфигурация по-прежнему выглядит неизменённой
Используйте эти команды для проверки состояния службы и отслеживания ее журналов во время внесения небольших, обратимых исправлений:
openclaw gateway status
openclaw logs --followПосле исправления один раз перезапустите шлюз. Затем снова выполните команду статуса и небольшой запрос агента. Такая последовательность обычно позволяет отличить проблему конфигурации от более масштабной проблемы рабочего процесса.
Поддерживайте интеграцию в удобном для сопровождения состоянии
Этот пример — отправная точка, а не гарантия того, что каждый выпуск OpenClaw будет работать одинаково. Храните руководство по интеграции OdiRouter вместе с заметками о развёртывании, проверяйте идентификаторы моделей перед изменением значений по умолчанию и выполняйте небольшой запрос после обновления OpenClaw. Если конфигурация управляется как код, версионируйте её структуру и внедряйте ключ API через утверждённый процесс управления секретами.
Для текущей настройки используйте OdiRouter OpenClaw integration guide. Для подключения к API и поиска моделей используйте OdiRouter documentation и OdiRouter model catalogue.