Настройка OpenClaw
OpenClaw — это инструмент с терминальным и веб-интерфейсом, ориентированный на сценарии программирования. Он поддерживает протоколы различных моделей, поэтому ключевой момент настройки — не просто указать адрес, а согласовать поля baseUrl и api в пары.
Официальная информация Загрузки и документация приведены согласно официальному сайту.
Что это за инструмент и для чего он нужен
Сначала выберите подходящий протокол
| Сценарий | Как указать Base URL | Как выбрать поле API |
|---|---|---|
| Нативный OpenAI | Используйте предоставленный провайдером адрес OpenAI / OpenAI-совместимого API; необходимость добавления /v1 зависит от бэкенда | openai-responses |
| Нативный Claude | Используйте предоставленный провайдером адрес интерфейса Anthropic / Claude | anthropic-messages |
| Нативный Gemini | Используйте предоставленный провайдером адрес интерфейса Google / Gemini | google-generative-ai |
| Режим совместимости | OpenAI-совместимый адрес интерфейса провайдера | openai-completions |
Если на странице провайдера интерфейсы OpenAI, Claude и Gemini разделены, не копируйте только доменное имя — копируйте полный адрес для соответствующего протокола.
Пример фрагмента конфигурации
Файл конфигурации обычно находится по пути ~/. openclaw/openclaw.json Если мастер начальной настройки не может корректно указать адрес провайдера, можно сначала пропустить выбор модели, а затем отредактировать конфигурационный файл вручную.
Пример фрагмента с одним провайдером для OpenClaw
"models": { "providers": { "mz-openai": { "baseUrl": "https://YOUR_PROVIDER_API_URL", "apiKey": "YOUR_KEY", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "MODEL_ID_FROM_PROVIDER_DASHBOARD", "name": "DISPLAY_NAME", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }Как проверить после сохранения
- Сначала настройте только одного провайдера и не добавляйте сразу много моделей.
- Войдите в тестовый проект и выберите добавленную модель.
- Отправьте максимально короткий запрос, например: «Пожалуйста, ответь только: конфигурация успешна».
- Если возникает ошибка протокола, сначала проверьте, соответствуют ли поле api и Base URL одному и тому же типу интерфейса.
Частые вопросы начинающих
| Проблема | Что проверить в первую очередь | Что делать |
|---|---|---|
| Ошибка, связанная с протоколом | Соответствие поля api адресу Base URL | Не смешивайте OpenAI, Claude и Gemini; заполняйте данные в соответствии с протоколом провайдера |
| Список моделей пуст | Поддерживает ли провайдер получение списка моделей? | Если автоматическая загрузка не удалась, введите ID или название модели из панели управления вручную |
| Файл конфигурации изменен, но изменения не применяются | Тот ли конфигурационный файл был отредактирован, который считывает OpenClaw | Перезапустите OpenClaw и повторите проверку; не меняйте несколько параметров конфигурации одновременно |
| Ключ правильный, но подключение не работает | Поля auth и apiKey текущего провайдера | Убедитесь, что ключ соответствует текущему протоколу и выбранному провайдеру |
Официальный сайт OpenClaw Обзор инструмента и точка входа.
Справочник по настройке AI-провайдера в OpenClaw Ознакомьтесь с принципом парной настройки полей baseUrl и api для различных протоколов.