fix: Storage safety, gateway stability, auth UX, canvas, deps (#21, #54, #55, #56, #59, #60, #61, #63, #64, #65, #66, #67)

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## v1.8.4 — Serial, Log Timestamps & ADB Backup
+
+### New Features
+
+- **Serial over Bluetooth & USB (#21)** — New `serial` node capability with 5 commands (`list`, `connect`, `disconnect`, `write`, `read`). Supports USB serial devices via `usb_serial` and BLE devices via Nordic UART Service (flutter_blue_plus). Device IDs prefixed with `usb:` or `ble:` for disambiguation
+- **Gateway Log Timestamps (#54)** — All gateway log messages (both Kotlin and Dart side) now include ISO 8601 UTC timestamps for easier debugging
+- **ADB Backup Support (#55)** — Added `android:allowBackup="true"` to AndroidManifest so users can back up app data via `adb backup`
+
+### Enhancements
+
+- **Check for Updates (#59)** — New "Check for Updates" option in Settings > About. Queries the GitHub Releases API, compares semver versions, and shows an update dialog with a download link if a newer release is available
+
+### Bug Fixes
+
+- **Node Capabilities Not Available to AI (#56)** — `_writeNodeAllowConfig()` silently failed when proot/node wasn't ready, causing the gateway to start with no `allowCommands`. Added direct file I/O fallback to write `openclaw.json` directly on the Android filesystem. Also fixed `node.capabilities` event to send both `commands` and `caps` fields matching the connect frame format
+
+### Node Command Reference Update
+
+| Capability | Commands |
+|------------|----------|
+| Serial | `serial.list`, `serial.connect`, `serial.disconnect`, `serial.write`, `serial.read` |
+
+---
+
 ## v1.8.3 — Multi-Instance Guard
 
 ### Bug Fixes

flutter_app/android/app/src/main/AndroidManifest.xml

@@ -19,14 +19,22 @@
     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" tools:replace="android:maxSdkVersion" />
     <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
+    <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
+    <uses-feature android:name="android.hardware.usb.host" android:required="false" />
 
     <application
         android:label="OpenClaw"
         android:name="${applicationName}"
         android:icon="@mipmap/ic_launcher"
         android:usesCleartextTraffic="true"
         android:requestLegacyExternalStorage="true"
-        android:extractNativeLibs="true">
+        android:extractNativeLibs="true"
+        android:allowBackup="true"
+        android:fullBackupContent="@xml/backup_rules"
+        android:dataExtractionRules="@xml/data_extraction_rules">
 
         <activity
             android:name=".MainActivity"
@@ -44,6 +52,12 @@
                 <action android:name="android.intent.action.MAIN"/>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
+            <intent-filter>
+                <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+            </intent-filter>
+            <meta-data
+                android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+                android:resource="@xml/usb_device_filter" />
         </activity>
 
         <service

flutter_app/android/app/src/main/kotlin/com/nxg/openclawproot/GatewayService.kt

@@ -219,7 +219,8 @@ class GatewayService : Service() {
 
     private fun emitLog(message: String) {
         try {
-            logSink?.success(message)
+            val ts = java.time.Instant.now().toString()
+            logSink?.success("$ts $message")
         } catch (_: Exception) {}
     }
 

flutter_app/android/app/src/main/kotlin/com/nxg/openclawproot/MainActivity.kt

@@ -461,6 +461,17 @@ class MainActivity : FlutterActivity() {
                         result.error("INVALID_ARGS", "path and content required", null)
                     }
                 }
+                "bringToForeground" -> {
+                    try {
+                        val intent = Intent(applicationContext, MainActivity::class.java).apply {
+                            flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_REORDER_TO_FRONT
+                        }
+                        applicationContext.startActivity(intent)
+                        result.success(true)
+                    } catch (e: Exception) {
+                        result.error("FOREGROUND_ERROR", e.message, null)
+                    }
+                }
                 "readSensor" -> {
                     val sensorType = call.argument<String>("sensor") ?: "accelerometer"
                     Thread {

flutter_app/android/app/src/main/res/xml/backup_rules.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- fullBackupContent rules for Android ≤11 -->
+<full-backup-content>
+    <include domain="sharedpref" path="." />
+</full-backup-content>

flutter_app/android/app/src/main/res/xml/data_extraction_rules.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- dataExtractionRules for Android 12+ -->
+<data-extraction-rules>
+    <cloud-backup>
+        <include domain="sharedpref" path="." />
+    </cloud-backup>
+    <device-transfer>
+        <include domain="sharedpref" path="." />
+    </device-transfer>
+</data-extraction-rules>

flutter_app/android/app/src/main/res/xml/usb_device_filter.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <usb-device />
+</resources>

flutter_app/lib/constants.dart

@@ -1,6 +1,6 @@
 class AppConstants {
   static const String appName = 'OpenClaw';
-  static const String version = '1.8.2';
+  static const String version = '1.8.4';
   static const String packageName = 'com.nxg.openclawproot';
 
   /// Matches ANSI escape sequences (e.g. color codes in terminal output).
@@ -11,6 +11,9 @@ class AppConstants {
   static const String githubUrl = 'https://github.com/mithun50/openclaw-termux';
   static const String license = 'MIT';
 
+  static const String githubApiLatestRelease =
+      'https://api.github.com/repos/mithun50/openclaw-termux/releases/latest';
+
   // NextGenX
   static const String orgName = 'NextGenX';
   static const String orgEmail = 'nxgextra@gmail.com';

flutter_app/lib/providers/node_provider.dart

@@ -9,6 +9,7 @@ import '../services/capabilities/flash_capability.dart';
 import '../services/capabilities/location_capability.dart';
 import '../services/capabilities/screen_capability.dart';
 import '../services/capabilities/sensor_capability.dart';
+import '../services/capabilities/serial_capability.dart';
 import '../services/capabilities/vibration_capability.dart';
 import '../services/native_bridge.dart';
 import '../services/node_service.dart';
@@ -29,6 +30,7 @@ class NodeProvider extends ChangeNotifier with WidgetsBindingObserver {
   final _locationCapability = LocationCapability();
   final _screenCapability = ScreenCapability();
   final _sensorCapability = SensorCapability();
+  final _serialCapability = SerialCapability();
   final _vibrationCapability = VibrationCapability();
 
   NodeState get state => _state;
@@ -74,8 +76,10 @@ class NodeProvider extends ChangeNotifier with WidgetsBindingObserver {
   @override
   void didChangeAppLifecycleState(AppLifecycleState state) {
     if (state == AppLifecycleState.resumed) {
+      _nodeService.setAppInForeground(true);
       _onAppResumed();
     } else if (state == AppLifecycleState.paused) {
+      _nodeService.setAppInForeground(false);
       _onAppPaused();
     }
   }
@@ -156,6 +160,11 @@ class NodeProvider extends ChangeNotifier with WidgetsBindingObserver {
       _sensorCapability.commands.map((c) => '${_sensorCapability.name}.$c').toList(),
       (cmd, params) => _sensorCapability.handleWithPermission(cmd, params),
     );
+    _nodeService.registerCapability(
+      _serialCapability.name,
+      _serialCapability.commands.map((c) => '${_serialCapability.name}.$c').toList(),
+      (cmd, params) => _serialCapability.handleWithPermission(cmd, params),
+    );
   }
 
   Future<void> _init() async {
@@ -211,6 +220,8 @@ class NodeProvider extends ChangeNotifier with WidgetsBindingObserver {
       Permission.camera,
       Permission.location,
       Permission.sensors,
+      Permission.bluetoothConnect,
+      Permission.bluetoothScan,
     ].request();
   }
 
@@ -306,6 +317,7 @@ class NodeProvider extends ChangeNotifier with WidgetsBindingObserver {
     _nodeService.dispose();
     _cameraCapability.dispose();
     _flashCapability.dispose();
+    _serialCapability.dispose();
     NativeBridge.stopNodeService();
     super.dispose();
   }

flutter_app/lib/screens/node_screen.dart

@@ -216,6 +216,12 @@ class _NodeScreenState extends State<NodeScreen> {
                       'Read accelerometer, gyroscope, magnetometer, barometer',
                       Icons.sensors,
                     ),
+                    _capabilityTile(
+                      theme,
+                      'Serial',
+                      'Bluetooth and USB serial communication',
+                      Icons.usb,
+                    ),
                     const SizedBox(height: 16),
 
                     // Device Info

flutter_app/lib/screens/settings_screen.dart

@@ -9,6 +9,7 @@ import '../constants.dart';
 import '../providers/node_provider.dart';
 import '../services/native_bridge.dart';
 import '../services/preferences_service.dart';
+import '../services/update_service.dart';
 import 'node_screen.dart';
 import 'setup_wizard_screen.dart';
 
@@ -32,6 +33,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
   bool _brewInstalled = false;
   bool _sshInstalled = false;
   bool _storageGranted = false;
+  bool _checkingUpdate = false;
 
   @override
   void initState() {
@@ -247,6 +249,18 @@ class _SettingsScreenState extends State<SettingsScreen> {
                   leading: Icon(Icons.info_outline),
                   isThreeLine: true,
                 ),
+                ListTile(
+                  title: const Text('Check for Updates'),
+                  subtitle: const Text('Check GitHub for a newer release'),
+                  leading: _checkingUpdate
+                      ? const SizedBox(
+                          width: 24,
+                          height: 24,
+                          child: CircularProgressIndicator(strokeWidth: 2),
+                        )
+                      : const Icon(Icons.system_update),
+                  onTap: _checkingUpdate ? null : _checkForUpdates,
+                ),
                 const ListTile(
                   title: Text('Developer'),
                   subtitle: Text(AppConstants.authorName),
@@ -347,6 +361,10 @@ class _SettingsScreenState extends State<SettingsScreen> {
         'dashboardUrl': _prefs.dashboardUrl,
         'autoStart': _prefs.autoStartGateway,
         'nodeEnabled': _prefs.nodeEnabled,
+        'nodeDeviceToken': _prefs.nodeDeviceToken,
+        'nodeGatewayHost': _prefs.nodeGatewayHost,
+        'nodeGatewayPort': _prefs.nodeGatewayPort,
+        'nodeGatewayToken': _prefs.nodeGatewayToken,
       };
 
       final path = await _getSnapshotPath();
@@ -397,6 +415,18 @@ class _SettingsScreenState extends State<SettingsScreen> {
       if (snapshot['nodeEnabled'] != null) {
         _prefs.nodeEnabled = snapshot['nodeEnabled'] as bool;
       }
+      if (snapshot['nodeDeviceToken'] != null) {
+        _prefs.nodeDeviceToken = snapshot['nodeDeviceToken'] as String;
+      }
+      if (snapshot['nodeGatewayHost'] != null) {
+        _prefs.nodeGatewayHost = snapshot['nodeGatewayHost'] as String;
+      }
+      if (snapshot['nodeGatewayPort'] != null) {
+        _prefs.nodeGatewayPort = snapshot['nodeGatewayPort'] as int;
+      }
+      if (snapshot['nodeGatewayToken'] != null) {
+        _prefs.nodeGatewayToken = snapshot['nodeGatewayToken'] as String;
+      }
 
       // Refresh UI
       await _loadSettings();
@@ -413,6 +443,54 @@ class _SettingsScreenState extends State<SettingsScreen> {
     }
   }
 
+  Future<void> _checkForUpdates() async {
+    setState(() => _checkingUpdate = true);
+    try {
+      final result = await UpdateService.check();
+      if (!mounted) return;
+      if (result.available) {
+        showDialog(
+          context: context,
+          builder: (ctx) => AlertDialog(
+            title: const Text('Update Available'),
+            content: Text(
+              'A new version is available.\n\n'
+              'Current: ${AppConstants.version}\n'
+              'Latest: ${result.latest}',
+            ),
+            actions: [
+              TextButton(
+                onPressed: () => Navigator.pop(ctx),
+                child: const Text('Later'),
+              ),
+              FilledButton(
+                onPressed: () {
+                  Navigator.pop(ctx);
+                  launchUrl(
+                    Uri.parse(result.url),
+                    mode: LaunchMode.externalApplication,
+                  );
+                },
+                child: const Text('Download'),
+              ),
+            ],
+          ),
+        );
+      } else {
+        ScaffoldMessenger.of(context).showSnackBar(
+          const SnackBar(content: Text("You're on the latest version")),
+        );
+      }
+    } catch (_) {
+      if (!mounted) return;
+      ScaffoldMessenger.of(context).showSnackBar(
+        const SnackBar(content: Text('Could not check for updates')),
+      );
+    } finally {
+      if (mounted) setState(() => _checkingUpdate = false);
+    }
+  }
+
   Widget _sectionHeader(ThemeData theme, String title) {
     return Padding(
       padding: const EdgeInsets.fromLTRB(16, 16, 16, 4),

flutter_app/lib/screens/splash_screen.dart

@@ -1,3 +1,4 @@
+import 'dart:convert';
 import 'dart:io';
 import 'package:flutter/material.dart';
 import 'package:google_fonts/google_fonts.dart';
@@ -73,6 +74,39 @@ class _SplashScreenState extends State<SplashScreen>
       final prefs = PreferencesService();
       await prefs.init();
 
+      // Auto-export snapshot when app version changes (#55)
+      try {
+        final oldVersion = prefs.lastAppVersion;
+        if (oldVersion != null && oldVersion != AppConstants.version) {
+          final hasPermission = await NativeBridge.hasStoragePermission();
+          if (hasPermission) {
+            final sdcard = await NativeBridge.getExternalStoragePath();
+            final downloadDir = Directory('$sdcard/Download');
+            if (!await downloadDir.exists()) {
+              await downloadDir.create(recursive: true);
+            }
+            final snapshotPath = '$sdcard/Download/openclaw-snapshot-$oldVersion.json';
+            final openclawJson = await NativeBridge.readRootfsFile('root/.openclaw/openclaw.json');
+            final snapshot = {
+              'version': oldVersion,
+              'timestamp': DateTime.now().toIso8601String(),
+              'openclawConfig': openclawJson,
+              'dashboardUrl': prefs.dashboardUrl,
+              'autoStart': prefs.autoStartGateway,
+              'nodeEnabled': prefs.nodeEnabled,
+              'nodeDeviceToken': prefs.nodeDeviceToken,
+              'nodeGatewayHost': prefs.nodeGatewayHost,
+              'nodeGatewayPort': prefs.nodeGatewayPort,
+              'nodeGatewayToken': prefs.nodeGatewayToken,
+            };
+            await File(snapshotPath).writeAsString(
+              const JsonEncoder.withIndent('  ').convert(snapshot),
+            );
+          }
+        }
+        prefs.lastAppVersion = AppConstants.version;
+      } catch (_) {}
+
       bool setupComplete;
       try {
         setupComplete = await NativeBridge.isBootstrapComplete();