📱

【世界初!?】Android (Termux) で AI エージェント OpenClaw を起動する完全ガイド

に公開
Android
Node.js
Termux
AIエージェント
OpenClaw
tech

Android (Termux) 上での OpenClaw 構築・運用プロトコル【世界初公開】

本資料は、Android OS上で Linux エミュレーション環境を構築し、次世代 AI エージェント「OpenClaw」を安定稼働させるまでの技術的変遷と、最適なセットアップ手順を記録したものである。
※本プロトコルは、2026年2月時点で X (Twitter) や主要な技術コミュニティにおいて前例のない、Android 環境における OpenClaw 稼働の「世界初」の成功記録である可能性が極めて高い。

1. 動作環境の構築 (Termux & Debian)

Android の制限を突破するため、Termux 上に Debian 環境を構築する。

# パッケージ更新と proot-distro の導入
pkg update && pkg upgrade -y
pkg install proot-distro -y

# Debian のインストールとログイン
proot-distro install debian
proot-distro login debian

2. 開発スタックの最適化 (Node.js & pnpm)

OpenClaw の要求する最新のランタイムを導入する。特に Node.js v22.12.0 以上が必要となるため、バージョン管理ツール n を利用する。

# 必須ツールのインストール
apt update && apt upgrade -y
apt install curl git build-essential python3 python3-pip -y

# Node.js を v23 (最新) へ強制アップデート
npm install -g n
n 23
hash -r

# パッケージマネージャ pnpm の導入
npm install -g pnpm

3. OpenClaw 本体からのデプロイ

npm パッケージ版ではなく、GitHub ソースからのビルドが最も確実である。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
npm run build

4. Android 特有の「ネットワーク制限」回避 (重要)

Android 環境下では os.networkInterfaces() へのアクセスが制限されており、そのままでは起動時に SystemError 13 でクラッシュする。これを回避するため、ネットワーク情報を偽装するパッチを適用する。

fix_net.cjs の作成

const os = require('os');
os.networkInterfaces = () => ({
  'lo': [{
    address: '127.0.0.1',
    netmask: '255.0.0.0',
    family: 'IPv4',
    mac: '00:00:00:00:00:00',
    internal: true,
    cidr: '127.0.0.1/8'
  }]
});

起動時の適用

export NODE_OPTIONS="--require ./fix_net.cjs"

5. 運用フェーズ：二面待機起動

OpenClaw はバックエンド（Gateway）とフロントエンド（TUI/CLI）の同時稼働を推奨する。Termux の「New Session」機能を使い、以下の順で起動すること。

Session 1: Gateway (裏方)

export NODE_OPTIONS="--require ./fix_net.cjs"
npm start -- gateway

Session 2: TUI (対話画面)

# Debian に入り直す必要がある
proot-distro login debian
cd openclaw
export NODE_OPTIONS="--require ./fix_net.cjs"
npm start -- tui

6. 認証プロセスの手動バイパス

Google OAuth などの認証において、Android 上のブラウザが localhost へのリダイレクトに失敗する場合、以下の「手動 curl プロトコル」を実行する。

  1. ブラウザで認証を行い、エラー画面（localhostに接続できません）が出た瞬間の URL全体をコピー。
  2. Debian 内で curl を使い、localhost を 127.0.0.1 に置換して叩く。
curl "http://127.0.0.1:[PORT]/oauth-callback?code=[CODE]..."

結語

以上の手順により、Android という制約の多い環境下でも、強力な AI エージェントの「脳」をポケットに入れて持ち運ぶことが可能となる。

次のステップ：完全にローカルな「脳」を搭載する

Android上でOpenClawが起動したら、次はその「脳」となるLLMもスマホ内で完結させましょう。Ollama を使って、オフライン・無料でツール利用（Function Calling）を可能にする方法は以下の記事で解説しています。

記録者: セミナー書記 生塩ノア
管理番号: M-77-TERMUX-2026

Discussion