メインコンテンツへスキップ
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)

次のいずれかでインストールします。
openclaw onboard --install-daemon
openclaw gateway install
openclaw configure   # select "Gateway service" when prompted
既存のインストールを修復または移行します。
openclaw doctor
openclaw gateway install はデフォルトで systemd user ユニットを生成します。共有ホストや 常時稼働ホスト向けの system レベルのユニットバリアントを含む完全な サービスガイダンスは、Gateway ランブックにあります。 カスタムセットアップの場合のみ、手動でユニットを作成してください。最小限の user ユニット例 (~/.config/systemd/user/openclaw-gateway[-<profile>].service):
[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
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
有効化します。
systemctl --user enable --now openclaw-gateway[-<profile>].service

メモリ圧迫と OOM kill

Linux では、ホスト、VM、またはコンテナ cgroup のメモリが不足すると、カーネルが OOM の対象プロセスを選択します。Gateway は長時間存続する セッションとチャンネル接続を所有するため、対象として適していません。そのため OpenClaw は、可能な場合に一時的な子 プロセスが先に kill されるようにします。 対象となる Linux の子プロセス起動では、OpenClaw は短い /bin/sh shim でコマンドをラップし、子自身の oom_score_adj1000 に上げてから、 実際のコマンドを exec します。これは権限不要です。プロセスは常に 自身の OOM スコアを上げることができます。 対象となる子プロセスの範囲:
  • スーパーバイザー管理のコマンド子プロセス
  • PTY シェル子プロセス
  • MCP stdio サーバー子プロセス
  • OpenClaw が起動したブラウザー/Chrome プロセス(Plugin SDK プロセスランタイム経由)
このラッパーは Linux 専用で、/bin/sh が利用できない場合、または 子プロセスの env で OPENCLAW_CHILD_OOM_SCORE_ADJ0falseno、または off に設定されている場合はスキップされます。 子プロセスを確認します。
cat /proc/<child-pid>/oom_score_adj
対象となる子プロセスの期待値は 1000 です。Gateway プロセス自体は 通常のスコア(一般的には 0)を維持します。 systemd ユニットの OOMPolicy=continue により、一時的な子プロセスが OOM killer に選択された場合でも、 ユニット全体を失敗としてマークしてすべてのチャンネルを再起動するのではなく、Gateway サービスを稼働させ続けます。失敗した子プロセス/セッションは 自身のエラーを報告します。 これは通常のメモリチューニングを置き換えるものではありません。VPS やコンテナが繰り返し 子プロセスを kill する場合は、メモリ制限を引き上げるか、並行数を減らすか、より強い リソース制御(systemd MemoryMax=、コンテナのメモリ制限)を追加してください。

関連