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

ToolOpenClawAndroidTermux

marshallrichards/ClawPhone

GitHub で見る

GitHub →

概要

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 を参照してください。

関連記事

Tool

Termux Backgroundプラグイン：Termuxにカスタム背景画像を設定するツール

Termux Backgroundは、Androidのターミナルエミュレータ「Termux」にカスタム背景画像を設定できるプラグイン兼CLIツールです。画像の不透明度調整、アニメーション表示、ぼかし効果、配置モードの切り替えなど豊富な機能を備え、設定のライブリロードやGUI操作も可能。ユーザーのターミナル体験をビジュアル面で大きく向上させます。

TermuxAndroidカスタム背景
DevOps

Termux（Android・root不要）でSambaサーバーをセットアップ

Termux上でAndroid端末をSambaファイルサーバーにするためのチュートリアルリポジトリ。Sambaのインストール手順、Samba用ユーザーの追加方法、そして例示的なsmb.confが含まれており、root権限なしで簡易的にファイル共有環境を構築する流れを示します。Androidのストレージ権限やポート制限などの注意点も読み解けます。（約300字）

SambaTermuxAndroid
Mobile

非root Android端末でMinecraft Javaサーバーを動かすガイド

本リポジトリは、root化していないAndroidスマートフォン上でMinecraft Javaサーバーを動作させるためのシンプルかつ詳細な手順を提供しています。Termux環境を利用し、Android 11以降の端末でサーバー構築を可能にするため、PCなしで手軽にMinecraftのマルチプレイ環境を作りたいユーザーに最適です。必要なアプリや設定方法を丁寧に解説し、初心者でも理解しやすい内容となっています。

AndroidMinecraftTermux
Tool

acli — 統合Androidコマンドラインツール

Android開発で使う複数のコマンドラインツール（sdkmanager, avdmanager, adb, fastboot, Gradle 等）を単一の使いやすい CLI に統合するツールです。パッケージパスや各ツール固有のフラグを覚える必要を減らし、開発者のローカル環境と CI 両方で一貫した操作性を提供します。Go 言語で実装され、CI ワークフローやライセンス情報が含まれています。導入することで、設定確認（doctor）や AVD 操作、パッケージ管理、デバイス操作などを短いコマンドで扱えるようになります。

AndroidCLIGo
Tool

Live To 100 — 長寿実行システム

OpenClaw向けの「長寿実行システム」。基線データ収集から12週間プランの作成、複雑なリマインダー設定、日々の食事記録、栄養ギャップ解析、週報／月報生成までを一貫して支援するツール。チャット形式でもスクリプト形式でも利用でき、JSON入力を受けてMarkdown出力を行うことで自動化やレポーティングに適した設計になっています。（約300字）

長寿ヘルスケアOpenClaw
Tool

Project Loop — OpenClaw向け軽量プロジェクトオーケストレーション

Project Loopは、OpenClaw用の「長期稼働タスク」を堅牢に扱うための軽量オーケストレーションスキルです。セッションのリセットや中断、承認フロー、検証、途切れたセッションからの復旧が必要なプロジェクト向けに設計されており、プロジェクトファイル（manifest.mdやstate.json）を真実の単一情報源とします。短期の一回限りのタスクや無目的な自律動作には向きません。承認ゲートや自己完了可能なタスクを通じて、長期的な作業を継続的に管理するための設計思想を提供します。

オーケストレーションOpenClawプロジェクト管理