diff --git a/docs/platforms/macos-vm.md b/docs/platforms/macos-vm.md
index 258f2e919..4f29c24ac 100644
--- a/docs/platforms/macos-vm.md
+++ b/docs/platforms/macos-vm.md
@@ -89,7 +89,15 @@ lume create openclaw --os macos --ipsw latest
 
 This downloads macOS and creates the VM. A VNC window opens automatically.
 
-Note: The download can take a while depending on your connection.
+**Note:**  
+- The download can take a while depending on your connection.  
+- In some environments, the VNC window may not open automatically after running `lume create`.  
+  If this happens, you can start the VM manually and open the VNC display with:
+  ```bash
+  lume run openclaw
+  ```
+  This will open the VNC window so you can complete the macOS Setup Assistant.  
+  Use `--no-display` if you prefer to run the VM headless.
 
 ---