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

PRX использует систему конфигурации на основе TOML с поддержкой горячей перезагрузки. Все настройки хранятся в одном файле (с возможностью разделения на фрагменты), и большинство изменений применяются немедленно без перезапуска демона.

Расположение файла конфигурации

Основной файл конфигурации:

~/.openprx/config.toml

PRX определяет каталог конфигурации в следующем порядке:

1. Переменная окружения OPENPRX_CONFIG_DIR (если задана)
2. Переменная окружения OPENPRX_WORKSPACE (если задана)
3. Маркер активной рабочей области (~/.openprx/active_workspace.toml)
4. ~/.openprx/ (по умолчанию)

Каталог рабочей области (где хранятся память, сессии и данные) по умолчанию — ~/.openprx/workspace/.

Формат TOML

Конфигурация PRX использует TOML — минимальный, легко читаемый формат. Вот минимальная рабочая конфигурация:

# Выбор провайдера и модели
default_provider = "anthropic"
default_model = "anthropic/claude-sonnet-4-6"
default_temperature = 0.7

# API-ключ (или используйте переменную окружения ANTHROPIC_API_KEY)
api_key = "sk-ant-..."

# Бэкенд памяти
[memory]
backend = "sqlite"
auto_save = true

# Шлюзовой сервер
[gateway]
port = 16830
host = "127.0.0.1"

Разделы конфигурации

Конфигурация организована в следующие разделы верхнего уровня:

Раздел	Назначение
(верхний уровень)	Провайдер по умолчанию, модель, температура, API-ключ
[gateway]	HTTP-шлюз: хост, порт, сопряжение, ограничения частоты
[channels_config]	Каналы обмена сообщениями: Telegram, Discord, Slack и т.д.
[channels_config.telegram]	Конфигурация Telegram-бота
[channels_config.discord]	Конфигурация Discord-бота
[memory]	Бэкенд памяти и настройки эмбеддингов
[router]	Эвристический маршрутизатор LLM и Automix
[security]	Песочница, ограничения ресурсов, журнал аудита
[autonomy]	Уровни автономности и правила области инструментов
[observability]	Бэкенд метрик и трассировки
[mcp]	Интеграция сервера Model Context Protocol
[browser]	Настройки инструмента автоматизации браузера
[web_search]	Настройки инструментов веб-поиска и загрузки
[xin]	Автономный движок задач Xin
[reliability]	Повторные попытки и цепочки резервных провайдеров
[cost]	Лимиты расходов и ценообразование моделей
[cron]	Определения запланированных задач
[self_system]	Управление движком самоэволюции
[proxy]	Настройки HTTP/HTTPS/SOCKS5 прокси
[secrets]	Зашифрованное хранилище учётных данных
[auth]	Импорт внешних учётных данных (Codex CLI и т.д.)
[storage]	Провайдер постоянного хранилища
[tunnel]	Публичный туннельный доступ
[nodes]	Конфигурация прокси удалённых узлов

Полная пофилевая документация — в Справочнике конфигурации.

Разделённые файлы конфигурации

Для сложных развёртываний PRX поддерживает разделение конфигурации на фрагменты в каталоге config.d/ рядом с config.toml:

~/.openprx/
  config.toml          # Основная конфигурация (верхний уровень + переопределения)
  config.d/
    channels.toml      # Раздел [channels_config]
    memory.toml        # Разделы [memory] и [storage]
    security.toml      # Разделы [security] и [autonomy]
    agents.toml        # Разделы [agents] и [sessions_spawn]
    identity.toml      # Разделы [identity] и [identity_bindings]
    network.toml       # Разделы [gateway], [tunnel] и [proxy]
    scheduler.toml     # Разделы [scheduler], [cron] и [heartbeat]

Файлы-фрагменты объединяются поверх config.toml (фрагменты имеют приоритет). Файлы загружаются в алфавитном порядке.

Способы редактирования

Интерактивный мастер

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

prx onboard

CLI-команды конфигурации

Просмотр и изменение конфигурации из командной строки:

# Показать текущую конфигурацию
prx config show

# Изменить конкретное значение
prx config set default_provider anthropic
prx config set default_model "anthropic/claude-sonnet-4-6"

# Запустить ручную перезагрузку
prx config reload

Прямое редактирование

Откройте ~/.openprx/config.toml в любом текстовом редакторе. Изменения автоматически обнаруживаются наблюдателем файловой системы и применяются в течение 1 секунды (см. Горячая перезагрузка).

Экспорт схемы

Экспорт полной схемы конфигурации в формате JSON Schema для автодополнения и валидации в редакторе:

prx config schema

Это выводит документ JSON Schema, который может использоваться с VS Code, IntelliJ или любым редактором, поддерживающим валидацию TOML-схемы.

Горячая перезагрузка

Большинство изменений конфигурации применяются немедленно без перезапуска PRX. Наблюдатель файловой системы использует окно подавления дребезга в 1 секунду и атомарно заменяет действующую конфигурацию при успешном разборе. Если новый файл содержит синтаксические ошибки, предыдущая конфигурация сохраняется и записывается предупреждение в журнал.

Подробнее о том, что требует перезапуска, — в разделе Горячая перезагрузка.

Следующие шаги

• Справочник конфигурации — полная пофилевая документация
• Горячая перезагрузка — что применяется на лету, а что требует перезапуска
• Переменные окружения — переменные окружения, API-ключи и поддержка .env
• LLM-провайдеры — конфигурация для конкретных провайдеров