CLI commands

Конфигурация

Неинтерактивные вспомогательные команды для openclaw.json: получить/задать/частично изменить/удалить значение по пути, вывести схему, проверить конфигурацию или вывести путь к активному файлу. Запустите openclaw config без подкоманды, чтобы открыть тот же пошаговый мастер, что и openclaw configure.

Корневые параметры

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tc2VjdGlvbiA8c2VjdGlvbg " type="string"> Повторяемый фильтр разделов пошаговой настройки при запуске openclaw config без подкоманды.

Разделы пошаговой настройки: workspace, model, web, gateway, daemon, channels, plugins, skills, health.

Примеры

bash

openclaw config fileopenclaw config --section modelopenclaw config --section gateway --section daemonopenclaw config schemaopenclaw config get browser.executablePathopenclaw 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 --mergeopenclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKENopenclaw config set secrets.providers.vaultfile --provider-source file --provider-path /etc/openclaw/secrets.json --provider-mode jsonopenclaw config patch --file ./openclaw.patch.json5 --dry-runopenclaw config unset plugins.entries.brave.config.webSearch.apiKeyopenclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN --dry-runopenclaw config validateopenclaw config validate --json

Пути

Точечная или скобочная нотация. Заключайте пути со скобками в кавычки в примерах для оболочки, чтобы zsh не раскрывала [0] как шаблон:

bash

openclaw config get agents.defaults.workspaceopenclaw config get 'agents.list[0].id'openclaw config get agents.listopenclaw config set 'agents.list[1].tools.exec.node' "node-id-or-name"

`config get`

Считывает значение из редактированного снимка конфигурации (секреты никогда не выводятся). --json выводит исходное значение в формате JSON; иначе строки, числа и логические значения выводятся без оформления, а объекты и массивы — как форматированный JSON.

bash

openclaw config get browser.executablePathopenclaw config get agents.defaults.model --json

`config file`

Выводит путь к активному файлу конфигурации, определённый из OPENCLAW_CONFIG_PATH или расположения по умолчанию. Путь указывает на обычный файл, а не на символическую ссылку; см. Безопасность записи.

`config schema`

Выводит созданную схему JSON для openclaw.json в стандартный вывод.

Что включено

Текущая корневая схема конфигурации, а также корневое строковое поле $schema для инструментов редактора.
Метаданные документации полей title / description, используемые Control UI.
Узлы вложенных объектов, подстановочных знаков (*) и элементов массивов ([]) наследуют те же метаданные title / description, когда существует соответствующая документация полей.
Ветви anyOf / oneOf / allOf также наследуют те же метаданные документации.
Получаемые по мере возможности актуальные метаданные схем плагинов и каналов, когда можно загрузить манифесты среды выполнения.
Корректная резервная схема, даже если текущая конфигурация недопустима.

Связанный RPC среды выполнения

config.schema.lookup возвращает один нормализованный путь конфигурации с неглубоким узлом схемы (title, description, type, enum, const, общие ограничения), соответствующими метаданными подсказок интерфейса и сводками непосредственных дочерних элементов. Используйте его для детализации по пути в Control UI или пользовательских клиентах.

bash

openclaw config schemaopenclaw config schema > openclaw.schema.json

`config validate`

Проверяет текущую конфигурацию по активной схеме без запуска Gateway.

bash

openclaw config validateopenclaw config validate --json

Значения

По возможности значения разбираются как 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-jsonopenclaw config set channels.whatsapp.groups '["*"]' --strict-json

config get <path> --json выводит исходное значение в формате JSON вместо текста, оформленного для терминала.

Используйте --merge при добавлении записей в эти отображения:

bash

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --mergeopenclaw config set models.providers.ollama.models '[{"id":"llama3.2","name":"Llama 3.2"}]' --strict-json --merge

Используйте --replace только тогда, когда предоставленное значение должно намеренно стать полным целевым значением.

Режимы `config set`

Режим значения

bash

openclaw config set <path> <value>

Режим конструктора SecretRef

bash

openclaw config set channels.discord.token \  --ref-provider default \  --ref-source env \  --ref-id DISCORD_BOT_TOKEN

Режим конструктора провайдера

Предназначен только для путей secrets.providers.<alias>:

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

При пакетном разборе источником истины всегда служит пакетная полезная нагрузка (--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.<alias> в качестве пути.

Общие флаги

--provider-source <env|file|exec>
--provider-timeout-ms <ms> (file, exec)

Провайдер окружения (--provider-source env)

--provider-allowlist <ENV_VAR> (можно указывать многократно)

Файловый провайдер (--provider-source file)

--provider-path <path> (обязательно)
--provider-mode <singleValue|json>
--provider-max-bytes <bytes>
--provider-allow-insecure-path

Исполняемый провайдер (--provider-source exec)

--provider-command <path> (обязательно)
--provider-arg <arg> (можно указывать многократно)
--provider-no-output-timeout-ms <ms>
--provider-max-output-bytes <bytes>
--provider-json-only
--provider-env <KEY=VALUE> (можно указывать многократно)
--provider-pass-env <ENV_VAR> (можно указывать многократно)
--provider-trusted-dir <path> (можно указывать многократно)
--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-runopenclaw config patch --file ./openclaw.patch.json5

Передайте изменение через стандартный ввод для сценариев удалённой настройки:

bash

ssh user@gateway-host 'openclaw config patch --stdin --dry-run' < ./openclaw.patch.json5ssh 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 <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 приводит к ошибке.

Поля --dry-run --json

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 <n> 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. Если исходный файл содержит комментарии, средство записи предупреждает непосредственно перед их удалением; если комментарии нужно сохранить, используйте редактор напрямую.

Для небольших изменений предпочитайте запись через CLI:

bash

openclaw config set gateway.reload.mode hybrid --dry-runopenclaw config set gateway.reload.mode hybridopenclaw config validate

Если запись отклонена, проверьте сохранённые данные и исправьте полную структуру конфигурации:

bash

CONFIG="$(openclaw config file)"ls -lt "$CONFIG".rejected.* 2>/dev/null | headopenclaw config validate

Запись напрямую через редактор по-прежнему разрешена, но работающий Gateway считает такие изменения недоверенными, пока они не пройдут проверку. Недопустимые прямые изменения приводят к сбою запуска или пропускаются при горячей перезагрузке; Gateway не перезаписывает openclaw.json. Запустите openclaw doctor --fix, чтобы исправить конфигурацию с префиксами или разрушительной перезаписью либо восстановить последнюю заведомо исправную копию. См. устранение неполадок Gateway.

Восстановление всего файла предназначено только для исправления через 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 после каждого изменения.

Используйте doctor при проблемах среды выполнения

Если проверка проходит, но среда выполнения по-прежнему работает некорректно, запустите openclaw doctor или openclaw doctor --fix, чтобы получить помощь с миграцией и исправлением.

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

Was this useful?

Конфигурация

Корневые параметры

Примеры

Пути

`config get`

`config file`

`config schema`

`config validate`

Значения

Режимы `config set`

Режим значения

Режим конструктора SecretRef

Режим конструктора провайдера

Пакетный режим

Флаги конструктора провайдера

`config patch`

Пробный запуск

Структура вывода JSON

Пример успешного выполнения

Пример ошибки

Применение изменений

Безопасность записи

Цикл исправления

Сравните с документацией

Примените точечные изменения

Повторите проверку

Используйте doctor при проблемах среды выполнения

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

On this page

Molty

Корневые параметры

Примеры

Пути

config get

config file

config schema

config validate

Значения

Режимы config set

Режим значения

Режим конструктора SecretRef

Режим конструктора провайдера

Пакетный режим

Флаги конструктора провайдера

config patch

Пробный запуск

Структура вывода JSON

Пример успешного выполнения

Пример ошибки

Применение изменений

Безопасность записи

Цикл исправления

Сравните с документацией

Примените точечные изменения

Повторите проверку

Используйте doctor при проблемах среды выполнения

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

On this page

`config get`

`config file`

`config schema`

`config validate`

Режимы `config set`

`config patch`