openclaw onboard 指南：快速搞定 Gateway 設定
每次拿到一個新工具，最煩的就是對著幾十頁的說明文件手動修改設定檔。你可能只是想趕快跑起來試試看，卻卡在權限申請或埠號配置。這種重複性的環境搭建工作，往往在還沒看到成果前就耗盡了耐心。
這就是為什麼我們設計了互動式的引導精靈，讓你不需要去背那些繁瑣的參數，直接跟著提示走就能搞定。
需要準備的東西
Section titled “需要準備的東西”在開始之前，請確保你已經準備好：
- 已經安裝
openclaw的終端機環境 - 如果要連接遠端 Gateway，請先準備好對應的 URL
要啟動引導精靈，最直接的方法就是在終端機輸入：
openclaw onboard這會開啟互動模式，帶你完成 Gateway 的設定。根據你的需求，有幾種不同的路徑可以選：
1. 最推薦的快速路徑
Section titled “1. 最推薦的快速路徑”如果你想用最少的操作完成設定，推薦使用 quickstart。它會自動幫你產生 Gateway token，省去手動輸入的麻煩：
openclaw onboard --flow quickstart2. 手動完全控制
Section titled “2. 手動完全控制”如果你需要自定義埠號、綁定位置或身份驗證資訊，請使用 manual 模式（這也是 advanced 模式的別名）：
openclaw onboard --flow manual3. 遠端 Gateway 設定
Section titled “3. 遠端 Gateway 設定”如果你要連線到已經跑在其他伺服器上的 Gateway，可以指定模式與 URL：
openclaw onboard --mode remote --remote-url ws://gateway-host:18789小撇步： 如果你連 Channel 都還不想設定，只想先看看控制介面（Control UI），直接執行 openclaw dashboard 是最快的方式。
在腳本中執行時卡住
Section titled “在腳本中執行時卡住”如果你正在寫自動化腳本，要注意 --json 旗標僅代表輸出格式為 JSON，它並不等於非互動模式。
解決方案：
在腳本中請務必加上 --non-interactive，否則程式會停下來等待使用者輸入：
# 錯誤示範（仍會卡住）openclaw onboard --json
# 正確示範openclaw onboard --non-interactive如果你在設定過程中遇到任何奇怪的問題，可以問問我們的 AI Setup Assistant。
OpenClaw Expert
還是卡住了？
如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。