OpenClaw

OpenClaw — консольный AI-ассистент для программирования, который поддерживает подключение к API-сервисам, совместимым с OpenAI, через кастомного провайдера. Официально рекомендуется пройти мастер openclaw onboard, но можно и вручную написать файл конфигурации.

ПодготовкаКопировать ссылку на якорь

Убедитесь, что система соответствует требованиям:

• Node.js версии 22+
• macOS / Linux / Windows
• При сборке из исходников дополнительно требуется pnpm

Установка Node.jsКопировать ссылку на якорь

macOS (через Homebrew):

brew install node

Другие системы:

Скачайте LTS-версию с официального сайта Node.js: https://nodejs.org/en/download

Проверка установкиКопировать ссылку на якорь

node -v
npm -v

Примечание: пользователям Windows рекомендуется запускать OpenClaw в среде WSL2.

Установка OpenClawКопировать ссылку на якорь

Официальный установочный скрипт (рекомендуется):

macOS / LinuxКопировать ссылку на якорь

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShellКопировать ссылку на якорь

iwr -useb https://openclaw.ai/install.ps1 | iex

Скрипт автоматически определит и доустановит недостающие зависимости. Если вы сами управляете окружением Node, можно установить через npm или pnpm (подробнее в официальной документации).

Запуск мастера настройкиКопировать ссылку на якорь

Выполните команду мастера:

openclaw onboard

В мастере последовательно заполните следующие данные:

• Тип провайдера: выберите Custom Provider
• Compatibility: выберите OpenAI-compatible
• Base URL: https://aicentos.com/v1
• API Key: ваш API Key
• Model ID: имя модели из «витрины моделей» в консоли
• Endpoint ID: рекомендуется указать aicentos

Примечание: API Key можно сразу ввести открытым текстом, дополнительно менять его на переменную окружения OPENAI_API_KEY не нужно.

Задание модели по умолчаниюКопировать ссылку на якорь

После завершения мастера задайте модель по умолчанию:

aicentos/gpt-4o

Далее при работе будет автоматически использоваться настроенная модель.

Ручная настройка (опционально)Копировать ссылку на якорь

Если не хотите проходить мастер, можно сразу написать файл конфигурации провайдеров OpenClaw:

{
  "models": {
    "providers": {
      "aicentos": {
        "baseUrl": "https://aicentos.com/v1",
        "apiKey": "your_api_key_here",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "gpt-4o" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "aicentos/gpt-4o" }
    }
  }
}

В конфигурации можно указать API Key открытым текстом либо использовать ссылку на переменную окружения (если вам ближе подход SecretRef).

Проверка конфигурацииКопировать ссылку на якорь

Проверьте состояние моделей, чтобы убедиться в успешном подключении:

openclaw models list
openclaw models status

Если виден aicentos/gpt-4o и статус отображается как нормальный, конфигурация подключения выполнена успешно.

ПримечанияКопировать ссылку на якорь

• OpenClaw официально поддерживает функцию кастомных провайдеров: можно выбрать режим OpenAI-compatible или Anthropic-compatible
• Для текущего сервиса рекомендуем в первую очередь режим OpenAI-compatible
• Ввод API Key открытым текстом — поведение по умолчанию; ссылка на переменную окружения — лишь опциональный вариант
• Если хотите, чтобы конфигурацию записал автоматический инструмент, обратите внимание на утилиту cc-switch
• В официальной документации есть и другие способы установки и настройки — выбирайте по фактическим потребностям

Полезные ссылкиКопировать ссылку на якорь

• Официальная документация: https://docs.openclaw.ai/install/index