aidanpark/openclaw-android
Run OpenClaw on Android with a single command — no proot, no Linux
OpenClaw on Android – クイック概要
それは何か – 完全な Linux ディストリビューションなしで Android スマートフォンで OpenClaw AI エージェントプラットフォームを実行できる軽量インストーラー。glibc 動的リンカー、glibc ビルドの Node.js バイナリ、および標準の Linux パスを Termux のファイルシステムに変換するスクリプトセットを同梱しているため、通常の OpenClaw バイナリがネイティブに動作します。
重要な理由
| 従来の方法（proot-distro） | このプロジェクト |
|---|---|
| 完全な Debian/Ubuntu rootfs をインストール（約 1-2 GB） | ld.so のみをインストール（約 200 MB） |
| 20-30 分のセットアップ、追加の proot レイヤー → 遅い | 3-10 分のワンコマンドインストール、ネイティブ速度 |
| Termux 内で Linux 環境を管理する必要がある | Termux で直接動作（またはオプションの Claw アプリ 経由） |
結果として、はるかに小さなフットプリント、高速な実行、そしてスマートフォンで OpenClaw エージェントを実行したい人にとって よりシンプルなユーザーエクスペリエンス が得られます。
主要コンポーネント
| コンポーネント | 機能 |
|---|---|
| glibc ld.so | GNU C ライブラリローダーを提供し、標準の Linux バイナリが Android の Bionic/Termux 環境で実行できるようにします。 |
| Node.js（arm64、glibc） | OpenClaw JavaScript ランタイムを実行します。小さなローダースクリプトでラップされており、patchelf は不要です。 |
oa CLI |
インストール、更新、バックアップ、復元、ツール管理のためのヘルパーコマンド（oa --install、oa --update、oa --backup など）。 |
| Claw Android アプリ（オプション） | ターミナルエミュレータと WebView UI をバンドル。ワンタップブートストラップ、ダッシュボード、ツールインストーラー – Termux から完全に独立して動作します。 |
| 追加ツール | tmux、ttyd、dufs、Android 固有のユーティリティ、Playwright、Claude-Code、Gemini-CLI、Codex-CLI（oa --install でインストール）。 |
インストール手順（Termux）
- F-Droid から Termux をインストール（Play Store バージョンは廃止）。
- アップグレードして curl をインストール：
pkg upgrade -y && pkg install -y curl - ワンライナーインストーラーを実行：
glibc ローダー、Node.js、OpenClaw を約 200 MB でインストール。curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc - OpenClaw のオンボーディングを完了：
openclaw onboard - ゲートウェイを起動（Web ダッシュボードを提供する長時間実行プロセス）：
別の Termux タブで実行；停止するにはopenclaw gatewayCtrl+Cを押します。
オプションの Claw アプリの使用
- Releases ページから APK をダウンロードします。
- アプリはターミナルを起動し、同じインストーラーを実行し、その後グラフィカルダッシュボード（http://127.0.0.1:18789）と、内部で
oa --updateを呼び出す 設定 → インストールと更新 画面を提供します。 - 追加ツールのインストール、バックアップの管理、ランタイム情報の表示が可能で、既存の Termux インストールには影響しません。
インストールの管理（oa コマンド）
| コマンド | 目的 |
|---|---|
oa --update |
固定された OpenClaw、Node.js、およびオプションツールを取得；更新前バックアップを作成；空き容量を検証。 |
oa --install |
オプションの追加機能（tmux、code-server、AI CLI など）をインストール。 |
oa --uninstall |
デバイスから OpenClaw と glibc ローダーを削除。 |
oa --backup / oa --restore |
安全チェック付きで ~/.openclaw（SQLite データベースを含む）を tar アーカイブ；バイナリではなくデータのみを復元。 |
oa --status |
どのコンポーネントが存在するか、ハードリンクパッチがアクティブかどうかを表示。 |
すべてのコマンドは再実行しても安全です。同時更新を避けるためにロックされます。
データの安全性とバックアップ
- バックアップは
~/.openclaw-android/backup/に保存され、プライベート（chmod 600）です。API キーと会話履歴が含まれています – 絶対に共有しないでください。 - バージョン変更の前に、インストーラーは自動的に更新前バックアップを作成します（最新の 3 つを保持）。
- 復元では、Termux インストールと Claw アプリ間でデータを移動した後に残る可能性のある古い絶対パスを書き換えます。
パフォーマンスと制限
- コマンドは、スマートフォンのストレージ上の多くのファイルを読み取るため、デスクトップよりも遅く感じることがあります。
- ゲートウェイは Termux 内で直接 実行する必要があります。SSH 経由では、SSH セッションが終了すると停止します。
- 一部の重いツール（code-server、Chromium）はアプリからインストールできませんが、ターミナルから手動で追加できます。
誰がこれを使うべきか？
- モバイルデバイスで OpenClaw を試したい AI エージェント開発者。
- テストや外出先でのデバッグ用に、ポータブルで低オーバーヘッドな OpenClaw ノードが必要な パワーユーザー。
- Android で ワンコマンド、Linux ディストリビューション不要 のセットアップを望むすべての人。
クイックリファレンスチートシート
# インストール（Termux）
curl -sL https://myopenclawhub.com/install | bash && source ~/.bashrc
# 初回オンボーディング
openclaw onboard
# ゲートウェイを実行（タブで維持）
openclaw gateway
# すべてを更新
oa --update && source ~/.bashrc
# 追加ツールをインストール（tmux、AI CLI など）
oa --install
# データをバックアップ
oa --backup
# バックアップを復元
oa --restore
結論： OpenClaw on Android は、重量級の proot-distro 要件を排除し、軽量（約 200 MB）のネイティブインストールを提供します。これにより、完全な OpenClaw エージェントエコシステムがスマートフォン上で直接実行でき、Claw アプリによるオプションの GUI サポートも利用できます。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト