> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 サーバー](/ja-JP/vps)。ステップごとの VPS 例:
[exe.dev](/ja-JP/install/exe-dev)。

## インストール

* [はじめに](/ja-JP/start/getting-started)
* [インストールと更新](/ja-JP/install/updating)
* 任意: [Bun（実験的）](/ja-JP/install/bun)、[Nix](/ja-JP/install/nix)、[Docker](/ja-JP/install/docker)

## Gateway サービス (systemd)

次のいずれかでインストールします。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
openclaw gateway install
openclaw configure   # select "Gateway service" when prompted
```

既存のインストールを修復または移行します。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
```

`openclaw gateway install` はデフォルトで systemd **user** ユニットを生成します。共有ホストや
常時稼働ホスト向けの **system** レベルのユニットバリアントを含む完全な
サービスガイダンスは、[Gateway ランブック](/ja-JP/gateway#supervision-and-service-lifecycle)にあります。

カスタムセットアップの場合のみ、手動でユニットを作成してください。最小限の user ユニット例
（`~/.config/systemd/user/openclaw-gateway[-<profile>].service`）:

```ini theme={"theme":{"light":"min-light","dark":"min-dark"}}
[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
```

有効化します。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
systemctl --user enable --now 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 プロセスランタイム経由）

このラッパーは Linux 専用で、`/bin/sh` が利用できない場合、または
子プロセスの env で `OPENCLAW_CHILD_OOM_SCORE_ADJ` が `0`、`false`、`no`、または
`off` に設定されている場合はスキップされます。

子プロセスを確認します。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
cat /proc/<child-pid>/oom_score_adj
```

対象となる子プロセスの期待値は `1000` です。Gateway プロセス自体は
通常のスコア（一般的には `0`）を維持します。

systemd ユニットの `OOMPolicy=continue` により、一時的な子プロセスが OOM killer に選択された場合でも、
ユニット全体を失敗としてマークしてすべてのチャンネルを再起動するのではなく、Gateway サービスを稼働させ続けます。失敗した子プロセス/セッションは
自身のエラーを報告します。

これは通常のメモリチューニングを置き換えるものではありません。VPS やコンテナが繰り返し
子プロセスを kill する場合は、メモリ制限を引き上げるか、並行数を減らすか、より強い
リソース制御（systemd `MemoryMax=`、コンテナのメモリ制限）を追加してください。

## 関連

* [インストール概要](/ja-JP/install)
* [Linux サーバー](/ja-JP/vps)
* [Raspberry Pi](/ja-JP/install/raspberry-pi)
* [Gateway ランブック](/ja-JP/gateway)
* [Gateway 設定](/ja-JP/gateway/configuration)