AnyClaw APKを使用して、Android上でOpenClawとCodex CLIをネイティブ実行

AnyClawは、OpenClawとCodex CLIをAndroid向けの組み込みLinux環境内にバンドルしたAPKです。インストール後、一度だけOpenAI OAuth認証を行うと、ゲートウェイとコントロールUIがデバイス上でローカルに実行されます。

技術的な実装の課題

Android環境の特性により、セットアップには大きな課題がありました：

• ネイティブFFI： OpenClawはkoffiに依存していますが、事前ビルドされたAndroidバイナリが存在しません。解決策として、約20個のTermuxパッケージ（clang、cmake、make、lld、NDK sysroot）をダウンロードし、koffiをスマートフォン上で直接ソースからビルドする必要がありました。
• バイナリパッチング： makeおよびcmakeバイナリのELFヘッダーにはTermuxパスがハードコードされており、実行前にバイナリパッチングが必要でした。
• ゲートウェイのクラッシュ： Xiaomiデバイスでは、Androidのccmni携帯ネットワークインターフェースに対してhomebridge/ciao（mDNSライブラリ）がAssertionErrorをスローし、ゲートウェイがクラッシュしました。OpenClawのunhandledRejectionハンドラーは認識されないエラーに対してprocess.exit(1)を呼び出します。修正には、ミニファイされたrunner-*.jsをパッチし、「interface」を含むエラーをキャッチして終了せずに警告としてログに記録するようにしました。
• デバイス識別： コントロールUIはsubtleを介してトークンを生成しますが、Android版Chromeはセキュアコンテキスト（HTTPSまたはlocalhost）でのみこれを公開します。ゲートウェイURLにhttp://127.0.0.1を使用すると機能が暗黙的に破損しました。http://localhostに切り替えることでクライアント側が修正されました。さらに、gateway-cli-*.js内のevaluateMissingDeviceIdentity()にパッチを当て、dangerouslyDisableDeviceAuthが設定されている場合にバイパスを許可するようにしました。これは、異なるデバイスでの新規インストール時にトークン交渉が失敗したためです。
• DNS解決： Codexネイティブバイナリはmuslと静的にリンクされており、/etc/resolv.confが存在しないためAndroidでホスト名を解決できません。Node.js CONNECTプロキシがこのギャップを埋め、Node.jsのネイティブなAndroid Bionicリゾルバーの使用を活用しています。
• Bionic互換性シム： bionic-compat.jsシムは、process.platformを「android」から「linux」にパッチし、Androidの異なる/proc/cpuinfo形式を処理するためにos.cpus()を修正し、Androidのインターフェースがエラーをスローした場合に偽のループバックを返すようにos.networkInterfaces()をラップします。

設定と使用方法

• ゲートウェイはポート18789、コントロールUIは19001、codex-web-localフロントエンドは18923で実行され、すべてアプリのプライベートストレージ内で動作します。
• 認証には既存のCodex OAuthトークンを使用します。~/.codex/auth.jsonからのaccess_tokenがauth-profiles.jsonにopenai-codex:codex-cliプロファイルとして書き込まれます。
• デフォルトモデルはopenai-codex/gpt-5.3-codexです。
• ルートアクセスを必要とせず、ARM64 Android 7.0以上の任意のデバイスで動作します。

このプロジェクトは、Androidデバイス上で直接OpenClawとCodex CLIを実行してローカルAIコーディングエージェントのワークフローを実現したい開発者にとって有用です。