OpenClaw reçoit un guide complet en russe sur la configuration JSON5, le CLI et la configuration sécurisée

На Хабре вышел подробный гид по OpenClaw — платформе, где почти вся операционная настройка завязана на один файл openclaw.json и большой CLI. Материал собирает в одном месте то, что раньше приходилось выискивать по официальной справке, GitHub issues и постам сообщества.

Что в конфиге

Автор разбирает, как устроен верхний уровень конфигурации и почему OpenClaw требует аккуратности при ручном редактировании. Файл использует JSON5, поэтому допускает комментарии и завершающие запятые, но схема при запуске проверяется очень строго. Если добавить незнакомый ключ, шлюз просто не стартует.

Отдельно описаны gateway, env, agents, models, auth, channels, session, cron, tools, sandbox и logging, а также то, как работает горячая перезагрузка без полного рестарта. gateway: порт, режим bind, токен доступа и поведение hot reload agents и models: базовые настройки, fallbacks и выбор провайдеров auth и channels: переключение профилей, Telegram, Discord и другие каналы session и cron: изоляция диалогов, сбросы по времени и фоновые задания * env и secrets: приоритет переменных, SecretRef и хранение чувствительных данных Главная ценность материала в том, что он не ограничивается списком полей. В тексте объясняют, как связаны разные уровни конфигурации, где работают значения по умолчанию, когда настройки применяются без перезапуска и какие параметры лучше не трогать вручную.

Для тех, кто держит OpenClaw не локально, а на VPS или в рабочем окружении, это уже не справка, а полноценный operational playbook.

Где ломается настройка Самый полезный блок посвящён не happy path, а типовым сбоям.

В руководстве подчёркивается, что часть параметров работает только в agents.defaults и молча игнорируется, если перенести их в настройки конкретного агента. Из-за этого конфиг может выглядеть правильным, но нужное поведение не включится. Рекомендация простая: чаще использовать команды openclaw config get, set и unset вместо прямой правки и после каждого изменения прогонять диагностику.

openclaw doctor — самая полезная команда во всём CLI.

Отдельно разобрана проблема раздувания контекста. OpenClaw использует два разных механизма: pruning убирает старые результаты инструментов перед вызовом модели, а compaction сжимает историю, когда окно контекста почти заполнено. В качестве примера приводится случай, где 35 сообщений превратились в файл сессии на 2,9 МБ и контекст на 208 467 токенов, из-за чего система перестала отвечать при лимите модели в 200 тысяч токенов.

CLI для админа CLI описан не по алфавиту, а по рабочим сценариям, и это делает гид практичным.

В одном месте собраны команды для запуска шлюза, статуса демона, управления каналами, логов, cron-задач, плагинов, skills, сессий и обновлений. Для инфраструктурных команд отдельно показаны безопасные режимы: health работает даже без запущенного демона, security audit проверяет конфиг на риски, а secrets audit помогает поймать утечки учётных данных до продакшена. Последний важный блок — переменные окружения и контроль версий. Руководство фиксирует порядок приоритета: сначала окружение процесса, затем локальный .env, потом глобальный .env в каталоге OpenClaw, и только после этого встроенные env.vars. Для секретов советуют использовать не значения в openclaw.json, а ссылки на переменные или SecretRef, а в репозиторий коммитить только шаблон конфигурации, исключая .env, папки сессий, файлы памяти и временное состояние.

Что это значит

OpenClaw становится инструментом не только для энтузиастов, готовых читать исходники, но и для команд, которым нужен понятный operational playbook. Если проект держится на нескольких моделях, каналах и автоматизации, такой гид снижает риск тихих поломок, утечек секретов и нестабильного поведения после обновлений.