From f6128a76936457c7ba9342affdb53609e3b9c56f Mon Sep 17 00:00:00 2001
From: Ryan Weng <14496969+ryan4559@users.noreply.github.com>
Date: Fri, 30 Jan 2026 16:06:39 +0800
Subject: [PATCH] docs: clarify how to open VNC if it does not start
 automatically

---
 docs/platforms/macos-vm.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

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.
 
 ---