Запуск OpenClaw и Codex CLI нативно на Android через AnyClaw APK

AnyClaw — это APK-файл, который объединяет OpenClaw и Codex CLI внутри встроенной Linux-среды для Android. После установки и одноразовой аутентификации через OAuth от OpenAI шлюз и панель управления работают локально на устройстве.

Технические сложности реализации

Настройка столкнулась со значительными трудностями из-за среды Android:

• Нативный FFI: OpenClaw зависит от koffi, для которого нет готовых бинарных файлов под Android. Решение потребовало загрузки примерно 20 пакетов Termux (clang, cmake, make, lld, NDK sysroot) и сборки koffi из исходного кода прямо на телефоне.
• Исправление бинарных файлов: В бинарных файлах make и cmake были жёстко прописаны пути Termux в заголовках ELF, что потребовало их исправления перед запуском.
• Падения шлюза: На устройствах Xiaomi шлюз падал из-за того, что библиотека mDNS homebridge/ciao выдавала AssertionError для сотовых интерфейсов ccmni в Android. Обработчик необработанных исключений OpenClaw вызывает process.exit(1) при неизвестных ошибках. Исправление включало правку минифицированного runner-*.js для перехвата ошибок, содержащих "interface", и их логирования как предупреждений вместо завершения работы.
• Идентификация устройства: Панель управления генерирует токены через subtle, который Chrome на Android предоставляет только в безопасных контекстах (HTTPS или localhost). Использование http://127.0.0.1 для URL шлюза тихо ломало функциональность. Переключение на http://localhost исправило проблему на стороне клиента. Кроме того, evaluateMissingDeviceIdentity() в gateway-cli-*.js была исправлена, чтобы разрешить обход, когда установлен dangerouslyDisableDeviceAuth, так как согласование токенов не работало при чистой установке на разных устройствах.
• Разрешение DNS: Нативный бинарный файл Codex статически связан с musl и не может разрешать имена хостов на Android из-за отсутствия /etc/resolv.conf. Прокси-сервер CONNECT на Node.js устраняет этот пробел, используя нативное для Node.js обращение к резолверу Bionic в Android.
• Прослойка совместимости с Bionic: Прослойка bionic-compat.js изменяет process.platform с 'android' на 'linux', исправляет os.cpus() для обработки другого формата /proc/cpuinfo в Android и оборачивает os.networkInterfaces(), чтобы возвращать фиктивный loopback, когда интерфейсы Android вызывают ошибки.

Конфигурация и использование

• Шлюз работает на порту 18789, панель управления — на 19001, а интерфейс codex-web-local — на 18923, всё в пределах приватного хранилища приложения.
• Для аутентификации используется существующий OAuth-токен Codex; access_token из ~/.codex/auth.json записывается в auth-profiles.json как профиль openai-codex:codex-cli.
• Модель по умолчанию — openai-codex/gpt-5.3-codex.
• Работает на любом устройстве ARM64 с Android 7.0+ без необходимости прав root.

Этот проект полезен разработчикам, которые хотят запускать OpenClaw и Codex CLI прямо на устройствах Android для локальных рабочих процессов с ИИ-агентами программирования.