Executando OpenClaw e Codex CLI Nativamente no Android via APK AnyClaw

AnyClaw é um APK que agrupa o OpenClaw e o Codex CLI dentro de um ambiente Linux embutido para Android. Após a instalação e uma autenticação única via OAuth da OpenAI, o gateway e a Interface de Controle são executados localmente no dispositivo.

Desafios Técnicos de Implementação

A configuração envolveu desafios significativos devido ao ambiente do Android:

• FFI Nativo: O OpenClaw depende do koffi, que não possui binários pré-construídos para Android. A solução exigiu o download de aproximadamente 20 pacotes Termux (clang, cmake, make, lld, NDK sysroot) e a construção do koffi a partir do código-fonte diretamente no telefone.
• Correção de Binários: Os binários make e cmake tinham caminhos do Termux codificados em seus cabeçalhos ELF, exigindo correção binária antes da execução.
• Falhas no Gateway: Em dispositivos Xiaomi, o gateway falhava devido à biblioteca mDNS homebridge/ciao lançar um AssertionError para as interfaces celulares ccmni do Android. O manipulador unhandledRejection do OpenClaw chama process.exit(1) em erros não reconhecidos. A correção envolveu ajustar o runner-*.js minificado para capturar erros contendo "interface" e registrá-los como avisos em vez de encerrar.
• Identidade do Dispositivo: A Interface de Controle gera tokens via subtle, que o Chrome no Android só expõe em contextos seguros (HTTPS ou localhost). Usar http://127.0.0.1 para a URL do gateway quebrava silenciosamente a funcionalidade. Mudar para http://localhost corrigiu o lado do cliente. Além disso, evaluateMissingDeviceIdentity() em gateway-cli-*.js foi ajustado para permitir bypass quando dangerouslyDisableDeviceAuth está definido, pois a negociação de tokens falhava em instalações novas em diferentes dispositivos.
• Resolução DNS: O binário nativo do Codex é vinculado estaticamente com musl e não consegue resolver nomes de host no Android devido à ausência de /etc/resolv.conf. Um proxy CONNECT Node.js preenche essa lacuna, aproveitando o uso nativo do Node.js do resolvedor Bionic do Android.
• Camada de Compatibilidade Bionic: Um shim bionic-compat.js ajusta process.platform de 'android' para 'linux', corrige os.cpus() para lidar com o formato diferente de /proc/cpuinfo do Android e envolve os.networkInterfaces() para retornar um loopback falso quando as interfaces do Android lançam erros.

Configuração e Uso

• O gateway é executado na porta 18789, a Interface de Controle na 19001 e o frontend codex-web-local na 18923, todos dentro do armazenamento privado do aplicativo.
• A autenticação usa o token OAuth existente do Codex; o access_token de ~/.codex/auth.json é escrito em auth-profiles.json como um perfil openai-codex:codex-cli.
• O modelo padrão é openai-codex/gpt-5.3-codex.
• Funciona em qualquer dispositivo Android ARM64 7.0+ sem exigir acesso root.

Este projeto é útil para desenvolvedores que desejam executar o OpenClaw e o Codex CLI diretamente em dispositivos Android para fluxos de trabalho de agentes de codificação de IA local.