CLI commands
設定
openclaw setup
openclaw setup 會執行與 openclaw onboard 相同的引導式上手流程：
它會先驗證並保存推論設定，接著啟動 Crestodian，以設定工作區、閘道、頻道、Skills 與健康狀態。若只需初始化設定與工作區資料夾，而不需要精靈，請使用 --baseline。
在引導模式中，--workspace <dir> 是向 Crestodian 提議的工作區；只有在您核准該提議後才會保存。基準、傳統及非互動式設定會透過各自的正常流程保存所提供的工作區。
setup 接受與 openclaw onboard 相同的上手旗標，包括驗證（--auth-choice、--token、供應商金鑰旗標）、閘道（--gateway-port、--gateway-bind、--gateway-auth、--install-daemon）、Tailscale（--tailscale）、重設（--reset、--reset-scope）、流程（--flow quickstart|advanced|manual|import），以及略過旗標（--skip-channels、--skip-skills、--skip-bootstrap、--skip-search、--skip-health、--skip-ui、--skip-hooks）。如需完整的旗標參考與非互動式範例，請參閱上手設定與命令列介面自動化。openclaw onboard --modern 是受推論閘控的 Crestodian 助理之相容性別名，沒有對應的 setup 選項。
選項
| 旗標 | 說明 |
|---|---|
--workspace <dir> |
引導模式中的工作區提議；基準、傳統及非互動式設定會直接保存。 |
--baseline |
不執行上手流程，建立基準設定、工作區與工作階段資料夾。 |
--wizard |
為相容性而接受；設定預設會執行上手流程。 |
--non-interactive |
不顯示提示地執行上手流程。 |
--accept-risk |
確認代理程式具有完整系統存取權的風險；搭配 --non-interactive 時為必要選項。 |
--mode <mode> |
上手模式：local 或 remote。 |
--flow <flow> |
上手流程：quickstart、advanced、manual 或 import。 |
--reset |
在上手前重設設定、憑證與工作階段（僅在使用 --reset-scope full 時重設工作區）。 |
--reset-scope <scope> |
重設範圍：config、config+creds+sessions 或 full。 |
--import-from <provider> |
要在上手期間執行的遷移供應商。 |
--import-source <path> |
--import-from 的來源代理程式主目錄。 |
--import-secrets |
在上手遷移期間匯入支援的密鑰。 |
--remote-url <url> |
遠端閘道 WebSocket URL。 |
--remote-token <token> |
遠端閘道權杖（選用）。 |
--json |
輸出 JSON 摘要。 |
--classic 與 --non-interactive 互斥：傳統模式會開啟含提示的精靈，而非互動式設定則使用自動化路徑。
基準模式
openclaw setup --baseline 會保留較舊的純基準行為：建立設定、工作區與工作階段目錄，然後結束而不執行上手流程。
範例
openclaw setupopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>注意事項
- 完成基準設定後，執行
openclaw setup或openclaw onboard以進行完整的引導流程；執行openclaw configure以進行特定變更；或執行openclaw channels add以新增頻道帳戶。 - 若偵測到 Hermes 狀態，互動式上手流程可以自動提供遷移選項。匯入上手流程需要全新的設定；若要在上手流程之外使用試執行計畫、備份及覆寫模式，請參閱遷移。
