クイックパス (VPS)
- Node 24(推奨)または Node 22.19+(LTS、引き続きサポート)をインストールします。
npm i -g openclaw@latestopenclaw onboard --install-daemon- ラップトップから:
ssh -N -L 18789:127.0.0.1:18789 <user>@<host> http://127.0.0.1:18789/を開き、設定済みの共有シークレットで認証します (デフォルトはトークン、gateway.auth.modeが"password"の場合はパスワード)。
インストール
Gateway サービス (systemd)
次のいずれかでインストールします。openclaw gateway install はデフォルトで systemd user ユニットを生成します。共有ホストや
常時稼働ホスト向けの system レベルのユニットバリアントを含む完全な
サービスガイダンスは、Gateway ランブックにあります。
カスタムセットアップの場合のみ、手動でユニットを作成してください。最小限の user ユニット例
(~/.config/systemd/user/openclaw-gateway[-<profile>].service):
メモリ圧迫と OOM kill
Linux では、ホスト、VM、またはコンテナ cgroup のメモリが不足すると、カーネルが OOM の対象プロセスを選択します。Gateway は長時間存続する セッションとチャンネル接続を所有するため、対象として適していません。そのため OpenClaw は、可能な場合に一時的な子 プロセスが先に kill されるようにします。 対象となる Linux の子プロセス起動では、OpenClaw は短い/bin/sh shim でコマンドをラップし、子自身の oom_score_adj を 1000 に上げてから、
実際のコマンドを exec します。これは権限不要です。プロセスは常に
自身の OOM スコアを上げることができます。
対象となる子プロセスの範囲:
- スーパーバイザー管理のコマンド子プロセス
- PTY シェル子プロセス
- MCP stdio サーバー子プロセス
- OpenClaw が起動したブラウザー/Chrome プロセス(Plugin SDK プロセスランタイム経由)
/bin/sh が利用できない場合、または
子プロセスの env で OPENCLAW_CHILD_OOM_SCORE_ADJ が 0、false、no、または
off に設定されている場合はスキップされます。
子プロセスを確認します。
1000 です。Gateway プロセス自体は
通常のスコア(一般的には 0)を維持します。
systemd ユニットの OOMPolicy=continue により、一時的な子プロセスが OOM killer に選択された場合でも、
ユニット全体を失敗としてマークしてすべてのチャンネルを再起動するのではなく、Gateway サービスを稼働させ続けます。失敗した子プロセス/セッションは
自身のエラーを報告します。
これは通常のメモリチューニングを置き換えるものではありません。VPS やコンテナが繰り返し
子プロセスを kill する場合は、メモリ制限を引き上げるか、並行数を減らすか、より強い
リソース制御(systemd MemoryMax=、コンテナのメモリ制限)を追加してください。