App Nexus Android — Desarrollo
Descripción
App nativa Android (Kotlin + Jetpack Compose) que conecta directamente con Nexus (OpenClaw gateway) como canal de comunicación tipo Gemini. Soporta hilos de conversación separados por proyecto, imágenes, voz, y sincronización entre dispositivos.
Arquitectura
App Android (Kotlin/Compose) → Gateway Nexus (OpenAI HTTP API) → Nexus
↘ Sync API (puerto 3781) → historial sincronizado
Componentes del backend
- Gateway Nexus: Puerto 18789, API OpenAI-compatible. Cada hilo de conversación usa
x-openclaw-session-keypara sesiones separadas. - Sync API: Node.js/Express en puerto 3781. Sirve historial de conversaciones, subida de audio, y versiones del APK.
- Caddy: Proxy reverso. Rutas:
/api/nexus/*→ Sync API (3781)/nexus-app/*→ Sync APIhttps://nexus.disoftx.solutions→ dominio público con SSL
Accesos públicos
- Descarga APK:
https://nexus.disoftx.solutions/api/nexus/app/download - Health check:
https://nexus.disoftx.solutions/api/nexus/health - Version info:
https://nexus.disoftx.solutions/api/nexus/app/version - Tailscale (interno):
http://100.96.185.88:3781/api/nexus/...
SDK/Tools instalados en VPS
- Java 17 (Temurin) via SDKMAN
- Gradle 9.6.1 (system) + 8.11.1 (wrapper)
- Android SDK en
/opt/android-sdkcon platform 34 y 35 - Proyecto en
/home/admin/.openclaw/workspace/nexus-app/ - Sync API en
/home/admin/.openclaw/workspace/nexus-sync/
Versionado del APK
Servido por Sync API en:
- GET /api/nexus/app/version → version.json
- GET /api/nexus/app/download → APK más reciente
- POST /api/nexus/app/publish → publicar nueva versión (uso interno)
Historial de versiones
v1.10.0 — 02/08/2026
- 🔁 Sync corregido: títulos se actualizan entre dispositivos (server guarda títulos custom en titles.json)
- 🔁 Merge real de mensajes: al abrir un hilo baja los mensajes que faltan (antes solo insertaba si el hilo estaba vacío)
- ✏️ Renombrar hilo ahora se sube al servidor y se propaga a otros dispositivos
- ⌨️ Enter = enviar | Ctrl+Enter = salto de línea
- Server: PUT /api/nexus/threads/:key para rename + campo customTitle en /threads
v1.0.0 — 29/07/2026
Primera versión funcional:
- Chat con Nexus por hilos (sesiones separadas)
- Soporte para imágenes (base64 + visión IA)
- Grabación de voz (STT nativo Android)
- TTS nativo Android para leer respuestas
- Adaptable: phone (una pantalla) ↔ tablet (dos paneles)
- Sincronización entre dispositivos vía Sync API
- Auto-update con detección de versiones
- Almacenamiento local con Room DB
- Conexión via Tailscale al gateway
v1.1.0 — 29/07/2026
- Fix: Barra de navegación ya no tapa el campo de texto
- Nueva: Fijar conversaciones (pin)
- Nueva: Renombrar conversaciones
- Nueva: Menú contextual al mantener presionado
v1.1.1 — 29/07/2026
- Fix: Token de autenticación corregido (se había hardcodeado con ellipsis 0x2026 en vez del token completo de 48 caracteres)
- Fix: navigationBarsPadding agregado al contenido
v1.1.2 — 29/07/2026
- Fix: Teclado empuja el input hacia arriba (imePadding en Box wrapper)
- Fix: Botón Nuevo hilo ya no se tapa con barra del sistema
v1.1.3 — 29/07/2026
- Fix: Botón de actualizar ahora funciona correctamente
- Fix: Muestra versión real instalada (ya no hardcodeada como v1.0.0)
- Cleanup: Auto-updater ahora usa syncApi directo sin reflection
Componentes del proyecto Android (30+ archivos)
nexus-app/
├── app/src/main/java/com/nexus/app/
│ ├── NexusApp.kt — Application class (inicializa todo)
│ ├── MainActivity.kt — Entry point (adaptable phone/tablet)
│ ├── ui/
│ │ ├── theme/ — Colores, tipografía, tema Material3
│ │ ├── navigation/ — NavGraph (threads, chat, settings)
│ │ ├── screens/
│ │ │ ├── ThreadListScreen — Lista de conversaciones + búsqueda
│ │ │ ├── ChatScreen — Mensajes + input + imágenes + audio
│ │ │ └── SettingsScreen — Versión + actualizaciones
│ │ └── components/
│ │ ├── ThreadItem — Card de hilo con menú contextual
│ │ ├── MessageBubble — Burbuja de mensaje (usuario/asistente)
│ │ └── AdaptiveLayout — Layout responsive
│ ├── data/
│ │ ├── local/ — Room DB (entities, DAOs, database)
│ │ └── remote/ — GatewayApi + SyncApi + ApiModels
│ ├── repository/ — ChatRepository + ThreadRepository
│ ├── viewmodel/ — ThreadListViewModel + ChatViewModel
│ ├── audio/ — AudioHandler (STT + TTS nativo)
│ └── update/ — AppUpdater (check + download + install)
Pendientes (features futuras)
- [ ] Error reporting (log de errores subido al Sync API)
- [ ] Changelog visible en la app
- [ ] Indicador de conexión (punto verde/rojo)
- [ ] Búsqueda en el historial de mensajes
- [ ] Exportar conversación como texto
- [ ] App de escritorio Windows (Delta integration)
- [ ] Notificaciones push
- [ ] Modo offline con cola de reintento
Cómo compilar
cd /home/admin/.openclaw/workspace/nexus-app
source "$HOME/.sdkman/bin/sdkman-init.sh"
export ANDROID_SDK_ROOT="/opt/android-sdk"
export JAVA_HOME="$HOME/.sdkman/candidates/java/17.0.9-tem"
./gradlew assembleDebug