2026年 OpenClaw 安裝嚮導 onboard 完成後 Dashboard（18789）無法訪問？SSH 埠轉發、openclaw doctor 修復與 launchd 服務恢復的可復現清單 + FAQ
「精靈跑完」只代表互動流程結束；瀏覽器能否開啟 Dashboard，仍取決於本機監聽、綁定位址、防火牆規則，以及——在遠端 Mac 上——你是否已設定埠轉發。請依序完成下列步驟，避免把「SSH 沒轉發」誤判成「服務掛了」。若你正在把 OpenClaw 當成長駐邊緣節點，亦可對照 2026 最佳 CI/CD 升級方案：遠端 Mac mini + AI Agent 自我修復建置集群實戰 中的 SSH 與常駐服務思路。
1. 不是沒在聽，而是進錯門
常見情境：OpenClaw 把 Web UI 綁在 127.0.0.1:18789（或文件預設埠），你在遠端 Mac 上跑完精靈，卻在筆電瀏覽器開 http://127.0.0.1:18789——流量打到筆電本機 loopback，而非那台 Mac，當然空白。先對齊哪張網卡、哪個 loopback真的收到連線，再談修復。
建議在 Runbook 固定寫一組四元組：綁定位址（127.0.0.1／0.0.0.0／區網 IP）、埠（是否改過 18789）、客戶端（本機瀏覽器或 SSH 對側），以及前方是否有 HTTP(S)／反向代理。
2. 在執行 OpenClaw 的機器上：18789 是否在聽？
SSH 到目標 Mac（或在本機終端機）執行：
lsof -nP -iTCP:18789 -sTCP:LISTEN— 有輸出代表行程正在監聽。curl -sS -o /dev/null -w "%{http_code}\n" http://127.0.0.1:18789/— loopback 健康檢查；若本機就失敗，優先查服務崩潰、埠衝突或設定裡改埠。
若只綁在 127.0.0.1，從外網或區網 IP 直連會失敗——這是預期行為。可改綁策略（若產品允許），或改用 SSH 轉發、隧道、反向代理，與「先緊綁、再安全發佈」的基線一致；細部 API／Docker／SSH 強化可延伸閱讀 OpenClaw 穩定運行手冊（API 切換、Docker、SSH 取向強化）。
3. SSH 本機埠轉發：從筆電開啟遠端 127.0.0.1:18789
若已能 SSH 進 OpenClaw 所在主機，在筆電建立轉發（範例將本機 18789 對到遠端 loopback）：
ssh -N -L 18789:127.0.0.1:18789 user@remote-mac-host保持該連線，再在筆電瀏覽器開 http://127.0.0.1:18789。若仍失敗，檢查：SSH 是否連到正確主機、伺服器上 curl http://127.0.0.1:18789 是否成功，以及本機 18789 是否已被佔用（可改 -L 18080:127.0.0.1:18789 後開 http://127.0.0.1:18080）。
4. openclaw doctor：跑完整環境自檢
若沒有任何監聽或行程反覆退出，在安裝了 OpenClaw CLI 的同一環境執行 openclaw doctor（或文件列出的同等指令）。通常會檢查相依、路徑、權限與設定片段並給出可執行修復——適合安裝與精靈剛結束後立刻跑。升級後異常請交叉比對標籤與環境變數，見 2026年 OpenClaw 大版本升級實戰：doctor 修復、Plugin SDK 遷移與 OPENCLAW_* 環境變數對照（遠端 Mac SSH）。
若 doctor 提到 LaunchAgent 路徑、Node 版本或權限，請將輸出（脫敏）存進工單或 Runbook，不要只靠記憶。
5. launchd：用 launchctl 恢復長駐服務
若 Dashboard 依賴背景行程（例如 LaunchAgent／LaunchDaemon），請在 onboard 後確認網域與標籤（Label）——使用者 GUI 工作階段與全系統常駐守護行程語意不同：
launchctl list | grep -i openclaw（或你的 plist Label），留意非零退出碼。- 編輯 plist 後：
launchctl bootout／launchctl bootstrap（依 macOS 版本與網域選對子命令），避免舊 plist 仍留在記憶體。 - 以
log show --predicate 'process == "launchd"' --last 30m或「系統監視程式」查看崩潰（權限、路徑、簽章）。
兩個 Agent 或兩組閘道若埠與設定來源衝突，會出現「隨機」打不開 UI 的假象；請在團隊 Runbook 記錄實際 plist 路徑與監聽埠。更完整的雙 Agent 並行排查可對照站內 OpenClaw macOS 雙 LaunchAgent 並行 FAQ。
6. FAQ
問：精靈給的連結打不開，一定是埠錯了嗎？
答：不一定。先分辨 URL 裡的主機是「你開瀏覽器的這台」還是「遠端 Mac」；若後者卻用 127.0.0.1，就需要 SSH 轉發或其他連線路徑。
問：curl 本機成功，瀏覽器卻不行？
答：檢查 http／https 是否混用、系統 Proxy、或擴充功能封鎖本機位址。
問：能把 18789 暴露在區網嗎？
答：視產品與資安政策；在共享或正式網路，較建議維持 127.0.0.1 加 SSH／隧道／零信任，而非無控管地綁 0.0.0.0。
在 Mac mini 上跑 OpenClaw，最貼合「SSH 可復現」敘事
Dashboard、閘道與背景 Agent 多半需要長開上線、低抖動、可預期的重啟路徑。macOS 搭配 launchd，團隊對 plist 與 launchctl 的運維語彙一致。Apple Silicon Mac mini 通常在同功耗級距內有更好的效能／瓦數比，待機功耗可壓到很低，很適合當家庭或小團隊邊緣節點；原生 Unix 工具鏈也讓 SSH、腳本與健康檢查維持單一路徑。
總擁有成本方面：體積小、運轉安靜、核心堆疊穩定，Gatekeeper、SIP、FileVault 也讓基線強化比一般常開的消費級 Windows 工作站單純。若你希望把本文清單跑在安靜、可靠、長開不吵你的硬體上，Mac mini M4 仍是極具性價比的切入點——現在即可入手，讓 OpenClaw 的 Web 主控台與背景服務真的站得住。
若你希望從首頁直接對照租賃或方案，可 前往 SSHMac 首頁查看 Mac mini 相關方案。