ai2saveai2save

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
  1. Откройте https://ai2save.com/keys.
  2. Создайте API Key, принадлежащий группе моделей OpenAI / GPT.
  3. Скопируйте полный ключ 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. Проверка запроса

  1. Откройте интерфейс чата OpenClaw или WebChat.
  2. Создайте новый сеанс и отправьте «Здравствуйте, пожалуйста, сообщите название текущей модели».
  3. Убедитесь, что маршрут модели отображается как ai2save/gpt-5.5.
  4. Сначала проверяйте только текстовые задачи; после успешной проверки можно включить файлы, браузер, длинный контекст и другие сложные инструменты.

OpenClaw автоматически выполняет совместимость с неофициальными агентами OpenAI, включение developer role вручную не требуется. Если возникает ошибка вызова инструмента, сначала убедитесь, что ID модели поддерживает вызов инструментов, затем увеличьте время ожидания.

5. Частые ошибки

  • 401 / invalid_api_key: AI2SAVE_API_KEY не определен, ключ скопирован неполностью или группа ключей не совпадает.
  • 404 / model not found: models[].id, primary или фактическое имя запрашиваемой модели не совпадает.
  • Сбой соединения / пустой ответ: проверьте, является ли baseUrl https://ai2save.com/v1, не используйте корневой адрес.
  • Список моделей пуст: подтвердите models.mode: "merge" и убедитесь, что models.providers.ai2save.models[] включает хотя бы одну модель.
  • Настройки не применились после сохранения: повторно выполните openclaw doctor, при необходимости перезапустите OpenClaw Gateway.