OpenClaw Руководство по настройке
OpenClaw добавляет поставщиков пользовательских моделей через models.providers. ai2save использует интерфейс OpenAI Compatible, Base URL должен быть заполнен https://ai2save.com/v1.
1. Подготовка OpenClaw и API Key
Если OpenClaw уже установлен, можно пропустить установку:
npm install -g openclaw@latest
openclaw --version
- Откройте https://ai2save.com/keys.
- Создайте API Key, принадлежащий группе моделей OpenAI / GPT.
- Скопируйте полный ключ
sk-....
2. Редактирование конфигурационного файла OpenClaw
Файл конфигурации по умолчанию для OpenClaw:
~/.openclaw/openclaw.json
Windows обычно находится в %USERPROFILE%\.openclaw\openclaw.json. Файл поддерживает JSON5, его можно объединить с существующей конфигурацией по следующей структуре:
{
env: {
vars: {
AI2SAVE_API_KEY: "sk-ваш-api-ключ",
},
},
agents: {
defaults: {
model: {
primary: "ai2save/gpt-5.5",
},
},
},
models: {
mode: "merge",
providers: {
ai2save: {
baseUrl: "https://ai2save.com/v1",
apiKey: "${AI2SAVE_API_KEY}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "gpt-5.5",
name: "GPT 5.5",
reasoning: true,
input: ["text"],
contextWindow: 200000,
},
],
},
},
},
}
Описание ключевых полей:
models.providers.ai2save.baseUrl: должен использоваться вместе с/v1.api: "openai-completions": тип интерфейса, используемого OpenClaw для работы с OpenAI Compatible черезпрокси.models[].id: должен точно совпадать с ID модели, открытой в консоли ai2save.agents.defaults.model.primary: формат соответствуетидентификатор-провайдера/идентификатор-модели.apiKeyможно напрямую написать как"sk-..."; при использовании через${AI2SAVE_API_KEY}необходимо определить его вenv.vars.
Если нужно добавить несколько моделей, продолжайте добавлять их в массив models и измените primary на желаемый ai2save/model-id по умолчанию.
3. Применение и проверка конфигурации
OpenClaw Gateway будет отслеживать изменения в конфигурационном файле и автоматически применять их. Если конфигурация не вступает в силу вовремя, выполните:
openclaw gateway restart
Затем проверьте, появлялась ли модель уже в OpenClaw:
openclaw models list --provider ai2save
Переключите модель по умолчанию на ai2save:
openclaw models set ai2save/gpt-5.5
Если модель не появилась, выполните диагностику и проверьте ошибки конфигурации:
openclaw doctor
4. Проверка запроса
- Откройте интерфейс чата OpenClaw или WebChat.
- Создайте новый сеанс и отправьте «Здравствуйте, пожалуйста, сообщите название текущей модели».
- Убедитесь, что маршрут модели отображается как
ai2save/gpt-5.5. - Сначала проверяйте только текстовые задачи; после успешной проверки можно включить файлы, браузер, длинный контекст и другие сложные инструменты.
OpenClaw автоматически выполняет совместимость с неофициальными агентами OpenAI, включение developer role вручную не требуется. Если возникает ошибка вызова инструмента, сначала убедитесь, что ID модели поддерживает вызов инструментов, затем увеличьте время ожидания.
5. Частые ошибки
- 401 / invalid_api_key:
AI2SAVE_API_KEYне определен, ключ скопирован неполностью или группа ключей не совпадает. - 404 / model not found:
models[].id,primaryили фактическое имя запрашиваемой модели не совпадает. - Сбой соединения / пустой ответ: проверьте, является ли
baseUrlhttps://ai2save.com/v1, не используйте корневой адрес. - Список моделей пуст: подтвердите
models.mode: "merge"и убедитесь, чтоmodels.providers.ai2save.models[]включает хотя бы одну модель. - Настройки не применились после сохранения: повторно выполните
openclaw doctor, при необходимости перезапустите OpenClaw Gateway.