インストールされるコンポーネント

インストーラーは複数のパッケージマネージャを横断してインフラ、プラットフォームパッケージ、オプションツールをセットアップします。コアインフラとプラットフォーム依存関係は自動でインストールされ、オプションツールはインストール時に個別にプロンプトされます。

コアインフラ

エージェントプラットフォームのランタイム依存

これらはプラットフォームの config.env フラグで制御されます。OpenClawではすべてインストールされます。

OpenClawプラットフォーム

オプションツール（インストール時にプロンプト）

各ツールは個別のY/nプロンプトで提示されます。インストール対象は自由に選択できます。オプションツールのインストールに失敗しても、その旨が報告されてスキップされるだけで、残りのセットアップが中断されることはありません。

プロジェクト構成

openclaw-android/
├── bootstrap.sh                # curl | bash ワンライナーインストーラー（ダウンローダー）
├── install.sh                  # プラットフォーム対応インストーラー（エントリポイント）
├── oa.sh                       # 統合CLI（$PREFIX/bin/oa としてインストール）
├── post-setup.sh               # Claw アプリのpost-bootstrapセットアップ（OTA配信）
├── update.sh                   # 軽量ラッパー（update-core.sh をダウンロード・実行）
├── update-core.sh              # 既存インストール向けの軽量アップデーター
├── uninstall.sh                # クリーン削除（オーケストレーター）
├── patches/
│   ├── glibc-compat.js        # Node.jsランタイムパッチ（os.cpus、networkInterfaces）
│   ├── argon2-stub.js          # argon2ネイティブモジュール用JSスタブ（code-server）
│   ├── termux-compat.h         # Bionicネイティブビルド用Cヘッダ（sharp）
│   ├── spawn.h                 # POSIX spawnスタブヘッダ
│   ├── systemctl               # Termux用systemdスタブ
│   ├── apply-patches.sh        # レガシーパッチオーケストレーター（v1.0.2互換）
│   └── patch-paths.sh          # レガシーパス修正（v1.0.2互換）
├── scripts/
│   ├── lib.sh                  # 共有関数ライブラリ（色、プラットフォーム検出、プロンプト）
│   ├── check-env.sh            # 起動前環境チェック
│   ├── install-infra-deps.sh   # コアインフラパッケージ（L1）
│   ├── install-glibc.sh        # glibc-runnerインストール（L2 条件付き）
│   ├── install-nodejs.sh       # Node.js glibcラッパーのインストール（L2 条件付き）
│   ├── install-build-tools.sh  # ネイティブモジュール用ビルドツール（L2 条件付き）
│   ├── backup.sh               # OpenClawデータのバックアップ・復元（oa --backup/--restore）
│   ├── build-sharp.sh          # sharpネイティブモジュール（画像処理）のビルド
│   ├── install-chromium.sh     # ブラウザ自動化用Chromiumのインストール
│   ├── install-playwright.sh   # Playwrightブラウザ自動化ライブラリのインストール
│   ├── install-code-server.sh  # code-server（ブラウザIDE）のインストール・更新
│   ├── install-opencode.sh     # OpenCodeのインストール
│   ├── setup-env.sh            # 環境変数設定
│   └── setup-paths.sh          # ディレクトリ作成とシンボリックリンク
├── platforms/
│   ├── openclaw/               # OpenClawプラットフォームプラグイン
│   │   ├── config.env          # プラットフォームメタデータと依存宣言
│   │   ├── env.sh              # プラットフォーム固有の環境変数
│   │   ├── install.sh          # プラットフォームパッケージのインストール（npm、パッチ、clawdhub）
│   │   ├── update.sh           # プラットフォームパッケージの更新
│   │   ├── openclaw-shim.sh    # `openclaw update` のバージョン固定ガードを書き込む
│   │   ├── uninstall.sh        # プラットフォームパッケージの削除
│   │   ├── limits.sh           # node/npm 呼び出しの時間制限（update・verify・status）
│   │   ├── status.sh           # プラットフォーム状態表示
│   │   ├── verify.sh           # プラットフォーム検証チェック
│   │   └── patches/            # プラットフォーム固有のパッチ
│   │       ├── openclaw-apply-patches.sh
│   │       ├── openclaw-patch-paths.sh
│   │       ├── openclaw-patch-hardlink.sh  # OpenClaw向けのAndroidハードリンク/reflink代替処理
│   │       └── openclaw-build-sharp.sh
├── tests/
│   └── verify-install.sh       # インストール後検証（オーケストレーター + プラットフォーム）
└── docs/
    ├── disable-phantom-process-killer.md    # プロセスを生かし続けるためのガイド (EN)
    ├── disable-phantom-process-killer.ko.md # プロセスを生かし続けるためのガイド (KO)
    ├── termux-ssh-guide.md     # Termux SSHセットアップガイド (EN)
    ├── termux-ssh-guide.ko.md  # Termux SSHセットアップガイド (KO)
    ├── troubleshooting.md      # トラブルシューティングガイド (EN)
    ├── troubleshooting.ko.md   # トラブルシューティングガイド (KO)
    └── images/                 # スクリーンショットと画像

アーキテクチャ

本プロジェクトは、プラットフォームに依存しないインフラとプラットフォーム固有コードを分離するプラットフォームプラグイン構成を採用しています。

┌─────────────────────────────────────────────────────────────┐
│  オーケストレーター (install.sh, update-core.sh, uninstall.sh) │
│  ── プラットフォーム非依存。config.env を読みデリゲート          │
├─────────────────────────────────────────────────────────────┤
│  共有スクリプト (scripts/)                                     │
│  ── L1: install-infra-deps.sh（常時）                         │
│  ── L2: install-glibc.sh, install-nodejs.sh,                 │
│         install-build-tools.sh（config.env 条件付き）          │
│  ── L3: オプションツール（ユーザー選択）                         │
├─────────────────────────────────────────────────────────────┤
│  プラットフォームプラグイン (platforms/<name>/)                 │
│  ── config.env: 依存宣言（PLATFORM_NEEDS_*）                  │
│  ── install.sh / update.sh / uninstall.sh / ...              │
└─────────────────────────────────────────────────────────────┘

依存関係のレイヤー:

各プラットフォームは config.env でL2依存を宣言します。

# platforms/openclaw/config.env
PLATFORM_NEEDS_GLIBC=true
PLATFORM_NEEDS_NODEJS=true
PLATFORM_NEEDS_BUILD_TOOLS=true

オーケストレーターはこれらのフラグを読み、対応するインストールスクリプトを条件付きで実行します。特定の依存を必要としないプラットフォームでは該当フラグを false に設定するだけで、重い依存をまるごとスキップできます。

詳細なインストールフロー

bash install.sh を実行すると、次の8ステップが順に実行されます。

[1/8] 環境チェック — scripts/check-env.sh

インストール開始前に現在の環境が適切かを検証します。

• Termux検出: $PREFIX 環境変数を確認。Termux外では即終了
• アーキテクチャチェック: uname -m でCPUアーキテクチャを確認（aarch64推奨、armv7lサポート、x86_64はエミュレータ扱い）
• ディスク容量: $PREFIX パーティションに最低2000MBの空きを要求。不足時は必要量と残量を表示してエラー
• 既存インストール: openclaw コマンドが既にあれば現バージョンを表示し、再インストール／アップグレードである旨を案内
• Node.js事前チェック: 既にNode.jsが入っていればバージョンを表示し、24未満の場合は警告
• Phantom Process Killer（Android 12+）: Phantom Process Killerに関する案内を 無効化ガイド のリンク付きで表示

[2/8] プラットフォーム選択

インストールするプラットフォームを選択します。現在は openclaw にハードコードされています。将来的に複数プラットフォームが利用可能になった際は選択UIを表示します。

scripts/lib.sh の load_platform_config() を介してプラットフォームの config.env を読み込み、すべての PLATFORM_* 変数を以降のステップで利用できるよう公開します。

[3/8] オプションツール選択 (L3)

オプションツール用に11個のY/nプロンプト（/dev/tty 経由）を提示します。

• tmux、ttyd、dufs、android-tools
• Chromium、Playwright
• code-server、OpenCode
• Claude Code、Gemini CLI、Codex CLI（Termux）

選択はインストール開始前にまとめて行います。これにより一度の判断で済み、インストール中は端末から離れていても問題ありません。

[4/8] コアインフラ (L1) — scripts/install-infra-deps.sh + scripts/setup-paths.sh

プラットフォーム選択にかかわらず常に実行されます。

install-infra-deps.sh:

• pkg update -y && pkg upgrade -y でパッケージを更新・アップグレード
• git をインストール（npm gitディペンデンシとリポジトリクローンに必要）

setup-paths.sh:

• $PREFIX/tmp と $HOME/.openclaw-android/patches ディレクトリを作成
• 標準Linuxパス（/bin/sh、/usr/bin/env、/tmp）からTermuxパスへのマッピングを表示

[5/8] プラットフォームランタイム依存 (L2)

プラットフォームの config.env フラグに基づき、ランタイム依存を条件付きでインストールします。

各スクリプトは事前チェックと冪等性を備えており（インストール済みならスキップ）、自己完結しています。

Node.jsラッパーの既定値: OpenClaw 2026.9.x はNode.js 24.16以上を必要とします。OpenClawのファイル安全モジュール（@openclaw/fs-safe）のネイティブヘルパーは openat2 システムコールを使いますが、Androidのアプリ用seccompポリシーがこの呼び出しをSIGSYS（Bad system call）で終了させます。そのためラッパーは既定で FS_SAFE_TEST_NO_OPENAT2=1 を設定し、ネイティブヘルパーは維持したまま openat2 を使わせないようにします（値は正確に 1 である必要があります）。FS_SAFE_NATIVE_MODE=off を設定するとネイティブヘルパー自体をオフにできますが、その場合OpenClawの一部のデータ移行が拒否されることがあります。ラッパーは OPENCLAW_NO_AUTO_UPDATE=1 も既定で設定し、OpenClaw自身のアップデートをブロックします（アップデートを参照）。

ハードリンクパッチ: Androidは、アプリのデータ領域でハードリンクとreflink（FICLONE）によるコピーをブロックします（アプリとTermuxの両方で、エラーは EACCES）。OpenClaw 2026.10.2 はまずハードリンクを試し、「サポートされていない」エラーの場合にだけコピーへ切り替えますが、EACCES はサポート外とは見なされません。また会話履歴を移行したあと、元のファイルを保管フォルダへ移すときはハードリンクしか使いません。そのままでは、7.35 からアップグレードしたユーザーのデータ移行が失敗します。OpenClaw on AndroidはOpenClawをインストール・アップデートするたびに（アプリのインストール、Termuxのインストール、oa --update、そして npm install -g openclaw@<固定バージョン> による再インストール）、platforms/openclaw/patches/openclaw-patch-hardlink.sh でOpenClawのこの部分を修正します。EACCES をコピーへ切り替える対象に含め、保管フォルダへの移動はハードリンクが拒否された場合に同じファイルシステム内のrenameで行います。これにより openclaw backup create もハードリンクの代わりにコピーを使えます。oa --status には Hard-link patch: applied (…) または not complete (…) の行が表示されます。会話履歴のある 7.35 のユーザーが固定バージョンの変わるアップデートを行う場合、インストールされるOpenClawにこのパッチが合うかを先に確認し、合わなければ何も変更せずに停止します（トラブルシューティング（英語）を参照）。 また OpenClaw 2026.10 はゲートウェイのロックのためにプロセス名前空間ファイル /proc/self/ns/pid を読みますが、多くのAndroidカーネルはアプリにこのファイルを提供しません（参照は ENOENT または EACCES で失敗します）。同じパッチによって、OpenClawはこのファイルを利用不可として扱い、ゲートウェイの起動を拒否しなくなります。

既知の制限: OpenClawのデスクトップ自動化ツール（@trycua/cua-driver）は、Android 10以下（API 29以下）では必要なシステムコールの一部がブロックされており、動作しない場合があります。

[6/8] プラットフォームパッケージのインストール (L2) — platforms/<platform>/install.sh

プラットフォーム自身のインストールスクリプトに委譲します。OpenClawの場合は次を実行します。

1. CPATH を設定（ネイティブモジュールビルドに必要なglib-2.0ヘッダ用）
2. PyYAMLをpipでインストール（.skill パッケージング用）
3. glibc-compat.js を ~/.openclaw-android/patches/ にコピー（Node.jsラッパーはNode.jsと一緒にインストールされた ~/.openclaw-android/lib/ 内の自前のコピーを読み込みます — アプリがそちらを上書きすることはありません）
4. systemctl スタブを $PREFIX/bin/ にインストール
5. npm install -g [email protected] --ignore-scripts を実行（config.env で固定されたバージョン）
6. OpenClaw自身のpostinstallスクリプト（postinstall-bundled-plugins.mjs）を実行（--ignore-scripts ではスキップされるため）
7. openclaw-apply-patches.sh でプラットフォーム固有のパッチを適用
8. 固定バージョンが維持されるよう、openclaw update ガード（openclaw-shim.sh）をインストール
9. 必要に応じて clawdhub（スキルマネージャ）と undici 依存をインストール
10. ゲートウェイの "update available" 通知をオフにする（openclaw config set update.checkOnStart false）。すでに自分で値を設定している場合はそのまま

以前のインストールが途中で中断された場合: インストーラーはインストールが進行中であることを記録し、インストール・postinstall・パッチ・確認がすべて通過した後にのみその記録を削除します。インストール後もOpenClawが不完全な場合、Termuxインストーラーは [FAIL] OpenClaw <version> was installed but is incomplete (files are missing or it does not start). と Run the installer again. を表示して停止します。Clawアプリのセットアップスクリプト（post-setup.sh）は、終わっていない以前のインストールを検出し（[WARN] OpenClaw <version> is incomplete (an earlier install was cut off): installing it again）、バージョンが同じでもOpenClawをインストールし直します。データには手を付けません。それでもOpenClawが不完全な場合、セットアップは次のエラーで停止します: OpenClaw <version> is still incomplete (files are missing or it does not start). Restart the app to try again. Clawアプリ（v0.4.5以降）は、この失敗をセットアップ画面に表示し、もう一度試すためのボタンを提供します。

[6.5] 環境変数 + CLI + マーカー:

プラットフォームインストール後、オーケストレーターは次を行います。

• setup-env.sh を実行して .bashrc に環境変数ブロックを書き込み
• プラットフォームの env.sh を評価し、プラットフォーム固有変数を反映
• プラットフォームマーカーファイル（~/.openclaw-android/.platform）を書き込み
• oa CLIと oaupdate ラッパーを $PREFIX/bin/ にインストール
• アップデーターやアンインストーラーが利用するため、lib.sh、setup-env.sh、プラットフォームディレクトリを ~/.openclaw-android/ にコピー

[7/8] オプションツールのインストール (L3)

ステップ3で選択されたツールをインストールします。

• Termuxパッケージ: tmux、ttyd、dufs、android-tools — pkg install でインストール
• code-server: ブラウザベースのVS Code IDE。Termux固有の回避策（同梱nodeの差し替え、argon2のパッチ、ハードリンク失敗の処理）を実施
• OpenCode: Bunスタンドアロンバイナリ向けにproot + ld.soの連結方式でインストール
• Chromium: OpenClaw向けブラウザ自動化サポート（約400MB）
• Playwright: ブラウザ自動化ライブラリ（npmで playwright-core）。PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH および PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD を自動設定。Chromiumがなければ自動インストール
• AI CLIツール: Claude Code、Gemini CLI、Codex CLI（Termux） — npm install -g でインストール。失敗した場合はセットアップを中断せず、報告してスキップします（Claude Codeはglibcローダー経由で動作します。Codex CLIはパッケージが os: android を宣言している一方、このNode.jsは linux を報告するため、Clawアプリでは --force でインストールします。Termuxでは警告付きでスキップされる場合があります）

[8/8] 検証 — tests/verify-install.sh

2階層の検証を実行します。

オーケストレーター検証（FAILレベル）:

オーケストレーター検証（WARNレベル、非クリティカル）:

プラットフォーム検証 — platforms/<platform>/verify.sh に委譲:

すべてのFAILレベルがパスすればPASSED。FAILがあれば再インストール手順を表示します。WARN項目は失敗扱いになりません。

軽量アップデーターのフロー — oa --update

oa --update（または後方互換のため oaupdate）を実行すると、最新リリースのtarballをGitHubからダウンロードし、次の5ステップを実行します。

[1/5] 起動前チェック

更新の前提条件を検証します。

• $PREFIX の存在を確認（Termux環境）
• curl の存在を確認
• ~/.openclaw-android/.platform マーカーからプラットフォームを検出
• アーキテクチャを検出: glibc（.glibc-arch マーカー）またはBionic（レガシー）
• 必要に応じて旧ディレクトリ名を移行（.openclaw-lite → .openclaw-android — レガシー互換）
• Phantom Process Killer（Android 12+）: 無効化ガイド のリンク付きで案内を表示
• 同時に実行できるのは1つだけ: セットアップ・アップデート・ツールのインストールは同時には1つだけ実行されます。2つ目の実行は [FAIL] Another update, setup or tools run is in progress. Try again when it has finished. を表示し、インストールを変更せずに終了コード2で終了します

[2/5] 最新リリースのダウンロード

リポジトリ全体のtarballをGitHubからダウンロードし、一時ディレクトリに展開します。必要なファイルがすべて存在することを検証します。

• scripts/lib.sh
• scripts/setup-env.sh
• platforms/<platform>/config.env
• platforms/<platform>/update.sh

[3/5] コアインフラの更新

今回の更新で固定されたNode.jsまたはOpenClawのバージョンが変わる場合は、何かを変更する前に3つの安全策が先に実行されます。空き容量の確認（2000MB）、OpenClawゲートウェイが動作中でないことの確認、~/.openclaw-android/backup/pre-update/ へのデータバックアップです（アップデートを参照）。

アップデーター、アンインストーラー、CLIで共有されるファイルを更新します。

• アップデートスクリプト自身が最新かを確認します。古いキャッシュのコピーが届いた場合（リリース直後の数分間に起こりえます）は、何も変更せずに停止します。数分後に oa --update をもう一度実行してください
• 最新のプラットフォームディレクトリを ~/.openclaw-android/platforms/ にコピー
• ~/.openclaw-android/scripts/ の lib.sh と setup-env.sh を更新
• パッチファイル（glibc-compat.js、argon2-stub.js、spawn.h、systemctl）を更新
• $PREFIX/bin/ の oa CLIと oaupdate ラッパーを更新
• ~/.openclaw-android/ の uninstall.sh を更新
• Bionicアーキテクチャを検出した場合はglibcへの自動マイグレーションを実施
• Node.jsを固定バージョンに収束させる（sha256検証付きダウンロード、アトミックな入れ替え — 何か失敗した場合は以前のインストールが復元されます）。OA_ALLOW_NODE_DOWNGRADE=1 を設定しない限り、Node.jsをより低いバージョンに下げることはありません
• setup-env.sh を実行して .bashrc の環境ブロックを更新
• Nodeゲート: この時点でNode.jsが固定バージョンになっていなければ、アップデートはここで停止し、OpenClaw（[4/5]）には手を付けません。oa --update をもう一度実行してください

[4/5] プラットフォーム更新

platforms/<platform>/update.sh に委譲します。OpenClawの場合は次を実行します。

• 固定バージョンが変わった場合: インストール後にOpenClawの設定とデータの状態を確認し、データ移行が必要で今回の実行でバックアップを作成していれば openclaw doctor --fix を1回実行（アップデートを参照）
• インストール後、設定の確認の直前に、他のアプリのフォルダを指すパスを修復（バックアップとリストアを参照）
• 最後のデータ確認（openclaw config validate と openclaw doctor --non-interactive）: ゲートウェイがOpenClawのデータを使用中で、今回の実行でOpenClawを置き換えていない場合は、確認を失敗とせずにスキップし、[WARN] The gateway is using the OpenClaw state, so the data check was skipped. Stop the gateway, then run: openclaw doctor を表示してアップデートを続行
• binutils をインストール（ネイティブモジュールのビルド用）
• Node.jsの固定を安全策として再確認（多層防御 — [3/5] でもすでにゲートされています）
• openclaw を固定バージョンに収束させる — インストール済みバージョンがより低い場合に固定バージョンをインストールする。OA_ALLOW_OPENCLAW_DOWNGRADE=1 を設定しない限り、OpenClawをより低いバージョンに下げることはありません
• OpenClawが不完全な場合（以前のインストールが途中で中断され、バージョンは合っているがファイルが欠けている状態）、固定バージョンと同じでもインストールし直します: [WARN] openclaw <version> is incomplete (an earlier install was cut off): installing it again。最後のデータ確認でOpenClaw自身のファイルが欠けていると報告された場合（OpenClawパッケージ内のパスに対する Cannot find module または Cannot find package）、1回だけインストールし直します: [WARN] OpenClaw <version> is missing some of its own files (an earlier install was cut off): installing it again。どちらの場合もデータには手を付けません。今回の実行でインストールした後もOpenClawが不完全な場合、アップデートは [FAIL] OpenClaw <version> was installed but is incomplete (files are missing or it does not start). を表示して停止します。
• プラットフォーム固有のパッチを再適用
• openclaw update ガード（openclaw-shim.sh）を更新し、openclaw update/--update のブロックを維持（Node.jsラッパーはOpenClaw自身のアップデート経路もブロックします）
• clawdhub（スキルマネージャ）を更新／インストール
• 必要に応じてclawdhub用の undici をインストール（Node.js v24+）
• ゲートウェイの "update available" 通知をオフにする（update.checkOnStart=false）。自分で値を設定していない場合のみ
• 必要に応じてスキルを ~/skills/ から ~/.openclaw/workspace/skills/ へ移行
• 不足していればPyYAMLをインストール

[5/5] オプションツールの更新

既にインストールされているツールを更新します。

• code-server: install-code-server.sh を更新モードで実行 — code-serverを固定の4.117.0に保ちます（以前により新しいバージョンをインストールしていた場合は戻されます）。未インストールならスキップ
• OpenCode: インストール済みなら更新、未インストールならインストールを案内。glibcアーキテクチャ必須
• Chromium: インストール済みなら更新。未インストールならスキップ
• AI CLIツール（Claude Code、Gemini CLI、Codex CLI（Termux））: インストール済みのバージョンと最新npmバージョンを比較し、必要に応じて更新。未インストールのツールには更新を提案しません