← Документация

Переменные окружения

Настройка интеграции OpenChamber и OpenCode через переменные окружения.

Раздел: Начало · Статус: draft · Релиз-проверка: v1.18.2

Переменные окружения

OpenChamber читает эти переменные окружения при запуске. Для сервисов автозапуска openchamber startup enable по умолчанию снимает слепок текущего окружения, поэтому после изменения переменных, которые должен использовать сервис, перезапустите команду.

Сервер OpenChamber

OPENCHAMBER_HOST

Адрес привязки веб-сервера OpenChamber. Используйте 0.0.0.0, чтобы разрешить доступ с других машин.

OPENCHAMBER_UI_PASSWORD

Пароль для браузерного UI. Используйте при привязке вне localhost, при туннелях или работе за обратным прокси.

OPENCHAMBER_API_ONLY

Запускает OpenChamber в headless-режиме, если задано true или 1. API-маршруты остаются доступны для десктоп- и мобильных клиентов, но браузерный UI не раздаётся.

OPENCHAMBER_DATA_DIR

Переопределяет каталог данных OpenChamber. По умолчанию — ~/.config/openchamber.

OPENCHAMBER_COMPRESS_API

Управляет сжатием ответов API. true или 1 — принудительно включить, false или 0 — принудительно выключить.

OPENCHAMBER_SKIP_API_COMPRESSION

Отключает сжатие ответов API, если задано true или 1. Имеет приоритет над OPENCHAMBER_COMPRESS_API.

OPENCHAMBER_VERBOSE_REQUEST_LOGS

Включает подробные логи HTTP-запросов, если задано true или 1.

OPENCHAMBER_UPDATE_API_URL

Переопределяет endpoint API проверки обновлений. Большинству пользователей лучше оставить незаданным.

OPENCHAMBER_PACKAGE_MANAGER

Принудительно задаёт менеджер пакетов для операций обновления, когда автоопределение ошибается.

Сервер OpenCode

OPENCODE_HOST

Подключает OpenChamber к существующему серверу OpenCode. Значение должно быть origin http или https с явным портом и без пути, query и hash. OPENCODE_HOST имеет приоритет над OPENCODE_PORT.

OPENCODE_PORT

Задаёт порт сервера OpenCode. С управляемым OpenCode запрашивает управляемый порт; с OPENCODE_SKIP_START=true подключается к внешнему серверу на этом порту.

OPENCODE_SKIP_START

Запрещает OpenChamber запускать собственный сервер OpenCode, если задано true.

OPENCHAMBER_OPENCODE_HOSTNAME

Имя хоста привязки для сервера OpenCode, управляемого OpenChamber. По умолчанию — 127.0.0.1.

OPENCODE_BINARY

Путь к исполняемому файлу opencode, который должен запускать OpenChamber.

OPENCODE_CONFIG

Путь к конкретному конфигурационному файлу OpenCode.

OPENCODE_CONFIG_DIR

Путь к конкретному конфигурационному каталогу OpenCode для обнаружения агентов, скиллов, сниппетов и конфигурации.

OPENCODE_DATA_DIR

Пользовательский каталог данных для управляемого сервера OpenCode.

OPENCODE_WSL_DISTRO

Выбирает дистрибутив WSL для интеграции OpenCode на Windows.

OPENCHAMBER_OPENCODE_WSL_DISTRO

Псевдоним, специфичный для OpenChamber, для выбора дистрибутива WSL. OPENCODE_WSL_DISTRO имеет приоритет, когда заданы обе.

OPENCODE_JWT_SECRET

Секрет для подписи токенов аутентификации UI. Для постоянных сервисных развёртываний используйте длинное случайное значение.

Терминал и Git

OPENCHAMBER_TERMINAL_SHELL

Исполняемый файл оболочки для терминальных сессий OpenChamber.

OPENCHAMBER_GIT_BINARY

Исполняемый файл Git для функций Git в OpenChamber.

GIT_BINARY

Альтернативное переопределение исполняемого файла Git. Для конфигурации, специфичной для OpenChamber, предпочитайте OPENCHAMBER_GIT_BINARY.

OPENCHAMBER_GIT_READ_CACHE_TTL_MS

Время жизни (TTL) в миллисекундах для кэшированных Git-чтений файлов. Задайте 0, чтобы отключить кэш при отладке.

Голос и туннели

OPENAI_API_KEY

API-ключ для голосовых функций OpenChamber, которые вызывают OpenAI-совместимые сервисы.

OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS

Разрешает удалённые OpenAI-совместимые base URL для голосовых функций, если задано true или 1.

NGROK_AUTHTOKEN

Auth-токен ngrok для туннельных команд OpenChamber. Также можно настроить ngrok командой ngrok config add-authtoken <token>.

Вспомогательные средства рантайма

BUN_BINARY

Исполняемый файл Bun, который OpenChamber должен использовать при порождении демон-процессов.

BUN_INSTALL

Корень установки Bun. OpenChamber использует его для поиска bin/bun для запуска демона и обновлений.

VITE_OPENCODE_URL

Build-time API base URL для веб-приложения, собираемого Vite. Большинству пользователей не следует задавать его для обычного использования CLI или десктопа.