Справочник по переменным среды
VibeOS считывает переменные среды из среды процесса и, для секретов, управляемых пользователем, из ~/.vibeos/.env. Храните ключи API, токены ботов, секреты OAuth и другие учетные данные в .env; предпочитайте config.yaml для несекретных настроек поведения, когда существует ключ конфигурации. Некоторые приведенные ниже переменные являются переопределяемыми только для процесса или внутренними переменными моста, и их не следует фиксировать в .env только потому, что они документированы здесь. Переменная | Описание |
|---|---|
OPENROUTER_API_KEY | Ключ OpenRouter API (рекомендуется для гибкости) |
OPENROUTER_BASE_URL | Переопределить OpenRouter-совместимую базу URL |
VIBEOS_OPENROUTER_CACHE | Включите кэширование ответов OpenRouter (1/true/yes/on). Переопределяет openrouter.response_cache в config.yaml. См. Кэширование ответов. |
VIBEOS_OPENROUTER_CACHE_TTL | Кэш TTL в секундах (1-86400). Переопределяет openrouter.response_cache_ttl в config.yaml. |
NOUS_BASE_URL | Переопределить Nous Portal базовый URL (требуется редко; только development/testing) |
NOUS_INFERENCE_BASE_URL | Переопределить конечную точку вывода Nous напрямую |
OPENAI_API_KEY | Ключ API для пользовательских OpenAI-совместимых конечных точек (используется с OPENAI_BASE_URL) |
OPENAI_BASE_URL | База URL для пользовательской конечной точки (VLLM, SGLang и т. д.) |
LM_API_KEY | Ключ API для провайдера LM Studio (lmstudio). Часто является заполнителем для локальных серверов |
LM_BASE_URL | LM Studio база URL (по умолчанию: http://localhost:1234/v1) |
COPILOT_GITHUB_TOKEN | Токен GitHub для Copilot API — первый приоритет (OAuth gho_* или мелкозернистый PAT github_pat_*; классические PAT ghp_* не поддерживаются) |
GH_TOKEN | Токен GitHub — второй приоритет для Copilot (также используется gh CLI) |
GITHUB_TOKEN | Токен GitHub — третий приоритет для Copilot |
VIBEOS_COPILOT_ACP_COMMAND | Переопределить двоичный путь Copilot ACP CLI (по умолчанию: copilot) |
COPILOT_CLI_PATH | Псевдоним для VIBEOS_COPILOT_ACP_COMMAND |
VIBEOS_COPILOT_ACP_ARGS | Переопределить аргументы Copilot ACP (по умолчанию: --acp --stdio) |
COPILOT_ACP_BASE_URL | Переопределить Copilot ACP базу URL |
COPILOT_API_BASE_URL | Переопределить Copilot API базу URL (copilot провайдера) |
GLM_API_KEY | z.ai / ZhipuAI GLM API ключ (z.ai) |
ZAI_API_KEY | Псевдоним для GLM_API_KEY |
Z_AI_API_KEY | Псевдоним для GLM_API_KEY |
GLM_BASE_URL | Переопределить базу z.ai URL (по умолчанию: https://api.z.ai/api/paas/v4) |
KIMI_API_KEY | Kimi / Moonshot AI API ключ (moonshot.ai) |
KIMI_CODING_API_KEY | Ключ-псевдоним для провайдера kimi-coding (принимается вместе с KIMI_API_KEY) |
KIMI_BASE_URL | Переопределить Kimi базовый URL (по умолчанию: https://api.moonshot.ai/v1) |
KIMI_CN_API_KEY | Kimi / Moonshot Китай API ключ (moonshot.cn) |
ARCEEAI_API_KEY | Arcee AI API ключ (chat.arcee.ai) |
ARCEE_BASE_URL | Переопределить базу Arcee URL (по умолчанию: https://api.arcee.ai/api/v1) |
GMI_API_KEY | GMI Облачный ключ API (gmicloud.ai) |
GMI_BASE_URL | Переопределить GMI Облачная база URL (по умолчанию: https://api.gmi-serving.com/v1) |
MINIMAX_API_KEY | Ключ MiniMax API — глобальная конечная точка (minimax.io). Не используется minimax-oauth (OAuth вместо этого используется путь входа в браузер). |
MINIMAX_BASE_URL | Переопределить MiniMax базовую URL (по умолчанию: https://api.minimax.io/anthropic — VibeOS использует конечную точку Anthropic Anthropic, совместимую с сообщениями). Не используется minimax-oauth. |
MINIMAX_CN_API_KEY | Ключ MiniMax API — конечная точка Китая (minimaxi.com). Не используется minimax-oauth (OAuth вместо этого используется путь входа в браузер). |
MINIMAX_CN_BASE_URL | Переопределить MiniMax Китайская база URL (по умолчанию: https://api.minimaxi.com/anthropic). Не используется minimax-oauth. |
KILOCODE_API_KEY | Kilo Code API ключ (kilo.ai) |
KILOCODE_BASE_URL | Переопределить Kilo Code базовый URL (по умолчанию: https://api.kilo.ai/api/gateway) |
XIAOMI_API_KEY | Xiaomi MiMo API ключ (platform.xiaomimimo.com) |
XIAOMI_BASE_URL | Переопределить Xiaomi База MiMo URL (по умолчанию: https://api.xiaomimimo.com/v1) |
TOKENHUB_API_KEY | Tencent TokenHub API ключ (tokenhub.tencentmaas.com) |
TOKENHUB_BASE_URL | Переопределить Tencent TokenHub базовый URL (по умолчанию: https://tokenhub.tencentmaas.com/v1) |
AZURE_FOUNDRY_API_KEY | Ключ Microsoft Foundry / Azure OpenAI API (ai.azure.com). Не требуется, если model.auth_mode: entra_id |
AZURE_FOUNDRY_BASE_URL | Конечная точка Microsoft Foundry URL (например, https://<resource>.openai.azure.com/openai/v1 для OpenAI-стиля или https://<resource>.services.ai.azure.com/anthropic для Anthropic-стиля) |
AZURE_ANTHROPIC_KEY | Azure Anthropic API ключ для provider: anthropic + base_url, указывающий на развертывание Microsoft Foundry Claude (альтернатива ANTHROPIC_API_KEY, когда настроены оба Anthropic и Azure Anthropic) |
AZURE_TENANT_ID | Идентификатор клиента Entra ID (потоки субъекта-службы; учитывается azure-identity, когда model.auth_mode: entra_id) |
AZURE_CLIENT_ID | Идентификатор клиента Entra ID (субъект службы, идентификатор рабочей нагрузки или управляемый идентификатор, назначаемый пользователем) |
AZURE_CLIENT_SECRET | Секрет участника службы, используемый EnvironmentCredential |
AZURE_CLIENT_CERTIFICATE_PATH | Сертификат субъекта-службы (альтернатива AZURE_CLIENT_SECRET) |
AZURE_FEDERATED_TOKEN_FILE | Путь к файлу федеративного токена для AKS Workload Identity / OIDC потоков |
AZURE_AUTHORITY_HOST | Переопределение полномочий суверенного облака (например, https://login.microsoftonline.us для Azure Government). См. Azure Foundry руководство |
IDENTITY_ENDPOINT / MSI_ENDPOINT | Конечная точка управляемого удостоверения для службы приложений, функций и приложений-контейнеров; Вместо этого виртуальные машины обычно используют IMDS и не устанавливают эти |
HF_TOKEN | Токен Hugging Face для поставщиков логических выводов (huggingface.co/settings/tokens) |
HF_BASE_URL | Переопределить Hugging Face базовый URL (по умолчанию: https://router.huggingface.co/v1) |
GOOGLE_API_KEY | Google AI Studio API ключ (aistudio.google.com/app/apikey) |
GEMINI_API_KEY | Псевдоним для GOOGLE_API_KEY |
GEMINI_BASE_URL | Переопределить Google Базу AI Studio URL |
ANTHROPIC_API_KEY | Anthropic Консоль API клавиша (console.anthropic.com) |
ANTHROPIC_BASE_URL | Переопределить Anthropic API базу URL |
ANTHROPIC_TOKEN | Ручное или устаревшее Anthropic OAuth/setup-token переопределение |
DASHSCOPE_API_KEY | Qwen Cloud (Alibaba DashScope) API ключ для моделей Qwen (modelstudio.console.alibabacloud.com) |
DASHSCOPE_BASE_URL | Пользовательская база DashScope URL (по умолчанию: https://dashscope-intl.aliyuncs.com/compatible-mode/v1; используйте https://dashscope.aliyuncs.com/compatible-mode/v1 для региона материкового Китая) |
ALIBABA_CODING_PLAN_API_KEY | Qwen План кодирования API ключ (alibaba-coding-plan поставщик) |
ALIBABA_CODING_PLAN_BASE_URL | Переопределить базовый план кодирования Qwen URL |
DEEPSEEK_API_KEY | DeepSeek API ключ для прямого DeepSeek доступа (platform.deepseek.com) |
DEEPSEEK_BASE_URL | Пользовательская DeepSeek API база URL |
NOVITA_API_KEY | NovitaAI API ключ — собственное облако AI для модели API, тестовой среды агента и облака GPU (novita.ai/settings/key-management) |
NOVITA_BASE_URL | Переопределить NovitaAI базовый URL (по умолчанию: https://api.novita.ai/openai/v1) |
NVIDIA_API_KEY | NVIDIA NIM API ключ — Немотрон и открытые модели (build.nvidia.com) |
NVIDIA_BASE_URL | Переопределить NVIDIA базовую URL (по умолчанию: https://integrate.api.nvidia.com/v1; установлено значение http://localhost:8000/v1 для локальной конечной точки NIM) |
STEPFUN_API_KEY | StepFun API key — модели серии Step (platform.stepfun.com) |
STEPFUN_BASE_URL | Переопределить StepFun базовый URL (по умолчанию: https://api.stepfun.com/v1) |
OLLAMA_API_KEY | Ollama Облачный ключ API — управляемый Ollama каталог без локального GPU (ollama.com/settings/keys) |
OLLAMA_BASE_URL | Переопределить Ollama Облачная база URL (по умолчанию: https://ollama.com/v1) |
XAI_API_KEY | xAI (Grok) API клавиша для чата + TTS + веб-поиск (console.x.ai) |
XAI_BASE_URL | Переопределить xAI базовый URL (по умолчанию: https://api.x.ai/v1) |
MISTRAL_API_KEY | Ключ Mistral API для Voxtral TTS и Voxtral STT (console.mistral.ai) |
AWS_REGION | Область AWS для вывода Bedrock (например, us-east-1, eu-central-1). Читал boto3. |
AWS_PROFILE | AWS именованный профиль для аутентификации Bedrock (читается ~/.aws/credentials). Оставьте значение отключенным, чтобы использовать цепочку учетных данных boto3 по умолчанию. |
BEDROCK_BASE_URL | Переопределить Bedrock базу времени выполнения URL (по умолчанию: https://bedrock-runtime.us-east-1.amazonaws.com; обычно не настраивайте и вместо этого используйте AWS_REGION) |
VIBEOS_QWEN_BASE_URL | Qwen База портала URL переопределить (по умолчанию: https://portal.qwen.ai/v1) |
OPENCODE_ZEN_API_KEY | OpenCode Zen API ключ — доступ к курируемым моделям с оплатой по мере использования (opencode.ai) |
OPENCODE_ZEN_BASE_URL | Переопределить OpenCode Zen базу URL |
OPENCODE_GO_API_KEY | OpenCode Go API ключ — $10/month подписка на открытые модели (opencode.ai) |
OPENCODE_GO_BASE_URL | Переопределить OpenCode Go базу URL |
CLAUDE_CODE_OAUTH_TOKEN | Явное Claude переопределение токена кода, если вы экспортируете его вручную |
VIBEOS_MODEL | Переопределить имя модели на уровне процесса (используется планировщиком cron; для обычного использования предпочитаете config.yaml) |
VOICE_TOOLS_OPENAI_KEY | Предпочтительный ключ OpenAI для OpenAI поставщиков услуг преобразования речи в текст и текста в речь |
VIBEOS_LOCAL_STT_COMMAND | Дополнительный шаблон локальной команды преобразования речи в текст. Поддерживает заполнители {input_path}, {output_dir}, {language} и {model} |
VIBEOS_LOCAL_STT_LANGUAGE | Язык по умолчанию передается VIBEOS_LOCAL_STT_COMMAND или автоматически определяется локальный whisper CLI (по умолчанию: en) |
VIBEOS_HOME | Переопределить каталог конфигурации VibeOS (по умолчанию: ~/.vibeos). Также ограничивается файл шлюза PID и имя службы systemd, поэтому несколько установок могут выполняться одновременно |
VIBEOS_GIT_BASH_PATH | Windows только. Переопределить обнаружение bash.exe для инструмента терминала. Указывает на любой bash — полная установка Git-for-Windows, WSL bash через символическую ссылку, MSYS2, Cygwin. Установщик автоматически устанавливает это значение в предоставленный им PortableGit. См. Windows (собственное) руководство |
VIBEOS_DISABLE_WINDOWS_UTF8 | Windows только. Установите значение 1, чтобы отключить прокладку UTF-8 stdio (configure_windows_stdio()) и вернуться к кодовой странице локали консоли. Полезно для разделения ошибок кодирования; редко бывает правильная настройка при нормальной работе |
VIBEOS_KANBAN_HOME | Переопределить общий корень VibeOS, который привязывает доску канбан (база данных + рабочие области + рабочие журналы). Возвращается к get_default_vibeos_root() (родительскому элементу любого активного профиля). Полезно для тестов и необычных развертываний |
VIBEOS_KANBAN_BOARD | Закрепите активную канбан-доску для этого процесса. Имеет приоритет над ~/.vibeos/kanban/current; диспетчер вводит это в среду рабочего подпроцесса, чтобы рабочие физически не могли видеть задачи на других досках. По умолчанию default. Проверка фрагментов: строчные буквы и цифры + дефисы + подчеркивания, 1–64 символа |
VIBEOS_KANBAN_DB | Закрепите путь к файлу базы данных канбан напрямую (наивысший приоритет; лучше VIBEOS_KANBAN_BOARD и VIBEOS_KANBAN_HOME). Диспетчер вводит это в среду рабочего подпроцесса, поэтому работники профиля сходятся на доске диспетчера |
VIBEOS_KANBAN_WORKSPACES_ROOT | Закрепите корень рабочих пространств канбана напрямую (наивысший приоритет для рабочих пространств; лучше VIBEOS_KANBAN_HOME). Диспетчер вводит это в рабочий подпроцесс env |
VIBEOS_KANBAN_DISPATCH_IN_GATEWAY | Переопределение времени выполнения для kanban.dispatch_in_gateway. Установите 0, false, no или off, чтобы шлюз не запускал встроенный диспетчер канбана; любое другое непустое значение позволяет это сделать. Полезно, когда доской владеет отдельный процесс-диспетчер. |
Аутентификация поставщика (OAuth)
Для собственной аутентификации Anthropic VibeOS предпочитает Claude Code собственные файлы учетных данных, если они существуют, поскольку эти учетные данные могут обновляться автоматически. OAuth против Anthropic требуется план Claude Max с приобретенными дополнительными кредитами на использование — маршруты VibeOS в виде кода Claude, который основан только на плане Max extra/overage кредиты, а не базовый максимальный лимит, и не работает на Claude Pro. Без максимального количества + дополнительных кредитов используйте вместо этого ключ API. Переменные среды, такие как ANTHROPIC_TOKEN, остаются полезными в качестве ручного переопределения, но они больше не являются предпочтительным путем для Claude Макс. вход в систему.
| Переменная | Описание |
|---|---|
VIBEOS_PORTAL_BASE_URL | Переопределить Nous Portal URL (для development/testing) |
NOUS_INFERENCE_BASE_URL | Переопределить вывод Nous API URL |
VIBEOS_NOUS_MIN_KEY_TTL_SECONDS | Минимальный ключ агента TTL перед повторным выпуском (по умолчанию: 1800 = 30 минут) |
VIBEOS_NOUS_TIMEOUT_SECONDS | HTTP время ожидания для Nous потоков учетных данных/токенов |
VIBEOS_DUMP_REQUESTS | Дамп API запроса полезных данных в файлы журналов (true/false) |
VIBEOS_PREFILL_MESSAGES_FILE | Путь к файлу JSON эфемерных сообщений предварительного заполнения, введенных во время API-вызова |
VIBEOS_TIMEZONE | IANA переопределение часового пояса (например, America/New_York) |
API инструментов
| Переменная | Описание |
|---|---|
PARALLEL_API_KEY | Веб-поиск с использованием искусственного интеллекта (parallel.ai) |
FIRECRAWL_API_KEY | Веб-скрапинг и облачный браузер (firecrawl.dev) |
FIRECRAWL_API_URL | Пользовательская конечная точка Firecrawl API для автономных экземпляров (необязательно) |
TAVILY_API_KEY | Tavily API ключ для поиска, извлечения и сканирования в Интернете с помощью искусственного интеллекта (app.tavily.com) |
SEARXNG_URL | Экземпляр SearXNG URL для бесплатного поиска в Интернете на собственном хостинге — ключ API не требуется (searxng.github.io) |
TAVILY_BASE_URL | Переопределить конечную точку Tavily API. Полезно для корпоративных прокси и локальных Tavily-совместимых поисковых серверов. Та же схема, что и GROQ_BASE_URL. |
EXA_API_KEY | Exa API ключ для поиска и содержимого в Интернете с помощью искусственного интеллекта (exa.ai) |
YANDEX_SEARCH_API_KEY | Поиск в Яндексе Cloud API ключ для Russian/Cyrillic web_search (Поиск API) |
YANDEX_FOLDER_ID | Идентификатор папки Яндекс Облака (Поиск API + YandexART) |
BROWSERBASE_API_KEY | Автоматизация браузера (browserbase.com) |
BROWSERBASE_PROJECT_ID | Browserbase идентификатор проекта |
BROWSER_USE_API_KEY | Browser Use облачный браузер API ключ (browser-use.com) |
FIRECRAWL_BROWSER_TTL | Firecrawl сеанс браузера TTL в секундах (по умолчанию: 300) |
BROWSER_CDP_URL | Chrome Протокол DevTools URL для локального браузера (устанавливается через /browser connect, например ws://localhost:9222) |
CAMOFOX_URL | Локальный браузер защиты от обнаружения Camofox URL (по умолчанию: http://localhost:9377) |
CAMOFOX_USER_ID | Дополнительный идентификатор пользователя Camofox, управляемый извне, для общих видимых сеансов |
CAMOFOX_SESSION_KEY | Дополнительный сеансовый ключ Camofox, используемый при создании вкладок для CAMOFOX_USER_ID |
CAMOFOX_ADOPT_EXISTING_TAB | Установите значение true, чтобы повторно использовать существующую вкладку Camofox перед созданием новой |
BROWSER_INACTIVITY_TIMEOUT | Тайм-аут бездействия сеанса браузера в секундах |
AGENT_BROWSER_ARGS | Дополнительные флаги запуска Chromium (разделенные запятой или новой строкой). VibeOS автоматически внедряет --no-sandbox,--disable-dev-shm-usage при запуске от имени пользователя root или в пространствах имен непривилегированных пользователей, ограниченных AppArmor (Ubuntu 23.10+, DGX Spark, многие образы контейнеров); установите это вручную только для переопределения или добавления других флагов. |
FAL_KEY | Генерация изображения (fal.ai) |
YANDEX_ART_API_KEY | Генерация изображений YandexART (Yandex Cloud) — в паре с YANDEX_FOLDER_ID |
YANDEX_FOLDER_ID | Идентификатор папки Яндекс Облака для art://<folder>/yandex-art/latest |
GROQ_API_KEY | Грок Шепот STT API key (groq.com) |
ELEVENLABS_API_KEY | Премиум ElevenLabs TTS голоса (elevenlabs.io) |
STT_GROQ_MODEL | Переопределить модель Groq STT (по умолчанию: whisper-large-v3-turbo) |
GROQ_BASE_URL | Переопределить Groq OpenAI-совместимую STT конечную точку |
STT_OPENAI_MODEL | Переопределить модель OpenAI STT (по умолчанию: whisper-1) |
STT_OPENAI_BASE_URL | Переопределить OpenAI-совместимую STT конечную точку |
GITHUB_TOKEN | Токен GitHub для Skills Hub (более высокие ограничения API, публикация навыков) |
HONCHO_API_KEY | Межсессионное моделирование пользователей (honcho.dev) |
HONCHO_BASE_URL | База URL для локальных экземпляров Honcho (по умолчанию: Honcho облако). Для локальных экземпляров ключ API не требуется |
HINDSIGHT_TIMEOUT | Тайм-аут в секундах для вызовов Hindsight провайдера памяти API (по умолчанию: 60). Используйте это, если ваш экземпляр Hindsight медленно отвечает во время /sync или on_session_switch и вы видите тайм-ауты в errors.log. |
SUPERMEMORY_API_KEY | Семантическая долговременная память с вызовом профиля и захватом сеанса (supermemory.ai) |
DAYTONA_API_KEY | Daytona облачные песочницы (daytona.io) |
Langfuse Observability
Переменные среды для встроенного плагина observability/langfuse. Установите их в ~/.vibeos/.env. Плагин также необходимо включить (vibeos plugins enable observability/langfuse или установить флажок в vibeos plugins), прежде чем какое-либо из этих условий вступит в силу.
| Переменная | Описание |
|---|---|
VIBEOS_LANGFUSE_PUBLIC_KEY | Langfuse открытый ключ проекта (pk-lf-...). Необходимый. |
VIBEOS_LANGFUSE_SECRET_KEY | Langfuse секретный ключ проекта (sk-lf-...). Необходимый. |
VIBEOS_LANGFUSE_BASE_URL | Langfuse сервер URL (по умолчанию: https://cloud.langfuse.com). Набор для самостоятельного размещения. |
VIBEOS_LANGFUSE_ENV | Тег среды на трассировках (production, staging, …) |
VIBEOS_LANGFUSE_RELEASE | Тег Release/version на трассировках |
VIBEOS_LANGFUSE_SAMPLE_RATE | SDK частота дискретизации 0,0–1,0 (по умолчанию: 1.0) |
VIBEOS_LANGFUSE_MAX_CHARS | Усечение по полю для сериализованных полезных данных (по умолчанию: 12000) |
VIBEOS_LANGFUSE_DEBUG | true включает подробную регистрацию плагина в agent.log |
LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY / LANGFUSE_BASE_URL | Стандартные Langfuse SDK имена. Принимается в качестве резервного варианта, если эквиваленты VIBEOS_LANGFUSE_* не установлены. |
Nous Tool Gateway
Эти переменные настраивают Tool Gateway для платного использования подписчики Nous или развертывание самостоятельного шлюза. Большинству пользователей не требуется их устанавливать — шлюз настраивается автоматически через vibeos model или vibeos tools.
| Переменная | Описание |
|---|---|
TOOL_GATEWAY_DOMAIN | Базовый домен для маршрутизации Tool Gateway (по умолчанию: nousresearch.com) |
TOOL_GATEWAY_SCHEME | Схема HTTP или HTTPS для URL-адресов шлюза (по умолчанию: https) |
TOOL_GATEWAY_USER_TOKEN | Токен аутентификации для Tool Gateway (обычно заполняется автоматически из Nous auth) |
FIRECRAWL_GATEWAY_URL | Переопределить URL для конечной точки шлюза Firecrawl, в частности |
Серверная часть терминала
| Переменная | Описание |
|---|---|
TERMINAL_ENV | Серверная часть: local, docker, ssh, singularity, modal, daytona |
VIBEOS_DOCKER_BINARY | Переопределить двоичный файл контейнера, который VibeOS использует для оболочки (например, podman, /usr/local/bin/docker). Если этот параметр не установлен, VibeOS автоматически обнаруживает docker или podman на PATH. Требуется, когда оба установлены и вам нужен вариант, отличный от значения по умолчанию, или когда двоичный файл находится за пределами PATH. |
TERMINAL_DOCKER_IMAGE | Изображение Docker (по умолчанию: nikolaik/python-nodejs:python3.11-nodejs20) |
TERMINAL_DOCKER_FORWARD_ENV | JSON массив имен переменных среды для явной пересылки в сеансы терминала Docker. Примечание: required_environment_variables, объявленные в навыках, пересылаются автоматически — это нужно только для переменных, не объявленных ни в одном навыке. |
TERMINAL_DOCKER_VOLUMES | Дополнительные монтируемые тома Docker (пары host:container, разделенные запятыми) |
TERMINAL_DOCKER_MOUNT_CWD_TO_WORKSPACE | Расширенное разрешение: смонтируйте cwd запуска в Docker /workspace (true/false, по умолчанию: false) |
TERMINAL_SINGULARITY_IMAGE | Singularity изображение или .sif путь |
TERMINAL_MODAL_IMAGE | Modal образ контейнера |
TERMINAL_DAYTONA_IMAGE | Daytona изображение песочницы |
TERMINAL_TIMEOUT | Тайм-аут команды в секундах |
TERMINAL_LIFETIME_SECONDS | Максимальное время жизни терминальных сессий в секундах |
TERMINAL_CWD | Устарело прямое переопределение для сеансов терминала gateway/cron. Предпочитайте terminal.cwd в config.yaml; CLI по-прежнему использует каталог запуска. |
SUDO_PASSWORD | Включить sudo без интерактивной подсказки |
Для серверных частей облачной песочницы постоянство ориентировано на файловую систему. TERMINAL_LIFETIME_SECONDS контролирует, когда VibeOS очищает бездействующий сеанс терминала, а при последующем возобновлении может воссоздаваться песочница, а не продолжать работать те же самые активные процессы.
SSH Серверная часть
| Переменная | Описание |
|---|---|
TERMINAL_SSH_HOST | Имя хоста удаленного сервера |
TERMINAL_SSH_USER | SSH имя пользователя |
TERMINAL_SSH_PORT | SSH порт (по умолчанию: 22) |
TERMINAL_SSH_KEY | Путь к закрытому ключу |
TERMINAL_SSH_PERSISTENT | Переопределить постоянную оболочку для SSH (по умолчанию: соответствует TERMINAL_PERSISTENT_SHELL) |
Ресурсы контейнера (Docker, Singularity, Modal, Daytona)
| Переменная | Описание |
|---|---|
TERMINAL_CONTAINER_CPU | CPU ядер (по умолчанию: 1) |
TERMINAL_CONTAINER_MEMORY | Память в МБ (по умолчанию: 5120) |
TERMINAL_CONTAINER_DISK | Диск в МБ (по умолчанию: 51200) |
TERMINAL_CONTAINER_PERSISTENT | Сохранять файловую систему контейнера между сеансами (по умолчанию: true) |
TERMINAL_SANDBOX_DIR | Каталог хоста для рабочих пространств и наложений (по умолчанию: ~/.vibeos/sandboxes/) |
Persistent Shell
| Переменная | Описание |
|---|---|
TERMINAL_PERSISTENT_SHELL | Включить постоянную оболочку для нелокальных серверных частей (по умолчанию: true). Также можно настроить через terminal.persistent_shell в config.yaml |
TERMINAL_LOCAL_PERSISTENT | Включить постоянную оболочку для локального бэкэнда (по умолчанию: false) |
TERMINAL_SSH_PERSISTENT | Переопределить постоянную оболочку для серверной части SSH (по умолчанию: соответствует TERMINAL_PERSISTENT_SHELL) |
Messaging
| Переменная | Описание |
|---|---|
TELEGRAM_BOT_TOKEN | Токен бота Telegram (от @BotFather) |
TELEGRAM_ALLOWED_USERS | Идентификаторы пользователей, разделенные запятыми, которым разрешено использовать бота (применяется к личным сообщениям, группам и форумам) |
TELEGRAM_GROUP_ALLOWED_USERS | Идентификаторы пользователей отправителя, разделенные запятыми, авторизованы только в groups/forums (предоставляет ли NOT доступ к DM). Значения в форме идентификатора чата (начинающиеся с -) по-прежнему учитываются как идентификаторы чата для обратной совместимости с конфигурациями до версии #17686 с предупреждением об устаревании. |
TELEGRAM_GROUP_ALLOWED_CHATS | Идентификаторы чата group/forum, разделенные запятыми; любой участник имеет право |
TELEGRAM_HOME_CHANNEL | По умолчанию Telegram chat/channel для доставки cron |
TELEGRAM_HOME_CHANNEL_NAME | Отображаемое имя домашнего канала Telegram |
TELEGRAM_CRON_THREAD_ID | Идентификатор темы форума для получения поставок cron; переопределяет TELEGRAM_HOME_CHANNEL_THREAD_ID только для cron. Используйте в режиме темы, чтобы ответы на сообщения cron открывали новый сеанс вместо входа в системное лобби (#24409). |
TELEGRAM_WEBHOOK_URL | Общедоступный HTTPS URL для режима веб-перехватчика (включает веб-перехватчик вместо опроса) |
TELEGRAM_WEBHOOK_PORT | Локальный порт прослушивания для сервера веб-перехватчика (по умолчанию: 8443) |
TELEGRAM_WEBHOOK_SECRET | Секретный токен Telegram возвращается в каждом обновлении для проверки. Требуется всякий раз, когда установлен TELEGRAM_WEBHOOK_URL — без него шлюз отказывается запускаться (GHSA-3vpc-7q5r-276h). Создайте с помощью openssl rand -hex 32. |
TELEGRAM_REACTIONS | Включить эмодзи-реакцию на сообщения во время обработки (по умолчанию: false) |
TELEGRAM_REQUIRE_MENTION | Требовать явный триггер, прежде чем отвечать в группах Telegram. Эквивалент telegram.require_mention в config.yaml. |
TELEGRAM_MENTION_PATTERNS | Массив JSON, список, разделенный новой строкой, или список шаблонов слов пробуждения, разделенных запятыми, принимаемых, когда Telegram включено ограничение упоминаний группы. Эквивалент telegram.mention_patterns. |
TELEGRAM_EXCLUSIVE_BOT_MENTIONS | Если эта функция включена, явные упоминания @...bot в группах Telegram направляются только к упомянутым именам пользователей ботов, прежде чем запускаются резервные копии ответа или пробуждающего слова. По умолчанию: true. Эквивалент telegram.exclusive_bot_mentions. |
TELEGRAM_REPLY_TO_MODE | Поведение ответа-ссылки: off, first (по умолчанию) или all. Соответствует шаблону Discord. |
TELEGRAM_IGNORED_THREADS | Разделенные запятыми Telegram форум topic/thread Идентификаторы, на которые бот никогда не отвечает |
TELEGRAM_PROXY | Прокси URL для соединений Telegram — переопределяет HTTPS_PROXY. Поддерживает http://, https://, socks5:// |
DISCORD_BOT_TOKEN | Discord токен бота |
DISCORD_ALLOWED_USERS | Разделенные запятыми идентификаторы пользователей Discord, которым разрешено использовать бота |
DISCORD_ALLOWED_ROLES | Идентификаторы ролей Discord, разделенные запятыми, разрешены для использования бота (ИЛИ с DISCORD_ALLOWED_USERS). Автоматически включает намерение участников. Полезно, когда команды модераторов отменяются — права на роли распространяются автоматически. |
DISCORD_ALLOWED_CHANNELS | Идентификаторы каналов Discord, разделенные запятыми. Если установлено, бот отвечает только по этим каналам (плюс DM, если это разрешено). Переопределяет config.yaml discord.allowed_channels. |
DISCORD_PROXY | Прокси URL для соединений Discord — переопределяет HTTPS_PROXY. Поддерживает http://, https://, socks5:// |
DISCORD_HOME_CHANNEL | Канал Discord по умолчанию для доставки cron |
DISCORD_HOME_CHANNEL_NAME | Отображаемое имя домашнего канала Discord |
DISCORD_COMMAND_SYNC_POLICY | Discord Политика синхронизации при запуске slash-команды: safe (разница и согласование), bulk (устаревшая версия tree.sync()) или off |
DISCORD_REQUIRE_MENTION | Требовать @упоминание перед ответом в каналах сервера |
DISCORD_FREE_RESPONSE_CHANNELS | Идентификаторы каналов, разделенные запятыми, где упоминание не требуется |
DISCORD_AUTO_THREAD | Автоматическая последовательность длинных ответов, если поддерживается |
DISCORD_ALLOW_ANY_ATTACHMENT | При true принимайте вложения любого типа файлов (а не только встроенный список разрешенных PDF/text/zip/office). Неизвестные типы кэшируются и предоставляются агенту как локальный путь, чтобы он мог проверить их через terminal / read_file / ffprobe. По умолчанию false. |
DISCORD_MAX_ATTACHMENT_BYTES | Максимальное количество байтов на вложение, которое шлюз будет кэшировать. По умолчанию 33554432 (32 МБ). Установите значение 0 для отсутствия ограничения (вложения сохраняются в памяти во время записи). |
DISCORD_REACTIONS | Включить эмодзи-реакцию на сообщения во время обработки (по умолчанию: true) |
DISCORD_IGNORED_CHANNELS | Идентификаторы каналов, разделенные запятыми, на которые бот никогда не отвечает |
DISCORD_NO_THREAD_CHANNELS | Идентификаторы каналов, разделенные запятыми, на которые бот отвечает без автоматической обработки |
DISCORD_REPLY_TO_MODE | Поведение ответа-ссылки: off, first (по умолчанию) или all |
DISCORD_ALLOW_MENTION_EVERYONE | Разрешите боту пинговать @everyone/@here (по умолчанию: false). См. Контроль упоминаний. |
DISCORD_ALLOW_MENTION_ROLES | Разрешить боту проверять упоминания @role (по умолчанию: false). |
DISCORD_ALLOW_MENTION_USERS | Разрешить боту проверять отдельные упоминания @user (по умолчанию: true). |
DISCORD_ALLOW_MENTION_REPLIED_USER | Отправьте пинг автору при ответе на его сообщение (по умолчанию: true). |
SLACK_BOT_TOKEN | Slack токен бота (xoxb-...) |
SLACK_APP_TOKEN | Slack токен уровня приложения (xapp-..., требуется для режима сокета) |
SLACK_ALLOWED_USERS | Идентификаторы пользователей Slack, разделенные запятыми |
SLACK_HOME_CHANNEL | Канал Slack по умолчанию для доставки cron |
SLACK_HOME_CHANNEL_NAME | Отображаемое имя домашнего канала Slack |
GOOGLE_CHAT_PROJECT_ID | Проект GCP, в котором размещена тема Pub/Sub (возврат к GOOGLE_CLOUD_PROJECT) |
GOOGLE_CHAT_SUBSCRIPTION_NAME | Полный путь подписки Pub/Sub, projects/{proj}/subscriptions/{sub} (старый псевдоним: GOOGLE_CHAT_SUBSCRIPTION) |
GOOGLE_CHAT_SERVICE_ACCOUNT_JSON | Путь к учетной записи службы JSON или встроенный JSON (возврат к GOOGLE_APPLICATION_CREDENTIALS) |
GOOGLE_CHAT_ALLOWED_USERS | Адреса электронной почты пользователей, разделенные запятыми, которым разрешено общение с ботом |
GOOGLE_CHAT_ALLOW_ALL_USERS | Разрешить любому Google пользователю чата запускать бота (только для разработчиков) |
GOOGLE_CHAT_HOME_CHANNEL | Пространство по умолчанию (например, spaces/AAAA...) для доставки cron |
GOOGLE_CHAT_HOME_CHANNEL_NAME | Отображаемое имя для Google главного пространства чата |
GOOGLE_CHAT_MAX_MESSAGES | Pub/Sub Максимальное количество сообщений FlowControl в полете (по умолчанию: 1) |
GOOGLE_CHAT_MAX_BYTES | Pub/Sub Максимальное количество байт в потоке FlowControl (по умолчанию: 16777216, 16 МБ) |
GOOGLE_CHAT_BOOTSTRAP_SPACES | Дополнительные идентификаторы, разделенные запятыми, которые будут проверяться при запуске при разрешении собственных users/{id} |
бота. GOOGLE_CHAT_DEBUG_RAW | Установите любое значение для регистрации отредактированных конвертов Pub/Sub на уровне DEBUG (только отладка) |
WHATSAPP_ENABLED | Включите мост WhatsApp (true/false) |
WHATSAPP_MODE | bot (отдельный номер) или self-chat (напишите сами) |
WHATSAPP_ALLOWED_USERS | Телефонные номера, разделенные запятыми (с кодом страны, без +) или *, чтобы разрешить всем отправителям |
WHATSAPP_ALLOW_ALL_USERS | Разрешить всем WhatsApp отправителям без белого списка (true/false) |
WHATSAPP_DEBUG | Регистрируйте события необработанных сообщений на мосту для устранения неполадок (true/false) |
WHATSAPP_CLOUD_PHONE_NUMBER_ID | Мета-идентификатор номера телефона из WhatsApp Business Cloud API (15–17 цифр; не сам номер телефона) |
WHATSAPP_CLOUD_ACCESS_TOKEN | Мета-токен доступа (начинается с EAA); срок действия временных токенов истекает через 24 часа, токены пользователей системы являются постоянными |
WHATSAPP_CLOUD_APP_SECRET | Шестнадцатеричный секрет приложения из 32 символов, используемый для проверки подписей входящих веб-перехватчиков |
WHATSAPP_CLOUD_VERIFY_TOKEN | Общий секрет для рукопожатия проверки веб-перехватчика Meta (автоматически создается мастером настройки) |
WHATSAPP_CLOUD_ALLOWED_USERS | wa_ids, разделенные запятыми (номера телефонов с кодом страны, без +), разрешено отправлять сообщения боту |
WHATSAPP_CLOUD_ALLOW_ALL_USERS | Разрешить всем WhatsApp облачных отправителей без белого списка (true/false) |
WHATSAPP_CLOUD_APP_ID | Дополнительный идентификатор мета-приложения (для будущей интеграции аналитики) |
WHATSAPP_CLOUD_WABA_ID | Необязательный WhatsApp Идентификатор бизнес-аккаунта (для будущей интеграции аналитики) |
WHATSAPP_CLOUD_WEBHOOK_HOST | Интерфейс, к которому привязывается входящий сервер веб-перехватчика (по умолчанию 0.0.0.0) |
WHATSAPP_CLOUD_WEBHOOK_PORT | Порт, к которому привязан сервер входящего веб-перехватчика (по умолчанию 8090) |
WHATSAPP_CLOUD_WEBHOOK_PATH | URL путь Мета отправляет входящие сообщения на (по умолчанию /whatsapp/webhook) |
WHATSAPP_CLOUD_API_VERSION | Метаграфик API версия для вызова (по умолчанию v20.0) |
WHATSAPP_CLOUD_HOME_CHANNEL | wa_id для использования в качестве домашнего канала бота (для заданий cron и т. д.) |
WHATSAPP_CLOUD_DM_POLICY | стробирование DM для облачного адаптера (open/allowlist/disabled); возвращается к WHATSAPP_DM_POLICY, если не установлено |
WHATSAPP_CLOUD_ALLOW_FROM | Отправители, разделенные запятыми, разрешены, когда dm_policy: allowlist (пустой wa_ids; JID в стиле Baileys нормализованы) |
WHATSAPP_CLOUD_GROUP_POLICY | Групповое шлюзование для облачного адаптера (open/allowlist/disabled); возвращается к WHATSAPP_GROUP_POLICY, если не установлено |
WHATSAPP_CLOUD_GROUP_ALLOW_FROM | Идентификаторы группового чата, разделенные запятыми, разрешены, если group_policy: allowlist |
SIGNAL_HTTP_URL | демон signal-cli HTTP конечная точка (например, http://127.0.0.1:8080) |
SIGNAL_ACCOUNT | Номер телефона бота в формате E.164 |
SIGNAL_ALLOWED_USERS | Номера телефонов E.164 или UUID, разделенные запятыми |
SIGNAL_GROUP_ALLOWED_USERS | Идентификаторы групп, разделенные запятыми, или * для всех групп |
SIGNAL_HOME_CHANNEL_NAME | Отображаемое имя домашнего канала Signal |
SIGNAL_IGNORE_STORIES | Игнорировать Signal stories/status обновления |
SIGNAL_ALLOW_ALL_USERS | Разрешить всем Signal пользователей без белого списка |
TWILIO_ACCOUNT_SID | Учетная запись Twilio SID (совместно с навыками телефонии) |
TWILIO_AUTH_TOKEN | Токен аутентификации Twilio (совместно с навыком телефонии; также используется для проверки подписи веб-перехватчика) |
TWILIO_PHONE_NUMBER | Номер телефона Twilio в формате E.164 (совместно с навыком телефонии) |
SMS_WEBHOOK_URL | Общедоступный URL для проверки подписи Twilio — должен соответствовать веб-перехватчику URL в консоли Twilio (обязательно) |
SMS_WEBHOOK_PORT | Порт прослушивателя веб-перехватчика для входящего трафика SMS (по умолчанию: 8080) |
SMS_WEBHOOK_HOST | Адрес привязки веб-перехватчика (по умолчанию: 0.0.0.0) |
SMS_INSECURE_NO_SIGNATURE | Установите значение true, чтобы отключить проверку подписи Twilio (только для локальных разработчиков — не для рабочей среды) |
SMS_ALLOWED_USERS | Телефонные номера E.164, разделенные запятыми, разрешены для общения в чате |
SMS_ALLOW_ALL_USERS | Разрешить всем отправителям SMS без списка разрешенных |
SMS_HOME_CHANNEL | Номер телефона для заданий cron/доставки уведомлений |
SMS_HOME_CHANNEL_NAME | Отображаемое имя домашнего канала SMS |
EMAIL_ADDRESS | Адрес электронной почты адаптера шлюза электронной почты |
EMAIL_PASSWORD | Пароль или пароль приложения для учетной записи электронной почты |
EMAIL_IMAP_HOST | IMAP имя хоста для адаптера электронной почты |
EMAIL_IMAP_PORT | IMAP порт |
EMAIL_SMTP_HOST | SMTP имя хоста для адаптера электронной почты |
EMAIL_SMTP_PORT | SMTP порт |
EMAIL_ALLOWED_USERS | Адреса электронной почты, разделенные запятыми, разрешенные для отправки сообщений боту |
EMAIL_HOME_ADDRESS | Получатель по умолчанию для упреждающей доставки электронной почты |
EMAIL_HOME_ADDRESS_NAME | Отображаемое имя для домашней страницы электронной почты |
EMAIL_POLL_INTERVAL | Интервал опроса электронной почты в секундах |
EMAIL_ALLOW_ALL_USERS | Разрешить всем отправителям входящей электронной почты |
DINGTALK_CLIENT_ID | DingTalk бот AppKey с портала разработчиков (open.dingtalk.com) |
DINGTALK_CLIENT_SECRET | DingTalk бот AppSecret с портала разработчиков |
DINGTALK_ALLOWED_USERS | Разделенные запятыми идентификаторы пользователей DingTalk, которым разрешено отправлять сообщения боту |
FEISHU_APP_ID | Feishu/Lark Идентификатор приложения бота от open.feishu.cn |
FEISHU_APP_SECRET | Feishu/Lark Секрет приложения бота |
FEISHU_DOMAIN | feishu (Китай) или lark (международный). По умолчанию: feishu |
FEISHU_CONNECTION_MODE | websocket (рекомендуется) или webhook. По умолчанию: websocket |
FEISHU_ENCRYPT_KEY | Дополнительный ключ шифрования для режима веб-перехватчика |
FEISHU_VERIFICATION_TOKEN | Дополнительный токен проверки для режима веб-перехватчика |
FEISHU_ALLOWED_USERS | Разделенные запятыми идентификаторы пользователей Feishu, которым разрешено отправлять сообщения боту |
FEISHU_ALLOW_BOTS | none (по умолчанию) / mentions / all — принимать входящие сообщения от других ботов. См. обмен сообщениями между ботами |
FEISHU_REQUIRE_MENTION | true (по умолчанию) / false — должны ли групповые сообщения @упоминать бота. Переопределить каждый чат через group_rules.<chat_id>.require_mention. |
FEISHU_HOME_CHANNEL | Feishu Идентификатор чата для доставки cron и уведомлений |
WECOM_BOT_ID | WeCom Идентификатор AI-бота из консоли администратора |
WECOM_SECRET | WeCom Секрет AI-бота |
WECOM_WEBSOCKET_URL | Пользовательский WebSocket URL (по умолчанию: wss://openws.work.weixin.qq.com) |
WECOM_ALLOWED_USERS | Разделенные запятыми идентификаторы пользователей WeCom, которым разрешено отправлять сообщения боту |
WECOM_HOME_CHANNEL | WeCom Идентификатор чата для доставки cron и уведомлений |
WECOM_CALLBACK_CORP_ID | WeCom Enterprise Corp ID для самостоятельного приложения обратного вызова |
WECOM_CALLBACK_CORP_SECRET | Корпоративный секрет самостоятельно созданного приложения |
WECOM_CALLBACK_AGENT_ID | Идентификатор агента собственного приложения |
WECOM_CALLBACK_TOKEN | Токен подтверждения обратного вызова |
WECOM_CALLBACK_ENCODING_AES_KEY | AES ключ для шифрования обратного вызова |
WECOM_CALLBACK_HOST | Адрес привязки сервера обратного вызова (по умолчанию: 0.0.0.0) |
WECOM_CALLBACK_PORT | Порт сервера обратного вызова (по умолчанию: 8645) |
WECOM_CALLBACK_ALLOWED_USERS | Идентификаторы пользователей, разделенные запятыми, для белого списка |
WECOM_CALLBACK_ALLOW_ALL_USERS | Установите true, чтобы разрешить всем пользователям без списка разрешенных |
WEIXIN_ACCOUNT_ID | Weixin Идентификатор учетной записи, полученный через QR-логин через бота iLink API |
WEIXIN_TOKEN | Weixin токен аутентификации, полученный посредством входа в QR-код через бота iLink API |
WEIXIN_BASE_URL | Переопределить Weixin iLink Bot API base URL (по умолчанию: https://ilinkai.weixin.qq.com) |
WEIXIN_CDN_BASE_URL | Переопределить Weixin CDN базу URL для носителя (по умолчанию: https://novac2c.cdn.weixin.qq.com/c2c) |
WEIXIN_DM_POLICY | Политика прямых сообщений: open, allowlist, pairing, disabled (по умолчанию: open) |
WEIXIN_GROUP_POLICY | Политика групповых сообщений: open, allowlist, disabled (по умолчанию: disabled) |
WEIXIN_ALLOWED_USERS | Разделенные запятыми идентификаторы пользователей Weixin, которым разрешено отправлять боту личные сообщения |
WEIXIN_GROUP_ALLOWED_USERS | Разделенные запятыми Weixin идентификаторы группового чата (не идентификаторы пользователей-участников), которым разрешено взаимодействовать с ботом. Имя переменной устаревшее — оно ожидает идентификаторы групп. Вступает в силу только тогда, когда iLink действительно доставляет групповые события; Идентификаторы ботов iLink (...@im.bot) с QR-входом обычно не получают обычные групповые сообщения WeChat. |
WEIXIN_HOME_CHANNEL | Weixin Идентификатор чата для доставки cron и уведомлений |
WEIXIN_HOME_CHANNEL_NAME | Отображаемое имя домашнего канала Weixin |
WEIXIN_ALLOW_ALL_USERS | Разрешить всем Weixin пользователей без белого списка (true/false) |
BLUEBUBBLES_SERVER_URL | BlueBubbles сервер URL (например, http://192.168.1.10:1234) |
BLUEBUBBLES_PASSWORD | BlueBubbles пароль сервера |
BLUEBUBBLES_WEBHOOK_HOST | Адрес привязки прослушивателя веб-перехватчика (по умолчанию: 127.0.0.1) |
BLUEBUBBLES_WEBHOOK_PORT | Порт прослушивателя веб-перехватчика (по умолчанию: 8645) |
BLUEBUBBLES_HOME_CHANNEL | Phone/email для доставки cron/notification |
BLUEBUBBLES_ALLOWED_USERS | Авторизованные пользователи, разделенные запятыми |
BLUEBUBBLES_ALLOW_ALL_USERS | Разрешить всем пользователям (true/false) |
QQ_APP_ID | Идентификатор приложения QQ Bot от q.qq.com |
QQ_CLIENT_SECRET | Секрет приложения QQ Bot от q.qq.com |
QQ_STT_API_KEY | Ключ API для внешнего STT резервного поставщика (необязательно, используется, когда встроенный QQ ASR не возвращает текст) |
QQ_STT_BASE_URL | База URL для внешнего STT провайдера (опционально) |
QQ_STT_MODEL | Название модели внешнего поставщика STT (необязательно) |
QQ_ALLOWED_USERS | Открытые идентификаторы пользователей QQ, разделенные запятыми, которым разрешено отправлять сообщения боту |
QQ_GROUP_ALLOWED_USERS | Идентификаторы групп QQ, разделенные запятыми, для группового доступа к @-сообщениям |
QQ_ALLOW_ALL_USERS | Разрешить всем пользователям (true/false, переопределяет QQ_ALLOWED_USERS) |
QQBOT_HOME_CHANNEL | QQ user/group openID для доставки cron и уведомлений |
QQBOT_HOME_CHANNEL_NAME | Отображаемое имя домашнего канала QQ |
QQ_PORTAL_HOST | Переопределить хост портала QQ (установить sandbox.q.qq.com для маршрутизации через шлюз песочницы; по умолчанию: q.qq.com). |
MATTERMOST_URL | Mattermost сервер URL (например, https://mm.example.com) |
MATTERMOST_TOKEN | Токен бота или токен личного доступа для Mattermost |
MATTERMOST_ALLOWED_USERS | Разделенные запятыми идентификаторы пользователей Mattermost, которым разрешено отправлять сообщения боту |
MATTERMOST_HOME_CHANNEL | Идентификатор канала для упреждающей доставки сообщений (cron, уведомления) |
MATTERMOST_REQUIRE_MENTION | Требовать @mention в каналах (по умолчанию: true). Установите false, чтобы отвечать на все сообщения. |
MATTERMOST_FREE_RESPONSE_CHANNELS | Идентификаторы каналов, разделенные запятыми, на которые бот отвечает без @mention |
MATTERMOST_REPLY_MODE | Стиль ответа: thread (цепочные ответы) или off (простые сообщения, по умолчанию) |
MATRIX_HOMESERVER | Matrix домашний сервер URL (например, https://matrix.org) |
MATRIX_ACCESS_TOKEN | Matrix токен доступа для аутентификации бота |
MATRIX_USER_ID | Matrix идентификатор пользователя (например, @vibeos:matrix.org) — требуется для входа в систему с помощью пароля, необязательно с токеном доступа |
MATRIX_PASSWORD | Matrix пароль (альтернатива токену доступа) |
MATRIX_ALLOWED_USERS | Разделенные запятыми идентификаторы пользователей Matrix, которым разрешено отправлять сообщения боту (например, @alice:matrix.org) |
MATRIX_ALLOWED_ROOMS | Разделенные запятыми идентификаторы комнат Matrix позволяют запускать ответы ботов |
MATRIX_HOME_ROOM | Идентификатор комнаты для упреждающей доставки сообщений (например, !abc123:matrix.org) |
MATRIX_ENCRYPTION | Включить сквозное шифрование (true/false, по умолчанию: false) |
MATRIX_E2EE_MODE | Matrix E2EE поведение: off, optional или required. Переопределяет MATRIX_ENCRYPTION, если установлено. |
MATRIX_DEVICE_ID | Стабильный идентификатор устройства Matrix для сохранения E2EE при перезапуске (например, VIBEOS_BOT). Без этого ключи E2EE меняются при каждом запуске и перерывах в расшифровке исторической комнаты. |
MATRIX_REACTIONS | Включить эмодзи-реакции жизненного цикла обработки на входящие сообщения (по умолчанию: true). Установите значение false, чтобы отключить. |
MATRIX_REQUIRE_MENTION | Требовать @mention в комнатах (по умолчанию: true). Установите false, чтобы отвечать на все сообщения. |
MATRIX_FREE_RESPONSE_ROOMS | Идентификаторы комнат, разделенные запятыми, на которые бот отвечает без @mention |
MATRIX_IGNORE_USER_PATTERNS | Регулярные выражения, разделенные запятыми, для Matrix bridge/appservice идентификаторов призрачных пользователей, которые нужно игнорировать |
MATRIX_PROCESS_NOTICES | Обработка входящих событий Matrix m.notice (по умолчанию: false) |
MATRIX_SESSION_SCOPE | Область сеанса Matrix для комнат проекта: auto, room или thread (по умолчанию: auto) |
MATRIX_TOOLS_ALLOW_CROSS_ROOM | Разрешить инструментам Matrix выбирать явные комнаты, отличные от текущей комнаты (по умолчанию: false) |
MATRIX_TOOLS_ALLOW_CROSS_ROOM_DESTRUCTIVE | Разрешить перекрестное использование инструментов Matrix redaction/invite-like; требуется MATRIX_TOOLS_ALLOW_CROSS_ROOM=true (по умолчанию: false) |
MATRIX_TOOLS_ALLOW_REDACTION | Разрешить Matrix выполнение инструмента редактирования сообщений (по умолчанию: false) |
MATRIX_TOOLS_ALLOW_INVITES | Разрешить Matrix выполнение инструмента приглашения (по умолчанию: false) |
MATRIX_TOOLS_ALLOW_ROOM_CREATE | Разрешить Matrix выполнение инструмента создания помещений (по умолчанию: false) |
MATRIX_ALLOW_ROOM_MENTIONS | Разрешить исходящие упоминания @room для уведомления всех участников комнаты (по умолчанию: false) |
MATRIX_AUTO_THREAD | Автоматически создавать темы для сообщений комнаты (по умолчанию: true) |
MATRIX_DM_MENTION_THREADS | Создайте тему, когда бот @mentioned в личном сообщении (по умолчанию: false) |
MATRIX_APPROVAL_REQUIRE_SENDER | Требовать, чтобы реакции approval/model-picker поступали от исходного отправителя запроса, если они известны (по умолчанию: true) |
MATRIX_APPROVAL_TIMEOUT_SECONDS | Таймаут для ответа Matrix на запросы approval/model-picker (по умолчанию: 300) |
MATRIX_ALLOW_PUBLIC_ROOMS | Разрешить Matrix инструментам создания комнат создавать общественные комнаты (по умолчанию: false) |
MATRIX_MAX_MEDIA_BYTES | Максимальный размер Matrix носителя upload/download в байтах (по умолчанию: 104857600) |
MATRIX_RECOVERY_KEY | Ключ восстановления для проверки перекрестной подписи после ротации ключа устройства. Рекомендуется для установок E2EE с включенной перекрестной подписью. |
MATRIX_RECOVERY_KEY_OUTPUT_FILE | Необязательный одноразовый путь для сгенерированного ключа восстановления Matrix. Создано в режиме 0600 и никогда не перезаписывается. |
HASS_TOKEN | Home Assistant Долгосрочный токен доступа (включает платформу высокой доступности + инструменты) |
HASS_URL | Home Assistant URL (по умолчанию: http://homeassistant.local:8123) |
WEBHOOK_ENABLED | Включите адаптер платформы веб-перехватчика (true/false) |
WEBHOOK_PORT | HTTP порт сервера для приема веб-перехватчиков (по умолчанию: 8644) |
WEBHOOK_SECRET | Глобальный секрет HMAC для проверки подписи веб-перехватчика (используется как запасной вариант, когда маршруты не указывают свои собственные) |
API_SERVER_ENABLED | Включите OpenAI-совместимый API сервер (true/false). Работает вместе с другими платформами. |
API_SERVER_KEY | Токен носителя для аутентификации сервера API. Требуется всякий раз, когда включен сервер API. |
API_SERVER_CORS_ORIGINS | Источники браузера, разделенные запятыми, позволяли напрямую вызывать сервер API (например, http://localhost:3000,http://127.0.0.1:3000). По умолчанию: отключено. |
API_SERVER_PORT | Порт для сервера API (по умолчанию: 8642) |
API_SERVER_HOST | Host/bind адрес сервера API (по умолчанию: 127.0.0.1). API_SERVER_KEY по-прежнему требуется при обратной связи; используйте узкий список разрешенных API_SERVER_CORS_ORIGINS для доступа через браузер. |
API_SERVER_MODEL_NAME | Название модели рекламируется на /v1/models. По умолчанию используется имя профиля (или vibeos-agent для профиля по умолчанию). Полезно для многопользовательских настроек, где интерфейсы, такие как Open WebUI, требуют отдельных названий моделей для каждого соединения. |
GATEWAY_PROXY_URL | URL удаленного VibeOS API сервера для пересылки сообщений на (режим прокси). Если этот параметр установлен, шлюз обрабатывает только платформу I/O — вся работа агента делегируется удаленному серверу. Также можно настроить через gateway.proxy_url в config.yaml. |
GATEWAY_PROXY_KEY | Токен носителя для аутентификации на удаленном сервере API в режиме прокси. Должно соответствовать API_SERVER_KEY на удаленном хосте. |
MESSAGING_CWD | Устаревший запасной вариант совместимости для рабочего каталога шлюза. Предпочитайте terminal.cwd в config.yaml. |
GATEWAY_ALLOWED_USERS | Идентификаторы пользователей, разделенные запятыми, разрешены на всех платформах |
GATEWAY_ALLOW_ALL_USERS | Разрешить всем пользователям без списков разрешенных (true/false, по умолчанию: false) |
Веб-панель и VibeOS Desktop
Аутентификация для веб-панели и для подключения VibeOS Desktop к удаленному серверу. Согласно соглашению о конфиденциальности, учетные данные принадлежат ~/.vibeos/.env; OAuth client_id лучше настроить в dashboard.oauth в config.yaml (env выигрывает, если установлено).
Три провайдера аутентификации информационной панели поставляются в комплекте коробка. Для удаленного подключения VibeOS к рабочему столу или любой информационной панели с выходом в Интернет рекомендуемым поставщиком является OAuth (Nous Portal) — установите VIBEOS_DASHBOARD_OAUTH_CLIENT_ID (предоставьте ему vibeos dashboard register). Входящий в комплект поставщик username/password (VIBEOS_DASHBOARD_BASIC_AUTH_*) — это самый быстрый вариант серверной части на надежном LAN или за VPN, но он не подходит для прямого доступа в общедоступный Интернет. Для аутентификации у вашего собственного поставщика удостоверений используйте автономный поставщик OIDC (VIBEOS_DASHBOARD_OIDC_*). В любом случае привязка без обратной связи (vibeos dashboard --host 0.0.0.0) задействует шлюз аутентификации. Полную картину см. в разделе Веб-панель → Аутентификация.
| Переменная | Описание |
|---|---|
VIBEOS_DASHBOARD_BASIC_AUTH_USERNAME | Имя пользователя для встроенного поставщика аутентификации username/password (plugins/dashboard_auth/basic). Активирует провайдера при установке вместе с паролем. Переопределяет dashboard.basic_auth.username. |
VIBEOS_DASHBOARD_BASIC_AUTH_PASSWORD | Открытый пароль для базового поставщика (хешируется в памяти при загрузке). Выигрывает конфиг password_hash, так что вы можете вращать его через env. Переопределяет dashboard.basic_auth.password. |
VIBEOS_DASHBOARD_BASIC_AUTH_PASSWORD_HASH | scrypt хэш пароля для базового провайдера (предпочтительно — без открытого текста). Вычислите с помощью python -c "from plugins.dashboard_auth.basic import hash_password; print(hash_password('PW'))". Переопределяет dashboard.basic_auth.password_hash. |
VIBEOS_DASHBOARD_BASIC_AUTH_SECRET | Ключ HMAC (32+ байта, base64/hex/raw), подписывающий токены сеанса базового провайдера без сохранения состояния. Установите явно, чтобы сеансы выдерживали перезапуски/охватывали несколько рабочих процессов; пусто → случайно для каждого процесса (вы будете выходить из системы при каждом перезапуске). Переопределяет dashboard.basic_auth.secret. |
VIBEOS_DASHBOARD_BASIC_AUTH_TTL_SECONDS | Срок действия токена доступа для базового поставщика (по умолчанию 12 часов). Переопределяет dashboard.basic_auth.session_ttl_seconds. |
VIBEOS_DASHBOARD_OAUTH_CLIENT_ID | OAuth идентификатор клиента (agent:{instance_id}) для информационной панели gated/public, активирующий провайдера Nous (plugins/dashboard_auth/nous). Переопределяет dashboard.oauth.client_id. Предоставьте его с помощью vibeos dashboard register. |
VIBEOS_DASHBOARD_PUBLIC_URL | Полная общедоступная URL панель управления доступна для создания OAuth обратного вызова за обратными прокси. Переопределяет dashboard.public_url. |
VIBEOS_DASHBOARD_OIDC_ISSUER | OIDC эмитент URL для пакетного автономного провайдера OIDC (plugins/dashboard_auth/self_hosted). Требуется для его активации. Переопределяет dashboard.oauth.self_hosted.issuer. |
VIBEOS_DASHBOARD_OIDC_CLIENT_ID | Публичный идентификатор клиента OIDC (код авторизации + PKCE) для самостоятельного провайдера OIDC. Требуется для его активации. Переопределяет dashboard.oauth.self_hosted.client_id. |
VIBEOS_DASHBOARD_OIDC_SCOPES | Запрошены области OIDC для автономного провайдера OIDC (по умолчанию openid profile email). Переопределяет dashboard.oauth.self_hosted.scopes. |
VIBEOS_DESKTOP_REMOTE_URL | (Настольная сторона) База URL удаленного бэкэнда, например. http://host:9119. Если установлено, переопределяет шлюз в приложении URL; вы по-прежнему входите в систему с панели настроек шлюза (OAuth перенаправление или username/password, в зависимости от того, что рекламирует серверная часть). |
VIBEOS_DESKTOP_VIBEOS | Переопределение серверной команды рабочего стола. Используется packagers/Nix или для устранения неполадок, чтобы указать Electron на конкретный исполняемый файл vibeos после проверки серверной части. |
VIBEOS_DESKTOP_VIBEOS_ROOT | Переопределение извлечения исходного кода рабочего стола, используемое vibeos desktop --vibeos-root; проверяется перед пакетной установкой при первом запуске или перед существующей vibeos на PATH. |
VIBEOS_DESKTOP_IGNORE_EXISTING | Установите значение 1, чтобы рабочий стол игнорировал существующий vibeos на PATH во время внутреннего разрешения. Эквивалент vibeos desktop --ignore-existing. |
VIBEOS_DESKTOP_CWD | Начальный каталог проекта для сеансов чата на рабочем столе. Установлен vibeos desktop --cwd. |
Microsoft Graph (Teams Meetings)
Учетные данные только для приложения для клиента Microsoft Graph REST, используемого предстоящим конвейером сводки собраний Teams. См. раздел Регистрация приложения Microsoft Graph для ознакомления с описанием портала Azure и точными необходимыми разрешениями API.
| Переменная | Описание |
|---|---|
MSGRAPH_TENANT_ID | Azure Идентификатор клиента AD (каталог GUID) для регистрации приложения Graph. |
MSGRAPH_CLIENT_ID | Идентификатор приложения (клиента) регистрации приложения Azure. |
MSGRAPH_CLIENT_SECRET | Значение секрета клиента для регистрации приложения. Храните в ~/.vibeos/.env с помощью chmod 600; периодически вращайте через портал Azure. |
MSGRAPH_SCOPE | Область OAuth2 для запроса токена учетных данных клиента (по умолчанию: https://graph.microsoft.com/.default). |
MSGRAPH_AUTHORITY_URL | Полномочия платформы идентификации Microsoft (по умолчанию: https://login.microsoftonline.com). Переопределение только для облаков national/sovereign (например, https://login.microsoftonline.us для GCC High). |
Microsoft Graph Webhook Listener
Прослушиватель входящих уведомлений об изменениях для событий Graph (собрания Teams, календарь, чат и т. д.). См. Microsoft Graph Webhook Listener для настройки и усиления безопасности.
| Переменная | Описание |
|---|---|
MSGRAPH_WEBHOOK_ENABLED | Включите шлюзовую платформу msgraph_webhook (true/1/yes). |
MSGRAPH_WEBHOOK_PORT | Порт, к которому привязан прослушиватель (по умолчанию: 8646). |
MSGRAPH_WEBHOOK_CLIENT_STATE | Общий секретный график отображается в каждом уведомлении; по сравнению с hmac.compare_digest. Создайте с помощью openssl rand -hex 32. |
MSGRAPH_WEBHOOK_ACCEPTED_RESOURCES | Разделенный запятыми белый список ресурса Graph paths/patterns (например, communications/onlineMeetings,chats/*/messages). Завершающий * соответствует префиксу. Пусто = принять все. |
MSGRAPH_WEBHOOK_ALLOWED_SOURCE_CIDRS | Диапазоны CIDR, разделенные запятыми, разрешены для POST слушателю (например, 52.96.0.0/14,52.104.0.0/14). Пусто = разрешить все (по умолчанию). Ограничьте опубликованные выходные диапазоны Microsoft Graph в рабочей среде. |
Teams Summary Delivery
Используется только при включенном плагине teams_pipeline. Параметры также можно настроить в platforms.teams.extra в config.yaml — переменные env имеют приоритет, если установлены оба. См. Microsoft Teams → Доставка сводки собрания.
| Переменная | Описание |
|---|---|
TEAMS_DELIVERY_MODE | graph или incoming_webhook. |
TEAMS_INCOMING_WEBHOOK_URL | Веб-перехватчик URL, созданный Teams; требуется, когда TEAMS_DELIVERY_MODE=incoming_webhook. |
TEAMS_GRAPH_ACCESS_TOKEN | Предварительно полученный токен делегированного доступа для доставки Graph. Требуется редко — средство записи возвращается к учетным данным приложения MSGRAPH_*, если они не установлены. |
TEAMS_TEAM_ID | Идентификатор целевой группы для доставки канала (graph mode). |
TEAMS_CHANNEL_ID | Идентификатор целевого канала (в сочетании с TEAMS_TEAM_ID). |
TEAMS_CHAT_ID | Целевой 1:1 или идентификатор группового чата (альтернатива команде+каналу для режима graph). |
LINE Сообщения API
Используется в комплекте Плагин платформы LINE (plugins/platforms/line/). См. Шлюз обмена сообщениями → LINE для полной настройки.
| Переменная | Описание |
|---|---|
LINE_CHANNEL_ACCESS_TOKEN | Долговечный токен доступа к каналу из консоли разработчика LINE (вкладка «Сообщения API»). Необходимый. |
LINE_CHANNEL_SECRET | Секрет канала (вкладка Основные настройки); используется для HMAC-SHA256 проверки подписи веб-перехватчика. Необходимый. |
LINE_HOST | Хост привязки веб-перехватчика (по умолчанию: 0.0.0.0). |
LINE_PORT | Порт привязки веб-перехватчика (по умолчанию: 8646). |
LINE_PUBLIC_URL | Публичная HTTPS база URL (например, https://my-tunnel.example.com). Требуется для отправки изображений/аудио/видео — LINE принимает только HTTPS-доступные URL-адреса. |
LINE_ALLOWED_USERS | Идентификаторы пользователей, разделенные запятыми, позволяют отправлять боту личные сообщения (U-с префиксом). |
LINE_ALLOWED_GROUPS | Идентификаторы групп, разделенные запятыми, на которые бот будет отвечать (C-prefixed). |
LINE_ALLOWED_ROOMS | Идентификаторы комнат, разделенные запятыми, на которые бот ответит (R-prefixed). |
LINE_ALLOW_ALL_USERS | Аварийный люк только для разработчиков — принимает любой источник. По умолчанию: false. |
LINE_HOME_CHANNEL | Цель доставки по умолчанию для заданий cron с deliver: line. |
LINE_SLOW_RESPONSE_THRESHOLD | За несколько секунд до срабатывания обратной передачи медленных кнопок шаблона LLM (по умолчанию: 45). Установите 0 для отключения и всегда принудительного возврата. |
LINE_PENDING_TEXT | Текст в виде всплывающей подсказки, отображаемый рядом с кнопкой обратной передачи. |
LINE_BUTTON_LABEL | Метка кнопки обратной передачи (по умолчанию: Get answer). |
LINE_DELIVERED_TEXT | Ответить, когда уже доставленный постбэк будет повторно использован (по умолчанию: Already replied ✅). |
LINE_INTERRUPTED_TEXT | Ответить при нажатии потерянной кнопки обратной передачи /stop (по умолчанию: Run was interrupted before completion.). |
ntfy (push-уведомления)
ntfy — это облегченная служба push-уведомлений на основе HTTP. Подпишитесь на тему из ntfy мобильного приложения, опубликуйте ее в этой теме, чтобы поговорить с агентом.
| Переменная | Описание |
|---|---|
NTFY_TOPIC | Тема для подписки (входящие сообщения). Необходимый. |
NTFY_SERVER_URL | Сервер URL (по умолчанию: https://ntfy.sh). Для обеспечения конфиденциальности наведите указатель мыши на ntfy, размещенный самостоятельно. |
NTFY_TOKEN | Необязательный токен аутентификации. Токен носителя (например, tk_xyz) или user:pass для базовой аутентификации. |
NTFY_PUBLISH_TOPIC | Тема для исходящих ответов (по умолчанию NTFY_TOPIC). |
NTFY_MARKDOWN | Установите true для отправки ответов с заголовком X-Markdown: true. По умолчанию: false. |
NTFY_ALLOWED_USERS | Белый список (рассматривается как идентификаторы пользователей; в ntfy это названия тем). Обычно устанавливается то же значение, что и NTFY_TOPIC. |
NTFY_ALLOW_ALL_USERS | Аварийный люк только для разработчиков — безопасен только в частных темах с контролируемым доступом. По умолчанию: false. |
NTFY_HOME_CHANNEL | Цель доставки по умолчанию для заданий cron с deliver: ntfy. |
NTFY_HOME_CHANNEL_NAME | Человеческая метка домашнего канала (по умолчанию — название темы). |
Прочитайте руководство по обмену сообщениями ntfy — особенно раздел модель идентификации — перед развертыванием с ненадежными темы.
Расширенная настройка обмена сообщениями
Дополнительные ручки для каждой платформы для регулирования пакетирования исходящих сообщений. Большинству пользователей никогда не придется прикасаться к ним; настройки по умолчанию настроены на соблюдение ограничений скорости каждой платформы без ощущения вялости.
| Переменная | Описание |
|---|---|
VIBEOS_TELEGRAM_TEXT_BATCH_DELAY_SECONDS | Окно отсрочки перед очисткой текстового фрагмента Telegram, находящегося в очереди (по умолчанию: 0.6). |
VIBEOS_TELEGRAM_TEXT_BATCH_SPLIT_DELAY_SECONDS | Задержка между разделенными фрагментами, когда одно сообщение Telegram превышает предел длины (по умолчанию: 2.0). |
VIBEOS_TELEGRAM_MEDIA_BATCH_DELAY_SECONDS | Окно отсрочки перед очисткой носителя Telegram из очереди (по умолчанию: 0.6). |
VIBEOS_TELEGRAM_FOLLOWUP_GRACE_SECONDS | Задержка перед отправкой последующего сообщения после завершения работы агента, чтобы избежать ускорения последнего фрагмента потока. |
VIBEOS_TELEGRAM_HTTP_CONNECT_TIMEOUT / _READ_TIMEOUT / _WRITE_TIMEOUT / _POOL_TIMEOUT | Переопределить базовые таймауты python-telegram-bot HTTP (в секундах). |
VIBEOS_TELEGRAM_HTTP_POOL_SIZE | Максимальное количество одновременных HTTP подключений к Telegram API. |
VIBEOS_TELEGRAM_DISABLE_FALLBACK_IPS | Отключите жестко запрограммированные резервные IP-адреса Cloudflare, используемые в случае сбоя DNS (true/false). |
VIBEOS_DISCORD_TEXT_BATCH_DELAY_SECONDS | Окно отсрочки перед очисткой текстового фрагмента Discord, находящегося в очереди (по умолчанию: 0.6). |
VIBEOS_DISCORD_TEXT_BATCH_SPLIT_DELAY_SECONDS | Задержка между разделенными частями, когда сообщение Discord превышает предел длины (по умолчанию: 2.0). |
VIBEOS_DISCORD_LIVENESS_INTERVAL_SECONDS | Внутренний мост для discord.liveness_interval_seconds (config.yaml). Интервал для проверки Discord REST, которая обнаруживает клиентов-зомби за мертвыми proxies/NATs (по умолчанию: 60; установите значение 0 для отключения). Предпочитайте настройку discord.liveness_interval_seconds в config.yaml. |
VIBEOS_DISCORD_LIVENESS_FAILURE_THRESHOLD | Внутренний мост для discord.liveness_failure_threshold (config.yaml). Последовательные сбои зонда перед принудительным повторным подключением Discord (по умолчанию: 3). Предпочитайте настройку discord.liveness_failure_threshold в config.yaml. |
VIBEOS_MATRIX_TEXT_BATCH_DELAY_SECONDS / _SPLIT_DELAY_SECONDS | Matrix эквиваленты групповых ручек Telegram. |
VIBEOS_FEISHU_TEXT_BATCH_DELAY_SECONDS / _SPLIT_DELAY_SECONDS / _MAX_CHARS / _MAX_MESSAGES | Настройка Feishu дозатора — задержка, разделенная задержка, максимальное количество символов в сообщении, максимальное количество сообщений в пакете. |
VIBEOS_FEISHU_MEDIA_BATCH_DELAY_SECONDS | Feishu задержка очистки носителя. |
VIBEOS_FEISHU_DEDUP_CACHE_SIZE | Размер кэша дедупликации Feishu веб-перехватчика (по умолчанию: 1024). |
VIBEOS_WECOM_TEXT_BATCH_DELAY_SECONDS / _SPLIT_DELAY_SECONDS | WeCom настройка дозатора. |
VIBEOS_VISION_DOWNLOAD_TIMEOUT | Тайм-аут в секундах для загрузки изображения перед его передачей моделям машинного зрения (по умолчанию: 30). |
VIBEOS_RESTART_DRAIN_TIMEOUT | Шлюз: секунды ожидания истощения активных запусков на /restart перед принудительным перезапуском (по умолчанию: 900). |
VIBEOS_GATEWAY_PLATFORM_CONNECT_TIMEOUT | Тайм-аут подключения для каждой платформы во время запуска шлюза (в секундах). |
VIBEOS_GATEWAY_BUSY_INPUT_MODE | Поведение входа занятости шлюза по умолчанию: queue, steer или interrupt. Можно переопределить в чате с помощью /busy. |
VIBEOS_GATEWAY_BUSY_ACK_ENABLED | Отправляет ли шлюз подтверждающее сообщение (⚡/⏳/⏩), когда пользователь отправляет входные данные, пока агент занят (по умолчанию: true). Установите значение false, чтобы полностью подавить эти сообщения — ввод по-прежнему будет queued/steered/interrupts, как обычно, только ответ в чате будет отключен. Соединение display.busy_ack_enabled с config.yaml. |
VIBEOS_GATEWAY_NO_SUPERVISE | Внутри образа s6-оверлея Docker отключите автоматический контроль при запуске vibeos gateway run и используйте семантику переднего плана до s6 (без автоматического перезапуска, шлюз является основным процессом контейнера). Истинные значения: 1, true, yes. Эквивалент флага --no-supervise CLI. Никаких операций за пределами изображения 6-го сезона. |
VIBEOS_GATEWAY_BOOTSTRAP_STATE | Внутри образа s6-overlay Docker объявите исходное контролируемое состояние шлюза на новом томе. На пустом томе нет сохраненного gateway_state.json, поэтому средство согласования загрузки регистрирует слот gateway-default, но оставляет его неработающим (он запускается автоматически только в том случае, если последнее записанное состояние было running). Установите для этого параметра значение running и семена ловушки настройки первой загрузки gateway_state.json перед запуском примирителя, чтобы шлюз запускался при самой первой загрузке. Учитывается только буквальное значение running. Только при первой загрузке: существующий gateway_state.json никогда не перезаписывается, поэтому намеренно остановленный шлюз остается остановленным при перезапуске. Никаких операций за пределами изображения 6-го сезона. |
GATEWAY_RELAY_URL | Экспериментальный релейный разъем на базе WebSocket URL. Если этот параметр установлен, шлюз регистрирует универсальный адаптер relay и осуществляет исходящий вызов соединителя. Зеркала gateway.relay_url в config.yaml. |
GATEWAY_RELAY_ID | Идентификатор ретрансляционного шлюза, назначенный vibeos gateway enroll или управляемой самостоятельной инициализацией. Зеркала gateway.relay_id. |
GATEWAY_RELAY_SECRET | Секрет ретрансляции каждого шлюза, используемый для аутентификации WebSocket. Если это уже настроено, управляемая самоподготовка пропускается. Зеркала gateway.relay_secret. |
GATEWAY_RELAY_DELIVERY_KEY | Ключ доставки, выданный соединителем, сохраняется для совместимости с аутентификацией relay/passthrough. Текущие входящие ретрансляционные сообщения поступают на исходящий WebSocket, а не на получатель HTTP на стороне шлюза. |
GATEWAY_RELAY_ENROLL_TOKEN | Токен регистрации, используемый vibeos gateway enroll, когда --token не передается явно. |
GATEWAY_RELAY_PLATFORM | Необязательное имя платформы, объявленное в дескрипторе возможностей ретрансляции. |
GATEWAY_RELAY_BOT_ID | Необязательный идентификатор бота, объявленный в дескрипторе возможности ретрансляции. |
GATEWAY_RELAY_ENDPOINT | Дополнительная конечная точка шлюза, объявленная для режимов соединителя, которым требуется callback/passthrough URL; не требуется для входящего пути ретрансляции только для WS по умолчанию. Зеркала gateway.relay_endpoint. |
GATEWAY_RELAY_ROUTE_KEYS | Ключи маршрута ретрансляции, разделенные запятыми, объявляются соединителю. Зеркала gateway.relay_route_keys. |
VIBEOS_FILE_MUTATION_VERIFIER | Включите нижний колонтитул проверки изменений файлов за ход (по умолчанию: true). При включении VibeOS добавляет информационный список всех вызовов write_file / patch, которые завершились неудачно во время хода и не были заменены успешной записью. Установите 0, false, no или off для подавления. Зеркала display.file_mutation_verifier в config.yaml; env var выигрывает, если установлен. |
VIBEOS_CRON_TIMEOUT | Тайм-аут бездействия агента задания cron исчисляется секундами (по умолчанию: 600). Агент может работать бесконечно, активно вызывая инструменты или получая токены потока — это срабатывает только в режиме ожидания. Установите 0 для неограниченного доступа. |
VIBEOS_CRON_WALL_TIMEOUT | Абсолютный wall-clock тайм-аут агентских cron-запусков в секундах. Установите 0 для неограниченного доступа. Если не задан, desktop-spawned cron backend использует 3600; gateway cron вне desktop остается без абсолютного лимита, если не настроен cron.wall_timeout_seconds. |
VIBEOS_CRON_SCRIPT_TIMEOUT | Тайм-аут для предзапускаемых сценариев, прикрепленных к заданиям cron, в секундах (по умолчанию: 120). Переопределить сценарии, требующие более длительного выполнения (например, случайные задержки для защиты от ботов). Также можно настроить через cron.script_timeout_seconds в config.yaml. |
VIBEOS_CRON_MAX_PARALLEL | Максимальное количество заданий cron, выполняемых параллельно за такт (по умолчанию: 4). |
Поведение агента
| Переменная | Описание |
|---|---|
VIBEOS_MAX_ITERATIONS | Максимальное количество итераций вызова инструмента за диалог (по умолчанию: 90) |
VIBEOS_INFERENCE_MODEL | Переопределить имя модели на уровне процесса (имеет приоритет над config.yaml для сеанса). Также можно установить с помощью флага -m/--model. |
VIBEOS_YOLO_MODE | Установите значение 1, чтобы обойти запросы на одобрение опасных команд. Эквивалент --yolo. |
VIBEOS_ACCEPT_HOOKS | Автоматически утверждать любые невидимые перехватчики оболочки, объявленные в config.yaml, без запроса TTY. Эквивалент --accept-hooks или hooks_auto_accept: true. |
VIBEOS_IGNORE_USER_CONFIG | Пропустите ~/.vibeos/config.yaml и используйте встроенные настройки по умолчанию (учетные данные в .env все еще загружаются). Эквивалент --ignore-user-config. |
VIBEOS_IGNORE_RULES | Пропустите автоматическое внедрение AGENTS.md, SOUL.md, .cursorrules, памяти и предварительно загруженных навыков. Эквивалент --ignore-rules. |
VIBEOS_SAFE_MODE | Режим устранения неполадок: отключить настройки ALL — пропускает обнаружение плагинов и загрузку сервера MCP. Устанавливается автоматически --safe-mode (который также устанавливает два вышеуказанных флага). |
VIBEOS_MD_NAMES | Разделенный запятыми список имен файлов правил для автоматического внедрения (по умолчанию: AGENTS.md,CLAUDE.md,.cursorrules,SOUL.md). |
VIBEOS_TOOL_PROGRESS | Устаревшая переменная совместимости для отображения хода работы инструмента. Предпочитайте display.tool_progress в config.yaml. |
VIBEOS_TOOL_PROGRESS_MODE | Устаревшая переменная совместимости для режима работы инструмента. Предпочитайте display.tool_progress в config.yaml. |
VIBEOS_HUMAN_DELAY_MODE | Скорость ответа: off/natural/custom |
VIBEOS_HUMAN_DELAY_MIN_MS | Минимальный диапазон пользовательской задержки (мс) |
VIBEOS_HUMAN_DELAY_MAX_MS | Максимальный диапазон пользовательской задержки (мс) |
VIBEOS_QUIET | Подавить несущественный вывод (true/false) |
VIBEOS_KANBAN_TASK | Устанавливается диспетчером канбана при создании работника (задача UUID). Рабочие процессы и порожденный подпроцесс vibeos-tools MCP наследуют его, поэтому инструменты канбана работают правильно. Не устанавливайте вручную. |
VIBEOS_API_TIMEOUT | LLM API время ожидания вызова в секундах (по умолчанию: 1800) |
VIBEOS_API_CALL_STALE_TIMEOUT | Тайм-аут устаревшего вызова без потоковой передачи в секундах (по умолчанию: 90). Автоматически отключается для местных провайдеров, если не настроено, и может масштабироваться вверх для очень больших контекстов. Также можно настроить через providers.<id>.stale_timeout_seconds или providers.<id>.models.<model>.stale_timeout_secondsвconfig.yaml`. |
VIBEOS_STREAM_READ_TIMEOUT | Таймаут чтения сокета потоковой передачи в секундах (по умолчанию: 120). Автоматически увеличено до VIBEOS_API_TIMEOUT для местных провайдеров. Увеличьте значение, если время ожидания локальных LLM истекло во время генерации длинного кода. |
VIBEOS_STREAM_STALE_TIMEOUT | Тайм-аут обнаружения устаревшего потока в секундах (по умолчанию: 180). Автоматически отключено для местных провайдеров. Запускает прекращение соединения, если в течение этого окна не поступает ни одного фрагмента. |
VIBEOS_STREAM_RETRIES | Количество попыток повторного подключения в середине потока при временных сетевых ошибках (по умолчанию: 3). |
VIBEOS_AGENT_TIMEOUT | Тайм-аут бездействия шлюза для работающего агента в секундах (по умолчанию: 1800, 30 минут). Сбрасывается при каждом вызове инструмента и потоковом токене. Установите значение 0, чтобы отключить. |
VIBEOS_AGENT_TIMEOUT_WARNING | Шлюз: отправить предупреждающее сообщение после указанного количества секунд бездействия (по умолчанию: 75% от VIBEOS_AGENT_TIMEOUT). |
VIBEOS_AGENT_NOTIFY_INTERVAL | Шлюз: интервал в секундах между уведомлениями о ходе длительных ходов агента. |
VIBEOS_CHECKPOINT_TIMEOUT | Тайм-аут создания контрольной точки файловой системы в секундах (по умолчанию: 30). |
VIBEOS_EXEC_ASK | Включить запросы на подтверждение выполнения в режиме шлюза (true/false) |
VIBEOS_ENABLE_PROJECT_PLUGINS | Включите автоматическое обнаружение локальных плагинов репозитория из ./.vibeos/plugins/ как для загрузчика агента, так и для веб-сервера панели мониторинга. Принимает стандартный набор правдивости: 1 / true / yes / on (регистронезависимо). Все остальное — включая 0, false, no, off и пустую строку — рассматривается как отключенное (по умолчанию). Примечание: начиная с GHSA-5qr3-c538-wm9j (#29156) веб-сервер информационной панели отказывается автоматически импортировать файл Python api плагина проекта, даже если эта переменная включена — плагины проекта могут расширять пользовательский интерфейс через статические JS/CSS, но их внутренние маршруты загружаются только при перемещении в ~/.vibeos/plugins/. |
VIBEOS_PLUGINS_DEBUG | 1/true для отображения подробных журналов обнаружения плагинов на stderr — сканированные каталоги, анализируемые манифесты, причины пропуска и полная обратная трассировка при синтаксическом анализе или сбое register(). Предназначен для авторов плагинов. |
VIBEOS_BACKGROUND_NOTIFICATIONS | Режим уведомления о фоновых процессах на шлюзе: all (по умолчанию), result, error, off |
VIBEOS_EPHEMERAL_SYSTEM_PROMPT | Временное системное приглашение, введенное во время API-вызова (никогда не сохранялось в сеансах) |
VIBEOS_PREFILL_MESSAGES_FILE | Путь к файлу JSON эфемерных сообщений предварительного заполнения, введенных во время API-вызова. |
VIBEOS_ALLOW_PRIVATE_URLS | true/false — разрешить инструментам получать localhost/private-network URL-адреса. По умолчанию в режиме шлюза выключено. |
VIBEOS_REDACT_SECRETS | true/false — контролировать секретное редактирование в выходных данных инструмента, журналах и ответах чата (по умолчанию: true). |
VIBEOS_WRITE_SAFE_ROOT | Необязательный префикс каталога, ограничивающий запись write_file/patch; пути снаружи требуют одобрения. Поддерживает несколько каталогов, разделенных os.pathsep (: в Unix, ; в Windows). |
VIBEOS_DISABLE_LAZY_INSTALLS | Внутренняя переменная моста устанавливается автоматически в официальном образе Docker, чтобы предотвратить установку зависимостей во время выполнения в неизменяемое дерево /opt/vibeos. Эквивалент для пользователя — security.allow_lazy_installs: false в config.yaml; не устанавливайте это в .env. |
VIBEOS_DISABLE_FILE_STATE_GUARD | Установите значение 1, чтобы отключить защиту «файл изменился с момента его прочтения» на patch/write_file. |
VIBEOS_CORE_TOOLS | Переопределение канонического основного списка инструментов, разделенное запятыми (дополнительно; требуется редко). |
VIBEOS_BUNDLED_SKILLS | Переопределение через запятую для списка связанных навыков, загружаемых при запуске. |
VIBEOS_OPTIONAL_SKILLS | Разделенный запятыми список имен дополнительных навыков, которые будут автоматически устанавливаться при первом запуске. |
VIBEOS_DEBUG_INTERRUPT | Установите значение 1 для регистрации подробной interrupt/cancel трассировки до agent.log. |
VIBEOS_DUMP_REQUESTS | Дамп API запроса полезных данных в файлы журналов (true/false) |
VIBEOS_DUMP_REQUEST_STDOUT | Дамп API полезных данных запроса на стандартный вывод вместо файлов журналов. |
VIBEOS_OAUTH_TRACE | Установите значение 1, чтобы регистрировать OAuth попытки обмена токенов и обновления. Включает отредактированную информацию о времени. |
VIBEOS_OAUTH_FILE | Переопределить путь, используемый для хранилища учетных данных OAuth (по умолчанию: ~/.vibeos/auth.json). |
VIBEOS_AGENT_HELP_GUIDANCE | Добавьте дополнительный текст руководства в системное приглашение для пользовательских развертываний. |
VIBEOS_AGENT_LOGO | Переопределить логотип баннера ASCII при запуске CLI. |
DELEGATION_MAX_CONCURRENT_CHILDREN | Максимальное количество параллельных субагентов на пакет delegate_task (по умолчанию: 3, этаж 1, без потолка). Также можно настроить через delegation.max_concurrent_children в config.yaml — значение конфигурации имеет приоритет. |
Интерфейс
| Переменная | Описание |
|---|---|
VIBEOS_TUI / наследие VIBEOS_TUI | Запустите TUI вместо классического CLI, если установлено значение 1. Эквивалентно передаче --tui. |
VIBEOS_TUI_DIR | Путь к предварительно созданному каталогу ui-tui/ (должен содержать dist/entry.js и заполнен node_modules). Используется дистрибутивами и Nix для пропуска первого запуска npm install. |
VIBEOS_TUI_RESUME | Возобновите определенный сеанс TUI по идентификатору при запуске. Если установлено, vibeos --tui пропускает создание нового сеанса и вместо этого выбирает указанный сеанс, что полезно для повторного подключения после отключения или сбоя терминала. |
VIBEOS_TUI_THEME | Примените цветовую тему TUI: light, dark или необработанный шестизначный фоновый шестнадцатеричный код (например, ffffff или 1a1a2e). Если параметр не установлен, VibeOS автоматически обнаруживает использование COLORFGBG и фоновые запросы терминала; эта переменная переопределяет обнаружение на терминалах (Ghostty, Warp, iTerm2 и т. д.), которые не устанавливают COLORFGBG. |
VIBEOS_INFERENCE_MODEL | Форсируйте модель для vibeos -z / vibeos chat без мутации config.yaml. Сочетается с флагом --provider. Полезно для вызывающих программ по сценарию (Sweeper, CI, пакетные исполнители), которым необходимо переопределить модель по умолчанию при каждом запуске. |
Настройки сеанса
| Переменная | Описание |
|---|---|
SESSION_IDLE_MINUTES | Сбросить сеансы после N минут бездействия (по умолчанию: 1440) |
SESSION_RESET_HOUR | Час ежедневного сброса в 24-часовом формате (по умолчанию: 4 = 4 утра) |
VIBEOS_SESSION_ID | Автоматически экспортируется в каждый подпроцесс инструмента VibeOS порождает (terminal, execute_code, постоянную оболочку, Docker/Singularity серверные части, запуск делегированного субагента). Устанавливается агентом для текущего идентификатора сеанса; пользовательские сценарии, вызываемые из инструментов, могут прочитать его, чтобы сопоставить свои выходные данные, телеметрию или побочные эффекты с исходным сеансом VibeOS. Не следует устанавливать это значение вручную — его переопределение из родительской оболочки вступает в силу только вне запуска агента и перезаписывается в тот момент, когда агент запускает сеанс. |
Сжатие контекста (config.yaml только)
Сжатие контекста настраивается исключительно через config.yaml — для него нет переменных среды. Настройки пороговых значений хранятся в блоке compression:, а суммирование model/provider находится в блоке auxiliary.compression:.
compression:
enabled: true
threshold: 0.50
target_ratio: 0.20 # fraction of threshold to preserve as recent tail
protect_last_n: 20 # minimum recent messages to keep uncompressed
Унаследованная миграция
Старые конфигурации с compression.summary_model, compression.summary_provider и compression.summary_base_url автоматически переносятся в auxiliary.compression.* в первую очередь load.
Переопределение вспомогательной задачи
| Переменная | Описание |
|---|---|
AUXILIARY_VISION_PROVIDER | Переопределить поставщика для задач машинного зрения |
AUXILIARY_VISION_MODEL | Переопределить модель для задач машинного зрения |
AUXILIARY_VISION_BASE_URL | Прямая OpenAI-совместимая конечная точка для задач машинного зрения |
AUXILIARY_VISION_API_KEY | Ключ API в паре с AUXILIARY_VISION_BASE_URL |
AUXILIARY_WEB_EXTRACT_PROVIDER | Переопределить поставщика для Интернета extraction/summarization |
AUXILIARY_WEB_EXTRACT_MODEL | Переопределить модель для Интернета extraction/summarization |
AUXILIARY_WEB_EXTRACT_BASE_URL | Прямая OpenAI-совместимая конечная точка для Интернета extraction/summarization |
AUXILIARY_WEB_EXTRACT_API_KEY | Ключ API в паре с AUXILIARY_WEB_EXTRACT_BASE_URL |
Для прямых конечных точек, зависящих от задачи, VibeOS использует настроенный для задачи ключ API или OPENAI_API_KEY. Он не использует повторно OPENROUTER_API_KEY для этих пользовательских конечных точек.
Резервные поставщики (config.yaml только)
Запасная цепочка основной модели настраивается исключительно через config.yaml — для него нет переменных окружения. Добавьте список fallback_providers верхнего уровня с ключами provider и model, чтобы включить автоматическое переключение при сбое при возникновении ошибок в основной модели. Вспомогательные задачи, поставщиком которых является auto, также обращаются к этой цепочке перед встроенной вспомогательной цепочкой обнаружения VibeOS.
fallback_providers:
- provider: openrouter
model: anthropic/claude-sonnet-4
Старая форма верхнего уровня fallback_model с одним поставщиком по-прежнему читается для обеспечения обратной совместимости, но в новой конфигурации следует использовать fallback_providers. Для дополнительной политики для конкретной задачи используйте auxiliary.<task>.fallback_chain в config.yaml; нет эквивалента переменной среды.
Подробную информацию см. в разделе Резервные поставщики.
Маршрутизация поставщика (config.yaml) только)
Они находятся в ~/.vibeos/config.yaml в разделе provider_routing:
| Ключ | Описание |
|---|---|
sort | Поставщики сортировки: "price" (по умолчанию), "throughput" или "latency" |
only | Список разрешенных пулов провайдеров (например, ["anthropic", "google"]) |
ignore | Список пулов провайдеров, которые нужно пропустить |
order | Список пробных версий провайдеров по порядку |
require_parameters | Используйте только поставщиков, поддерживающих все параметры запроса (true/false) |
data_collection | "allow" (по умолчанию) или "deny" для исключения провайдеров хранения данных |
подсказка
Используйте vibeos config set для установки переменных среды — они автоматически сохраняются в нужный файл (.env для секретов, config.yaml для всего остального).