設定

​

openclaw setup

openclaw setup 是系統代理程式的進入點。在已設定的系統上，直接執行 openclaw setup 會開啟互動式 OpenClaw 聊天。在全新的系統上，它會 轉而進入引導式初始設定。使用 -m/--message 執行單一要求，或使用 --baseline 在不啟動精靈的情況下初始化設定／工作區資料夾。

路由順序：

1. 任何初始設定選項（--wizard、--baseline、工作區、重設、 非互動式、流程、模式、閘道、常駐程式、略過、匯入、遠端或驗證 選項）都會完全依照 openclaw onboard 的方式執行初始設定。
2. -m/--message 或 --yes 會執行系統代理程式。
3. 若未提供路由選項，已設定的互動式系統會開啟 OpenClaw。全新的 系統則會執行初始設定。在已設定的系統上，即使沒有 TTY，--json 仍會輸出 系統概覽；若提供初始設定選項，則會保留初始設定的 JSON 摘要。

在引導模式中，--workspace <dir> 是向 OpenClaw 提議的工作區； 只有在你核准該提議後才會保存。基準、傳統和 非互動式設定會在全新安裝時，透過各自的正常流程保存所提供的工作區。 當現有的代理程式名冊將被重新對應時， 傳統精靈會要求明確確認；非互動式設定則會保留 目前的代理程式群工作區，並輸出警告。

引導式推論偵測會在 macOS 或 Linux 的閘道主機上執行。命令列介面 和 macOS 應用程式會呼叫由同一個閘道擁有的偵測器，該偵測器會檢查已設定的 模型、支援的命令列介面登入、API 金鑰環境變數，以及已 安裝的 Ollama 或 LM Studio 模型。這個自動程序絕不會下載本機模型。 系統會在命令列介面和 API 金鑰候選項目之後，自動測試偵測到的本機執行環境； 若有多個本機模型可用，OpenClaw 會優先選擇 工具呼叫能力最強的指令微調模型系列。所選候選項目必須能回應一次 真實的補全要求，系統才會儲存其供應商和模型設定。 如果已安裝的 Gemini、Antigravity、Pi 和 OpenCode 命令列介面 無法作為引導式設定可重複使用的推論路由，系統也會回報它們。

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）。傳入 --tui 可使用與 openclaw onboard --tui 相同的終端替代入口。完整旗標參考與 非互動式範例請參閱初始設定和 命令列介面自動化。openclaw onboard --modern 仍是同一個 受推論能力檢查限制之 OpenClaw 助理的相容性進入點。

openclaw setup 適用於設定可變更的安裝。在 Nix 模式（OPENCLAW_NIX_MODE=1）中，OpenClaw 會拒絕寫入設定，因為設定檔由 Nix 管理。請使用第一方的 nix-openclaw 快速入門，或其他 Nix 套件的等效原始碼設定。

​

選項

旗標	說明
-m, --message <text>	執行一個 OpenClaw 要求。
--yes	核准一次 --message 要求所需的永久設定寫入。
--workspace <dir>	工作區提議；現有代理程式群需要傳統模式確認，非互動式執行時則予以保留。
--baseline	在不執行初始設定的情況下，建立基準設定／工作區／工作階段資料夾。
--wizard	強制執行互動式初始設定。
--tui	使用終端替代入口，而非瀏覽器轉交流程。
--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	已設定的系統：OpenClaw 概覽。初始設定路由：初始設定摘要。

--classic 和 --non-interactive 互斥：傳統模式會開啟 顯示提示的精靈，而非互動式設定則使用自動化路徑。 在互動式初始設定中，--remote-url 和 --remote-token 會預先填入 遠端閘道步驟，且在該次執行中優先於已儲存的遠端值。 除非你也傳入權杖，否則變更 URL 不會重複使用已儲存的認證資訊。 權杖會持續以遮蔽方式顯示，並使用精靈所選的純文字或 SecretRef 儲存模式。

​

基準模式

openclaw setup --baseline 會保留舊版僅限基準的行為：它會 建立設定、工作區和工作階段目錄，然後直接結束而不 執行初始設定。它接受 --workspace 和不影響行為的輸出控制選項，但會 拒絕明確指定的初始設定、閘道、驗證、重設或常駐程式選項，而不是 默默忽略它們。如果現有設定無效，基準設定會保留 該設定，並要求你先執行 openclaw doctor 再重試。

​

範例

openclaw setup
openclaw setup -m "status"
openclaw setup -m "restart gateway" --yes
openclaw setup --json
openclaw setup --wizard
openclaw setup --baseline
openclaw setup --workspace ~/.openclaw/workspace
openclaw setup --import-from hermes --import-source ~/.hermes
openclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>

​

注意事項

• 完成基準設定後，請執行 openclaw onboard 以進行完整的引導流程、執行 openclaw configure 以進行特定變更，或執行 openclaw channels add 以新增頻道帳號。
• 如果偵測到 Hermes 狀態，互動式初始設定可以自動提供遷移選項。匯入式初始設定需要全新的設定；若要在初始設定之外取得試執行計畫、備份和覆寫模式，請使用遷移。

​

相關內容

• 命令列介面參考
• 初始設定
• 初始設定（命令列介面）
• 開始使用
• 安裝概覽