--- read_when: - Поиск информации о состоянии приложения-компаньона для Linux - Планирование поддержки платформ и вкладов в проект - Диагностика завершения процессов из-за OOM в Linux или с кодом 137 на VPS либо в контейнере summary: Поддержка Linux и статус приложения-компаньона title: Приложение для Linux x-i18n: generated_at: "2026-07-13T19:58:04Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 24 provider: openai source_hash: 9d13f20f3db2755f130898aaa6f8395daa0be83577c60cd3809783806e8c3b16 source_path: platforms/linux.md workflow: 16 --- Gateway полностью поддерживается в Linux и требует Node. Bun по-прежнему можно использовать для установки зависимостей или запуска скриптов пакетов, но он не может запускать OpenClaw, поскольку не предоставляет `node:sqlite`. ## Сопутствующее приложение для рабочего стола Сопутствующее приложение OpenClaw для Linux — это настольное приложение Tauri для локального Gateway. Оно: - устанавливает CLI OpenClaw и управляемую среду выполнения Node, если они отсутствуют - подключается к исправному Gateway перед попыткой изменить службу - делегирует операции установки, запуска, остановки и перезапуска пользовательской службе systemd, управляемой через CLI - открывает предоставляемый Gateway интерфейс управления по определённому URL аутентификации - остаётся доступным в системном трее после закрытия окна Готовые выпуски пока не публикуются. Соберите `.deb` и AppImage из копии исходного кода: ```bash cd apps/linux/src-tauri pnpm dlx @tauri-apps/cli@2.11.4 build --bundles deb,appimage ``` Процесс CI `Linux App` также загружает те же пакеты в виде артефакта `openclaw-linux-companion` для запросов на включение изменений, затрагивающих приложение, и для запусков вручную. Зависимости для сборки в Linux и команды разработки см. в `apps/linux/README.md` в репозитории. ## Альтернатива с CLI и SSH CLI остаётся самым простым вариантом для сервера без графического интерфейса, VPS или удалённого Gateway: 1. Установите Node 24.15+ (рекомендуется), Node 22.22.3+ (LTS) или Node 25.9+. 2. `npm i -g openclaw@latest` 3. `openclaw onboard --install-daemon` 4. На ноутбуке выполните: `ssh -N -L 18789:127.0.0.1:18789 @` 5. Откройте `http://127.0.0.1:18789/` и пройдите аутентификацию с помощью настроенного общего секрета (по умолчанию токена; пароля, если `gateway.auth.mode` имеет значение `"password"`). Полное руководство по серверу: [Сервер Linux](/ru/vps). Пошаговый пример для VPS: [exe.dev](/ru/install/exe-dev). ## Установка - [Начало работы](/ru/start/getting-started) - [Установка и обновления](/ru/install/updating) - Необязательно: [Рабочий процесс с пакетами Bun](/ru/install/bun), [Nix](/ru/install/nix), [Docker](/ru/install/docker) ## Служба Gateway (systemd) Установите одним из следующих способов: ```bash openclaw onboard --install-daemon openclaw gateway install openclaw configure # выберите "Служба Gateway" при появлении запроса ``` Восстановите или перенесите существующую установку: ```bash openclaw doctor ``` `openclaw gateway install` по умолчанию создаёт **пользовательский** модуль systemd. Полное руководство по службе, включая вариант модуля **системного** уровня для общих или постоянно работающих узлов, приведено в [руководстве по эксплуатации Gateway](/ru/gateway#supervision-and-service-lifecycle). Создавайте модуль вручную только для нестандартной конфигурации. Минимальный пример пользовательского модуля (`~/.config/systemd/user/openclaw-gateway[-].service`): ```ini [Unit] Description=OpenClaw Gateway (профиль: , v) After=network-online.target Wants=network-online.target StartLimitBurst=5 StartLimitIntervalSec=60 [Service] ExecStart=/usr/local/bin/openclaw gateway --port 18789 Restart=always RestartSec=5 RestartPreventExitStatus=78 TimeoutStopSec=30 TimeoutStartSec=30 SuccessExitStatus=0 143 OOMPolicy=continue KillMode=control-group [Install] WantedBy=default.target ``` Включите его: ```bash systemctl --user enable --now openclaw-gateway[-].service ``` ## Нехватка памяти и завершение процессов из-за OOM В Linux ядро выбирает жертву OOM, когда на узле, виртуальной машине или в cgroup контейнера заканчивается память. Gateway плохо подходит на роль жертвы, поскольку он обслуживает долгоживущие сеансы и подключения к каналам, поэтому OpenClaw по возможности повышает вероятность завершения временных дочерних процессов в первую очередь. Для подходящих дочерних процессов Linux OpenClaw оборачивает команду коротким скриптом `/bin/sh`, который повышает собственное значение `oom_score_adj` дочернего процесса до `1000`, а затем выполняет `exec` реальной команды. Для этого не требуются повышенные привилегии: процесс всегда может повысить собственную оценку OOM. Охватываются следующие типы дочерних процессов: - Дочерние процессы команд под управлением супервизора - Дочерние процессы оболочки PTY - Дочерние процессы серверов MCP stdio - Процессы браузера/Chrome, запускаемые OpenClaw (через среду выполнения процессов SDK плагинов) Обёртка используется только в Linux и пропускается, если `/bin/sh` недоступен или если в окружении дочернего процесса для `OPENCLAW_CHILD_OOM_SCORE_ADJ` задано значение `0`, `false`, `no` или `off`. Проверьте дочерний процесс: ```bash cat /proc//oom_score_adj ``` Ожидаемое значение для охватываемых дочерних процессов — `1000`; сам процесс Gateway сохраняет обычную оценку (как правило, `0`). Параметр `OOMPolicy=continue` модуля systemd оставляет службу Gateway запущенной, когда средство OOM killer выбирает временный дочерний процесс, вместо того чтобы помечать весь модуль как сбойный и перезапускать все каналы; завершившийся дочерний процесс или сеанс сообщает о собственной ошибке. Это не заменяет обычную настройку памяти. Если VPS или контейнер регулярно завершает дочерние процессы, увеличьте лимит памяти, сократите параллелизм или добавьте более строгие ограничения ресурсов (systemd `MemoryMax=`, лимиты памяти контейнера). ## Связанные материалы - [Обзор установки](/ru/install) - [Сервер Linux](/ru/vps) - [Raspberry Pi](/ru/install/raspberry-pi) - [Руководство по эксплуатации Gateway](/ru/gateway) - [Конфигурация Gateway](/ru/gateway/configuration)