openclaw setup
openclaw setup 會執行與 openclaw onboard
相同的引導式導覽設定流程
（驗證、工作區、閘道、通道、Skills、健康狀態）。當你
只需要初始化設定/工作區資料夾而不需要精靈時，請使用 --baseline。
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 等效項目。
openclaw setup 用於可變設定安裝。在 Nix 模式（OPENCLAW_NIX_MODE=1）中，OpenClaw 會拒絕 setup 寫入，因為設定檔由 Nix 管理。請使用第一方 nix-openclaw 快速入門，或為其他 Nix 套件使用等效的來源設定。選項
| 旗標 | 說明 |
|---|---|
--workspace <dir> | 代理工作區目錄（預設 ~/.openclaw/workspace；儲存為 agents.defaults.workspace）。 |
--baseline | 不進行導覽設定，建立基準設定/工作區/工作階段資料夾。 |
--wizard | 為相容性而接受；setup 預設會執行導覽設定。 |
--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 摘要。 |
基準模式
openclaw setup --baseline 會保留較舊的僅基準行為：它會
建立設定、工作區和工作階段目錄，然後在不執行
導覽設定的情況下結束。
範例
備註
- 基準 setup 後，請執行
openclaw setup或openclaw onboard以完成完整的引導式旅程，執行openclaw configure進行目標式變更，或執行openclaw channels add新增通道帳號。 - 如果偵測到 Hermes 狀態，互動式導覽設定可以自動提供遷移。匯入導覽設定需要全新的 setup；若要在導覽設定之外取得試跑計畫、備份和覆寫模式，請使用遷移。