--- read_when: - Вы хотите просматривать или изменять конфигурацию в неинтерактивном режиме sidebarTitle: Config summary: Справочник CLI для `openclaw config` (get/set/patch/unset/file/schema/validate) title: Конфигурация x-i18n: generated_at: "2026-07-16T16:17:22Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: 63be5cbac6c7db9c6b93ad690e5decab9f4ce7904e8b10f26a3b1e39e4729450 source_path: cli/config.md workflow: 16 --- Неинтерактивные вспомогательные команды для `openclaw.json`: получить/задать/частично изменить/удалить значение по пути, вывести схему, проверить конфигурацию или вывести путь к активному файлу. Запустите `openclaw config` без подкоманды, чтобы открыть тот же пошаговый мастер, что и `openclaw configure`. Когда `OPENCLAW_NIX_MODE=1`, OpenClaw считает `openclaw.json` неизменяемым. Команды только для чтения (`config get`, `config file`, `config schema`, `config validate`) по-прежнему работают; команды записи конфигурации отклоняются. Вместо этого измените исходный код Nix для установки; для официального дистрибутива nix-openclaw воспользуйтесь [кратким руководством по nix-openclaw](https://github.com/openclaw/nix-openclaw#quick-start) и задайте значения в `programs.openclaw.config` или `instances..config`. ## Корневые параметры Повторяемый фильтр разделов пошаговой настройки при запуске `openclaw config` без подкоманды. Разделы пошаговой настройки: `workspace`, `model`, `web`, `gateway`, `daemon`, `channels`, `plugins`, `skills`, `health`. ## Примеры ```bash openclaw config file openclaw config --section model openclaw config --section gateway --section daemon openclaw config schema openclaw config get browser.executablePath openclaw config set browser.executablePath "/usr/bin/google-chrome" openclaw config set browser.profiles.work.executablePath "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" openclaw config set agents.defaults.heartbeat.every "2h" openclaw config set 'agents.list[0].tools.exec.node' "node-id-or-name" openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN openclaw config set secrets.providers.vaultfile --provider-source file --provider-path /etc/openclaw/secrets.json --provider-mode json openclaw config patch --file ./openclaw.patch.json5 --dry-run openclaw config unset plugins.entries.brave.config.webSearch.apiKey openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN --dry-run openclaw config validate openclaw config validate --json ``` ### Пути Точечная или скобочная нотация. Заключайте пути со скобками в кавычки в примерах для оболочки, чтобы zsh не раскрывала `[0]` как шаблон: ```bash openclaw config get agents.defaults.workspace openclaw config get 'agents.list[0].id' openclaw config get agents.list openclaw config set 'agents.list[1].tools.exec.node' "node-id-or-name" ``` ### `config get` Считывает значение из редактированного снимка конфигурации (секреты никогда не выводятся). `--json` выводит исходное значение в формате JSON; иначе строки, числа и логические значения выводятся без оформления, а объекты и массивы — как форматированный JSON. ```bash openclaw config get browser.executablePath openclaw config get agents.defaults.model --json ``` ### `config file` Выводит путь к активному файлу конфигурации, определённый из `OPENCLAW_CONFIG_PATH` или расположения по умолчанию. Путь указывает на обычный файл, а не на символическую ссылку; см. [Безопасность записи](#write-safety). ### `config schema` Выводит созданную схему JSON для `openclaw.json` в стандартный вывод. - Текущая корневая схема конфигурации, а также корневое строковое поле `$schema` для инструментов редактора. - Метаданные документации полей `title` / `description`, используемые Control UI. - Узлы вложенных объектов, подстановочных знаков (`*`) и элементов массивов (`[]`) наследуют те же метаданные `title` / `description`, когда существует соответствующая документация полей. - Ветви `anyOf` / `oneOf` / `allOf` также наследуют те же метаданные документации. - Получаемые по мере возможности актуальные метаданные схем плагинов и каналов, когда можно загрузить манифесты среды выполнения. - Корректная резервная схема, даже если текущая конфигурация недопустима. `config.schema.lookup` возвращает один нормализованный путь конфигурации с неглубоким узлом схемы (`title`, `description`, `type`, `enum`, `const`, общие ограничения), соответствующими метаданными подсказок интерфейса и сводками непосредственных дочерних элементов. Используйте его для детализации по пути в Control UI или пользовательских клиентах. ```bash openclaw config schema openclaw config schema > openclaw.schema.json ``` ### `config validate` Проверяет текущую конфигурацию по активной схеме без запуска Gateway. ```bash openclaw config validate openclaw config validate --json ``` Если проверка уже завершается ошибкой, начните с `openclaw configure` или `openclaw doctor --fix`. `openclaw chat` не обходит защиту от недопустимой конфигурации. ## Значения По возможности значения разбираются как JSON5; иначе они считаются необработанными строками. Используйте `--strict-json`, чтобы требовать стандартный JSON без резервного преобразования в строку (в этом случае синтаксис, допустимый только в JSON5, например комментарии, завершающие запятые или ключи без кавычек, отклоняется). `--json` — устаревший псевдоним для `--strict-json` в `config set`. ```bash openclaw config set agents.defaults.heartbeat.every "0m" openclaw config set gateway.port 19001 --strict-json openclaw config set channels.whatsapp.groups '["*"]' --strict-json ``` `config get --json` выводит исходное значение в формате JSON вместо текста, оформленного для терминала. По умолчанию присваивание объекта заменяет целевой путь. Защищённые пути, которые обычно содержат добавленные пользователем записи, отклоняют замены, удаляющие существующие записи, если не передан `--replace`: `agents.defaults.models`, `agents.list`, `models.providers`, `models.providers.`, `models.providers..models`, `plugins.entries` и `auth.profiles`. Используйте `--merge` при добавлении записей в эти отображения: ```bash openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge openclaw config set models.providers.ollama.models '[{"id":"llama3.2","name":"Llama 3.2"}]' --strict-json --merge ``` Используйте `--replace` только тогда, когда предоставленное значение должно намеренно стать полным целевым значением. ## Режимы `config set` ```bash openclaw config set ``` ```bash openclaw config set channels.discord.token \ --ref-provider default \ --ref-source env \ --ref-id DISCORD_BOT_TOKEN ``` Предназначен только для путей `secrets.providers.`: ```bash openclaw config set secrets.providers.vault \ --provider-source exec \ --provider-command /usr/local/bin/openclaw-vault \ --provider-arg read \ --provider-arg openai/api-key \ --provider-timeout-ms 5000 ``` ```bash openclaw config set --batch-json '[ { "path": "secrets.providers.default", "provider": { "source": "env" } }, { "path": "channels.discord.token", "ref": { "source": "env", "provider": "default", "id": "DISCORD_BOT_TOKEN" } } ]' ``` ```bash openclaw config set --batch-file ./config-set.batch.json --dry-run ``` Присваивания SecretRef отклоняются для неподдерживаемых поверхностей, изменяемых во время выполнения (например, `hooks.token`, `commands.ownerDisplaySecret`, токенов Webhook для привязки веток Discord и JSON с учётными данными WhatsApp). См. [Поверхность учётных данных SecretRef](/ru/reference/secretref-credential-surface). При пакетном разборе источником истины всегда служит пакетная полезная нагрузка (`--batch-json`/`--batch-file`); `--strict-json` / `--json` не изменяют поведение пакетного разбора. Режим пути/значения JSON также работает непосредственно для SecretRef и провайдеров: ```bash openclaw config set channels.discord.token \ '{"source":"env","provider":"default","id":"DISCORD_BOT_TOKEN"}' \ --strict-json openclaw config set secrets.providers.vaultfile \ '{"source":"file","path":"/etc/openclaw/secrets.json","mode":"json"}' \ --strict-json ``` ### Флаги конструктора провайдера Целевые пути конструктора провайдера должны использовать `secrets.providers.` в качестве пути. - `--provider-source ` - `--provider-timeout-ms ` (`file`, `exec`) - `--provider-allowlist ` (можно указывать многократно) - `--provider-path ` (обязательно) - `--provider-mode ` - `--provider-max-bytes ` - `--provider-allow-insecure-path` - `--provider-command ` (обязательно) - `--provider-arg ` (можно указывать многократно) - `--provider-no-output-timeout-ms ` - `--provider-max-output-bytes ` - `--provider-json-only` - `--provider-env ` (можно указывать многократно) - `--provider-pass-env ` (можно указывать многократно) - `--provider-trusted-dir ` (можно указывать многократно) - `--provider-allow-insecure-path` - `--provider-allow-symlink-command` Пример защищённого исполняемого провайдера: ```bash openclaw config set secrets.providers.vault \ --provider-source exec \ --provider-command /usr/local/bin/openclaw-vault \ --provider-arg read \ --provider-arg openai/api-key \ --provider-json-only \ --provider-pass-env VAULT_TOKEN \ --provider-trusted-dir /usr/local/bin \ --provider-timeout-ms 5000 ``` ## `config patch` Вставьте или передайте через канал JSON5-изменение, имеющее структуру конфигурации, вместо запуска множества команд `config set` на основе путей. Объекты объединяются рекурсивно; массивы и скалярные значения заменяют целевое значение; `null` удаляет целевой путь. ```bash openclaw config patch --file ./openclaw.patch.json5 --dry-run openclaw config patch --file ./openclaw.patch.json5 ``` Передайте изменение через стандартный ввод для сценариев удалённой настройки: ```bash ssh user@gateway-host 'openclaw config patch --stdin --dry-run' < ./openclaw.patch.json5 ssh user@gateway-host 'openclaw config patch --stdin' < ./openclaw.patch.json5 ``` Пример изменения: ```json5 { channels: { slack: { enabled: true, mode: "socket", botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" }, appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" }, groupPolicy: "open", requireMention: false, }, discord: { enabled: true, token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" }, dmPolicy: "disabled", dm: { enabled: false }, groupPolicy: "allowlist", }, }, agents: { defaults: { model: { primary: "openai/gpt-5.6-sol" }, models: { "openai/gpt-5.6-sol": { params: { fastMode: true } }, }, }, }, } ``` Используйте `--replace-path `, когда один объект или массив должен в точности принять предоставленное значение вместо рекурсивного частичного изменения: ```bash openclaw config patch --file ./discord.patch.json5 --replace-path 'channels.discord.guilds["123"].channels' ``` `--dry-run` выполняет проверки схемы и разрешимости SecretRef без записи. SecretRef на основе исполняемых провайдеров по умолчанию пропускаются при пробном запуске; добавьте `--allow-exec`, если намеренно хотите, чтобы пробный запуск выполнял команды провайдеров. ## Пробный запуск `--dry-run` проверяет изменения без записи в `openclaw.json`. Доступно для `config set`, `config patch` и `config unset`. ```bash openclaw config set channels.discord.token \ --ref-provider default \ --ref-source env \ --ref-id DISCORD_BOT_TOKEN \ --dry-run \ --json openclaw config set channels.discord.token \ --ref-provider vault \ --ref-source exec \ --ref-id discord/token \ --dry-run \ --allow-exec ``` - Режим конструктора: выполняет проверки разрешимости SecretRef для изменённых ссылок/провайдеров. - Режим JSON (`--strict-json`, `--json` или пакетный режим): выполняет проверку схемы и проверки разрешимости SecretRef. - Проверка политик выполняется для полной конфигурации после изменений, поэтому запись родительского объекта (например, задание `hooks` в виде объекта) не позволяет обойти проверку неподдерживаемых поверхностей. - Проверки Exec SecretRef по умолчанию пропускаются во избежание побочных эффектов команд; для их включения передайте `--allow-exec` (это может привести к выполнению команд провайдера). `--allow-exec` предназначен только для пробного запуска и без `--dry-run` приводит к ошибке. - `ok`: успешно ли завершён пробный запуск - `operations`: количество проверенных присваиваний - `checks`: выполнялись ли проверки схемы/разрешимости - `checks.resolvabilityComplete`: были ли проверки разрешимости выполнены полностью (false, если ссылки exec пропущены) - `refsChecked`: количество ссылок, фактически разрешённых во время пробного запуска - `skippedExecRefs`: количество ссылок exec, пропущенных из-за того, что `--allow-exec` не был задан - `errors`: структурированные ошибки отсутствующего пути, схемы или разрешимости, когда `ok=false` ### Структура вывода JSON ```json5 { ok: boolean, operations: number, configPath: string, inputModes: ["value" | "json" | "builder" | "unset", ...], checks: { schema: boolean, resolvability: boolean, resolvabilityComplete: boolean, }, refsChecked: number, skippedExecRefs: number, errors?: [ { kind: "missing-path" | "schema" | "resolvability", message: string, ref?: string, // присутствует при ошибках разрешимости }, ], } ``` ```json { "ok": true, "operations": 1, "configPath": "~/.openclaw/openclaw.json", "inputModes": ["builder"], "checks": { "schema": false, "resolvability": true, "resolvabilityComplete": true }, "refsChecked": 1, "skippedExecRefs": 0 } ``` ```json { "ok": false, "operations": 1, "configPath": "~/.openclaw/openclaw.json", "inputModes": ["builder"], "checks": { "schema": false, "resolvability": true, "resolvabilityComplete": true }, "refsChecked": 1, "skippedExecRefs": 0, "errors": [ { "kind": "resolvability", "message": "Ошибка: переменная окружения \"MISSING_TEST_SECRET\" не задана.", "ref": "env:default:MISSING_TEST_SECRET" } ] } ``` - `config schema validation failed`: структура конфигурации после изменений недопустима; исправьте путь/значение или структуру объекта провайдера/ссылки. - `Config policy validation failed: unsupported SecretRef usage`: верните эти учётные данные в открытый текст/строковый ввод; используйте SecretRef только на поддерживаемых поверхностях. - `SecretRef assignment(s) could not be resolved`: указанный провайдер/ссылка сейчас не разрешается (отсутствует переменная окружения, недопустимый указатель файла, сбой провайдера exec или несоответствие провайдера и источника). - `Dry run note: skipped exec SecretRef resolvability check(s)`: повторите запуск с `--allow-exec`, если требуется проверка разрешимости exec. - В пакетном режиме исправьте ошибочные записи и повторно запустите `--dry-run` перед записью. ## Применение изменений После каждого успешного выполнения `config set` / `config patch` / `config unset` CLI выводит одну из трёх подсказок, чтобы было понятно, требуется ли перезапуск Gateway: | Подсказка | Значение | | --------------------------------------------------- | ------------------------------------------------- | | `Restart the gateway to apply.` | Изменённый путь требует полного перезапуска. | | `Change will apply without restarting the gateway.` | Горячая перезагрузка применит его автоматически. | | `No gateway restart needed.` | Значимых для среды выполнения изменений нет. | Запись в `plugins.entries` (или любой вложенный путь) всегда требует перезапуска, поскольку CLI не может подтвердить, что загружены метаданные перезагрузки каждого плагина. ## Безопасность записи `openclaw config set` и другие принадлежащие OpenClaw средства записи конфигурации проверяют полную конфигурацию после изменений перед сохранением на диск. Если новые данные не проходят проверку схемы или выглядят как разрушительная перезапись, активная конфигурация остаётся неизменной, а отклонённые данные сохраняются рядом с ней как `openclaw.json.rejected.*`. При записи средствами OpenClaw JSON5 повторно сериализуется в стандартный JSON. Если исходный файл содержит комментарии, средство записи предупреждает непосредственно перед их удалением; если комментарии нужно сохранить, используйте редактор напрямую. Путь к активной конфигурации должен указывать на обычный файл. Схемы с символической ссылкой `openclaw.json` не поддерживаются для записи; вместо этого используйте `OPENCLAW_CONFIG_PATH`, чтобы указать непосредственно на реальный файл. Для небольших изменений предпочитайте запись через CLI: ```bash openclaw config set gateway.reload.mode hybrid --dry-run openclaw config set gateway.reload.mode hybrid openclaw config validate ``` Если запись отклонена, проверьте сохранённые данные и исправьте полную структуру конфигурации: ```bash CONFIG="$(openclaw config file)" ls -lt "$CONFIG".rejected.* 2>/dev/null | head openclaw config validate ``` Запись напрямую через редактор по-прежнему разрешена, но работающий Gateway считает такие изменения недоверенными, пока они не пройдут проверку. Недопустимые прямые изменения приводят к сбою запуска или пропускаются при горячей перезагрузке; Gateway не перезаписывает `openclaw.json`. Запустите `openclaw doctor --fix`, чтобы исправить конфигурацию с префиксами или разрушительной перезаписью либо восстановить последнюю заведомо исправную копию. См. [устранение неполадок Gateway](/ru/gateway/troubleshooting#gateway-rejected-invalid-config). Восстановление всего файла предназначено только для исправления через doctor. Изменения схемы плагина или рассогласование `minHostVersion` явно сообщаются как ошибки вместо отката не связанных с ними пользовательских настроек, таких как модели, провайдеры, профили аутентификации, каналы, доступность Gateway, инструменты, память, браузер или конфигурация Cron. ## Цикл исправления После успешного выполнения `openclaw config validate` используйте локальный TUI, чтобы встроенный агент сравнил активную конфигурацию с документацией, пока вы проверяете каждое изменение в том же терминале: ```bash openclaw chat ``` В TUI начальный `!` запускает буквальную локальную команду оболочки (после однократного запроса подтверждения для каждого сеанса): ```text !openclaw config file !openclaw docs gateway auth token secretref !openclaw config validate !openclaw doctor ``` Попросите агента сравнить текущую конфигурацию с соответствующей страницей документации и предложить минимальное исправление. Примените точечные изменения с помощью `openclaw config set` или `openclaw configure`. Повторно запускайте `openclaw config validate` после каждого изменения. Если проверка проходит, но среда выполнения по-прежнему работает некорректно, запустите `openclaw doctor` или `openclaw doctor --fix`, чтобы получить помощь с миграцией и исправлением. ## Связанные материалы - [Справочник CLI](/ru/cli) - [Конфигурация](/ru/gateway/configuration)