ClawPhone — Androidスマートフォン上で動かす OpenClaw の調整

Tool
ClawPhone — Androidスマートフォン上で動かす OpenClaw の調整

ClawPhone — Androidスマートフォン上で動かす OpenClaw の調整

OpenClaw を低価格 Android スマートフォン上で動かすための調整をまとめた小さなリポジトリ。Termux＋tmux 環境で常駐させ、Discord 経由でエージェントと対話できるようにするための工夫や、端末ハードウェア（タッチ入力や画面表示など）を OpenClaw エージェントが扱えるようにするためのデーモン的スクリプトを含みます。軽量かつ実験的なセットアップをすばやく試したい開発者向けの内容です（約300字）。

https://github.com/marshallrichards/ClawPhone

概要

ClawPhone は、低価格の Android スマートフォン上で OpenClaw を動作させるための「小さな調整集」です。作者は $25 の Android 機で OpenClaw を走らせ、エージェントに端末ハードウェアへのアクセスを持たせることを目的に実験を行っています。パッチや設定の工夫により、Termux 上の tmux セッションで OpenClaw を常駐させ、Discord 経由でやり取りしながら通常のエージェント同様に操作できる状態を実現しています。リポジトリ自体は簡潔で、主に Android 側でのオーバーレイや入力管理を担うスクリプトを含みます。

GitHub

リポジトリの統計情報

  • スター数: 32
  • フォーク数: 4
  • ウォッチャー数: 32
  • コミット数: 4
  • ファイル数: 2
  • メインの言語: Python

主な特徴

  • Termux + tmux を前提に、OpenClaw を Android 上で常駐実行できるようにする調整。
  • Discord 経由でエージェントと対話可能な運用フローを想定。
  • overlay_daemon.py によるオーバーレイ／入力管理の自動化（推定）。
  • 軽量で試用しやすく、実験・プロトタイピング向け。

技術的なポイント

ClawPhone は大きなフレームワークではなく、「Android 環境で OpenClaw を動かすための現実的な工夫集」という位置づけです。README の記述とファイル構成から読み取れる主な技術的ポイントを整理します。

  1. Termux と tmux による常駐実行
    Android 上で長時間プロセスを安定稼働させるには、端末の省電力やプロセス制限、SSH セッション切断時の維持などを考慮する必要があります。Termux は Android 上で Linux ライクな環境を提供し、tmux を使えばセッションの切断・再接続に強い常駐環境を作れます。ClawPhone はこの組み合わせを前提にして、OpenClaw エージェントをバックグラウンドで動かす運用を提案しています。

  2. オーバーレイと入力注入の管理 (overlay_daemon.py)
    リポジトリに含まれる overlay_daemon.py は、画面上のオーバーレイ表示や入力（タップやスワイプ）をエージェントから扱うためのデーモンであると推測されます。Android でユーザ操作を模倣するには、主に以下のアプローチがあります：Accessibility API を使う、input コマンドや uinput 経由でのイベント注入、MediaProjection API による画面キャプチャ等。root が無い環境では Accessibility や Termux:API の Intent 呼び出しを組み合わせることが現実的です。overlay_daemon.py はこうした手段をラップし、OpenClaw 側の命令を受け取って画面操作やオーバーレイの出し入れを行う役割を担っていると考えられます。

  3. 通信・操作インターフェース
    README にある「Discord 経由でインタラクトする」という運用は、OpenClaw エージェントが Discord ボットやウェブソケットを通じてコマンドを受け取り、その結果を外部に報告する構成を示します。スマートフォン側では overlay_daemon がローカルで命令を受けて実行し、状態やスクリーンショットを Discord に返す、というフローが想像できます。軽量構成のために HTTP ソケットやローカル FIFO、もしくは WebSocket を利用する実装が現実的です。

  4. 実運用での注意点
    Android のバージョン差、メーカーの省電力機構（Doze、アプリスタンバイ）、権限モデル（ランタイム権限、Accessibility の許可）、セキュリティ（公開鍵・認証）、そしてハードウェア差による挙動の違いが実験の成否に影響します。ClawPhone はこうした課題に対して「実機で動く最小実装」を示しており、ユーザーは端末毎の追加対応（自動起動の許可、Battery optimization の無効化等）を行う必要があります。

プロジェクトの構成

主要なファイルとディレクトリ：

  • README.md: file
  • overlay_daemon.py: file

まとめ

軽量かつ実験的に Android で OpenClaw を動かすための実用的な調整集です（50字程度）。

リポジトリ情報：

（注）本文は README の説明とリポジトリ構成から読み取れる設計意図や一般的な Android 上での運用ノウハウを元に説明しています。具体的な実装の詳細は overlay_daemon.py および README を参照してください。