openclaw.json: полный разбор главного конфига OpenClaw

Файл openclaw.json — это главный технический центр управления OpenClaw. Если упрощать, именно здесь живут настройки, которые определяют, как работает Gateway, как подключаются каналы и какие ограничения действуют в окружении.

Где находится openclaw.json

Типовой путь:

~/.openclaw/openclaw.json

На проде важно точно понимать, на каком хосте этот файл является «источником истины».

За что отвечает openclaw.json

В зависимости от конфигурации, в файле обычно настраиваются:

  • режимы gateway;
  • сетевые bind-параметры;
  • каналы (Telegram/Discord/и т.д.);
  • политики безопасности;
  • логирование;
  • интеграционные параметры.

Почему правки в openclaw.json рискованные

Потому что это системный уровень. Ошибка может привести к:

  1. отвалу канала коммуникации;
  2. некорректному роутингу;
  3. проблемам с доступом;
  4. нарушению политики безопасности.

Безопасный workflow изменений

Шаг 1. Backup

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak-$(date +%F-%H%M)

Шаг 2. Точечная правка

Меняй только нужный блок. Не делай массовую «чистку» всех секций за один раз.

Шаг 3. Валидация

Проверь, что JSON/JSON5 синтаксис корректный и ключи не конфликтуют.

Шаг 4. Smoke-check

После применения изменений проверь основные каналы и критичные URL/функции.

Частые ошибки

Ошибка 1. Дубли секций

Повторяющиеся ключи с разными значениями дают неожиданные эффекты.

Ошибка 2. Правка всего файла сразу

Сложно понять, где причина поломки.

Ошибка 3. Изменения без плана отката

Если нет rollback, восстановление затягивается.

Что НЕ хранить в открытом виде

  • приватные токены
  • чувствительные ключи
  • секреты, которые можно вынести в менеджер секретов

Мини-чеклист перед деплоем

  • Есть backup openclaw.json
  • Менялись только целевые поля
  • Синтаксис валиден
  • Есть rollback-команда
  • Прогнан smoke-check после выката

Вывод

openclaw.json — самый важный технический файл OpenClaw. Его сила в том, что он централизует управление, а его риск — в том, что неверная правка может ударить по продакшену.

Рабочий подход всегда один: backup → точечная правка → проверка → деплой → smoke-check.