> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cerebras

[Cerebras](https://www.cerebras.ai) предоставляет высокоскоростной, совместимый с OpenAI инференс на специализированном оборудовании. Плагин поставляется со статическим каталогом из четырёх моделей (без динамического обнаружения).

| Свойство | Значение |
| - | - |
| Идентификатор провайдера | `cerebras` |
| Плагин | официальный внешний пакет (`@openclaw/cerebras-provider`) |
| Переменная среды для аутентификации | `CEREBRAS_API_KEY` |
| Флаг первоначальной настройки | `--auth-choice cerebras-api-key` |
| Прямой флаг CLI | `--cerebras-api-key <key>` |
| API | совместимый с OpenAI (`openai-completions`) |
| Базовый URL | `https://api.cerebras.ai/v1` |
| Модель по умолчанию | `cerebras/zai-glm-4.7` |

## Установка плагина

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/cerebras-provider
openclaw gateway restart
```

## Начало работы

**1. Получение ключа API**

Создайте ключ API в [облачной консоли Cerebras](https://cloud.cerebras.ai).

**2. Запуск первоначальной настройки**

```bash Первоначальная настройка theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice cerebras-api-key
```

```bash Прямой флаг theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --auth-choice cerebras-api-key \
  --cerebras-api-key "$CEREBRAS_API_KEY"
```

```bash Только переменная среды theme={"theme":{"light":"min-light","dark":"min-dark"}}
export CEREBRAS_API_KEY=csk-...
```

**3. Проверка доступности моделей**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider cerebras
```

Выводит все четыре статические модели. Если `CEREBRAS_API_KEY` не разрешён, `openclaw models status --json` сообщает об отсутствующих учётных данных в разделе `auth.unusableProfiles`.

## Неинтерактивная настройка

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice cerebras-api-key \
  --cerebras-api-key "$CEREBRAS_API_KEY"
```

## Встроенный каталог

Все четыре модели имеют контекстное окно размером 128k и максимальный объём вывода 8,192 токена.

| Ссылка на модель | Название | Рассуждение | Примечания |
| - | - | - | - |
| `cerebras/zai-glm-4.7` | Z.ai GLM 4.7 | да | Модель по умолчанию; предварительная модель рассуждений |
| `cerebras/gpt-oss-120b` | GPT OSS 120B | да | Рабочая модель рассуждений |
| `cerebras/qwen-3-235b-a22b-instruct-2507` | Qwen 3 235B Instruct | нет | Предварительная модель без рассуждений |
| `cerebras/llama3.1-8b` | Llama 3.1 8B | нет | Рабочая модель с приоритетом скорости |

> [!WARNING]
>
> Cerebras помечает `zai-glm-4.7` и `qwen-3-235b-a22b-instruct-2507` как предварительные модели, а прекращение поддержки `llama3.1-8b` и `qwen-3-235b-a22b-instruct-2507` запланировано в документации на 27 мая 2026 года. Прежде чем использовать их для рабочих нагрузок, проверьте [страницу поддерживаемых моделей](https://inference-docs.cerebras.ai/models/overview) Cerebras.

## Ручная настройка

Для большинства конфигураций требуется только ключ API. Используйте явную конфигурацию `models.providers.cerebras`, чтобы переопределить метаданные модели или работать в режиме `mode: "merge"` со статическим каталогом:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { CEREBRAS_API_KEY: "csk-..." },
  agents: {
    defaults: {
      model: { primary: "cerebras/zai-glm-4.7" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      cerebras: {
        baseUrl: "https://api.cerebras.ai/v1",
        apiKey: "${CEREBRAS_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "zai-glm-4.7", name: "Z.ai GLM 4.7" },
          { id: "gpt-oss-120b", name: "GPT OSS 120B" },
        ],
      },
    },
  },
}
```

> [!NOTE]
>
> Если Gateway работает как фоновая служба (launchd, systemd, Docker), убедитесь, что `CEREBRAS_API_KEY` доступна этому процессу — например, через `~/.openclaw/.env` или `env.shellEnv`. Ключ, экспортированный только в интерактивной оболочке, не будет доступен управляемой службе, если переменные среды не импортированы отдельно.

## Связанные материалы

> [card] [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Режимы мышления](https://docs2.openclaw.ai/ru/tools/thinking.md)
>
> Уровни интенсивности рассуждений для двух моделей Cerebras с поддержкой рассуждений.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/config-agents.md#agent-defaults)
>
> Настройки агентов по умолчанию и конфигурация моделей.

> [card] [Часто задаваемые вопросы о моделях](https://docs2.openclaw.ai/ru/help/faq-models.md)
>
> Профили аутентификации, переключение моделей и устранение ошибок «no profile».