# OpenClaw

Источник: https://docs.aicentos.com/ru/clients/openclaw

Language: ru

> Использование aicentos в OpenClaw — подключение через кастомного провайдера

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

## Подготовка

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

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

### Установка Node.js

**macOS (через Homebrew):**

```bash
brew install node
```

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

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

### Проверка установки

```bash
node -v
npm -v
```

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

## Установка OpenClaw

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

### macOS / Linux

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

### Windows PowerShell

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

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

## Запуск мастера настройки

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

```bash
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` не нужно.

## Задание модели по умолчанию

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

```text
aicentos/gpt-4o
```

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

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

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

```json
{
  "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).

## Проверка конфигурации

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

```bash
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](https://docs.openclaw.ai/install/index)