---
read_when:
    - Вы хотите интерактивно настроить учетные данные, устройства или параметры агентов по умолчанию
summary: Справочник CLI для `openclaw configure` (интерактивные запросы настройки)
title: Настройка
x-i18n:
    generated_at: "2026-06-28T22:42:31Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 55178b3d772297686aeead9799b97dd5d836b908baabde1fce7918d38446fcff
    source_path: cli/configure.md
    workflow: 16
---

# `openclaw configure`

Интерактивный запрос для целевых изменений существующей настройки: учетные данные, устройства, значения по умолчанию для агентов, Gateway, каналы, плагины, Skills и проверки работоспособности.

Используйте `openclaw onboard` для полного пошагового первого запуска, `openclaw setup` только для базовой конфигурации/рабочей области, а `openclaw channels add`, когда нужна только настройка учетной записи канала.

<Note>
Раздел **Модель** включает множественный выбор для списка разрешенных `agents.defaults.models` (то, что отображается в `/model` и в средстве выбора модели). Варианты настройки, ограниченные провайдером, добавляют выбранные модели в существующий список разрешенных, а не заменяют несвязанных провайдеров, уже присутствующих в конфигурации.

Повторный запуск аутентификации провайдера из configure сохраняет существующее значение `agents.defaults.model.primary`, даже когда шаг аутентификации провайдера возвращает патч конфигурации с собственной рекомендуемой моделью по умолчанию. Это означает, что добавление или повторная аутентификация xAI, OpenRouter или другого провайдера должна сделать новую модель доступной, не заменяя текущую основную модель. Используйте `openclaw models auth login --provider <id> --set-default` или `openclaw models set <model>`, когда вы намеренно хотите изменить модель по умолчанию.
</Note>

Когда configure запускается с выбора аутентификации провайдера, средства выбора модели по умолчанию и списка разрешенных автоматически отдают предпочтение этому провайдеру. Для парных провайдеров, таких как Volcengine и BytePlus, то же предпочтение также соответствует их вариантам плана для программирования (`volcengine-plan/*`, `byteplus-plan/*`). Если фильтр предпочитаемого провайдера дал бы пустой список, configure возвращается к нефильтрованному каталогу вместо того, чтобы показывать пустой выбор.

<Tip>
`openclaw config` без подкоманды открывает тот же мастер. Используйте `openclaw config get|set|unset` для неинтерактивных правок.
</Tip>

Для веб-поиска `openclaw configure --section web` позволяет выбрать провайдера
и настроить его учетные данные. Некоторые провайдеры также показывают
дополнительные последующие запросы, зависящие от провайдера:

- **Grok** может предложить необязательную настройку `x_search` с тем же профилем xAI OAuth
  или API-ключом и позволить выбрать модель `x_search`.
- **Kimi** может запросить регион Moonshot API (`api.moonshot.ai` или
  `api.moonshot.cn`) и модель веб-поиска Kimi по умолчанию.

См. также:

- Справочник конфигурации Gateway: [Конфигурация](/ru/gateway/configuration)
- CLI конфигурации: [Конфигурация](/ru/cli/config)

## Параметры

- `--section <section>`: повторяемый фильтр разделов

Доступные разделы:

- `workspace`
- `model`
- `web`
- `gateway`
- `daemon`
- `channels`
- `plugins`
- `skills`
- `health`

Примечания:

- Полный мастер и разделы, связанные с Gateway, спрашивают, где работает Gateway, и обновляют `gateway.mode`. Фильтры разделов, которые не включают `gateway`, `daemon` или `health`, переходят непосредственно к запрошенной настройке.
- После записи локальной конфигурации configure устанавливает выбранные загружаемые плагины, когда выбранный путь настройки требует их. Конфигурация удаленного Gateway не устанавливает локальные пакеты плагинов.
- Сервисы, ориентированные на каналы (Slack/Discord/Matrix/Microsoft Teams), во время настройки запрашивают списки разрешенных каналов/комнат. Можно вводить имена или ID; мастер по возможности преобразует имена в ID.
- Если вы запускаете шаг установки демона, аутентификация по токену требует токен, а `gateway.auth.token` управляется через SecretRef, configure проверяет SecretRef, но не сохраняет разрешенные значения токена в открытом тексте в метаданные окружения supervisor-сервиса.
- Если аутентификация по токену требует токен, а настроенный SecretRef токена не разрешен, configure блокирует установку демона с практическими указаниями по исправлению.
- Если настроены и `gateway.auth.token`, и `gateway.auth.password`, а `gateway.auth.mode` не задан, configure блокирует установку демона, пока режим не будет задан явно.

## Примеры

```bash
openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon
```

## См. также

- [Справочник CLI](/ru/cli)
- [Конфигурация](/ru/gateway/configuration)
