OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

Застосунок для Linux

Gateway повністю підтримується в Linux. Node — рекомендоване середовище виконання; Bun не рекомендується (через відомі проблеми з WhatsApp/Telegram).

Нативного допоміжного застосунку для Linux поки немає. Внески вітаються.

Швидкий шлях (VPS)

  1. Установіть Node 24 (рекомендовано) або Node 22.19+ (LTS, усе ще підтримується).
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. На своєму ноутбуці виконайте: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Відкрийте http://127.0.0.1:18789/ й автентифікуйтеся за допомогою налаштованого спільного секрету (типово — токена; пароля, якщо gateway.auth.mode має значення "password").

Повний посібник із сервера: Сервер Linux. Покроковий приклад для VPS: exe.dev.

Установлення

Служба Gateway (systemd)

Установіть одним із таких способів:

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # виберіть "Служба Gateway", коли з’явиться запит

Щоб виправити або перенести наявне встановлення, виконайте:

bash
openclaw doctor

openclaw gateway install типово створює користувацький модуль systemd. Повні рекомендації щодо служби, включно з варіантом модуля системного рівня для спільних або постійно активних вузлів, наведено в посібнику з експлуатації Gateway.

Створюйте модуль вручну лише для нестандартного налаштування. Мінімальний приклад користувацького модуля (~/.config/systemd/user/openclaw-gateway[-<profile>].service):

ini
[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.targetStartLimitBurst=5StartLimitIntervalSec=60 [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5RestartPreventExitStatus=78TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.target

Увімкніть його:

bash
systemctl --user enable --now openclaw-gateway[-<profile>].service

Нестача пам’яті та завершення процесів через OOM

У Linux ядро вибирає жертву OOM, коли на вузлі, віртуальній машині або в cgroup контейнера закінчується пам’ять. Gateway — невдалий вибір для завершення, оскільки він керує довготривалими сеансами та з’єднаннями каналів, тому OpenClaw за можливості надає пріоритет завершенню тимчасових дочірніх процесів.

Для відповідних дочірніх процесів, запущених у Linux, OpenClaw обгортає команду короткою проміжною оболонкою /bin/sh, яка підвищує власне значення oom_score_adj дочірнього процесу до 1000, а потім за допомогою exec запускає справжню команду. Для цього не потрібні привілеї: процес завжди може підвищити власну оцінку OOM.

Охоплені типи дочірніх процесів:

  • Дочірні процеси команд під керуванням супервізора
  • Дочірні процеси оболонки PTY
  • Дочірні процеси серверів MCP зі стандартним введенням-виведенням
  • Процеси браузера/Chrome, запущені OpenClaw (через середовище виконання процесів SDK Plugin)

Обгортка працює лише в Linux і пропускається, коли /bin/sh недоступний або коли середовище дочірнього процесу задає для OPENCLAW_CHILD_OOM_SCORE_ADJ значення 0, false, no чи off.

Перевірте дочірній процес:

bash
cat /proc/<child-pid>/oom_score_adj

Очікуване значення для охоплених дочірніх процесів — 1000; сам процес Gateway зберігає звичайне значення (зазвичай 0).

Параметр OOMPolicy=continue у модулі systemd залишає службу Gateway активною, коли засіб OOM-завершення вибирає тимчасовий дочірній процес, замість того щоб позначати весь модуль як несправний і перезапускати всі канали; завершений дочірній процес або сеанс повідомляє про власну помилку.

Це не замінює звичайного налаштування пам’яті. Якщо VPS або контейнер неодноразово завершує дочірні процеси, збільште ліміт пам’яті, зменште паралелізм або додайте суворіші засоби керування ресурсами (systemd MemoryMax=, обмеження пам’яті контейнера).

Пов’язані матеріали

Was this useful?
On this page

On this page