openclaw configure

透過互動式提示，針對現有設定進行特定變更：憑證、裝置、代理程式預設值、閘道、頻道、外掛、Skills 與健康狀態檢查。

完整的首次執行引導流程請使用 openclaw onboard 或 openclaw setup；若只需建立基準設定／工作區，請使用 openclaw setup --baseline；若只需設定頻道帳號，請使用 openclaw channels add。

選項

--section <section>：可重複指定的區段篩選器。可用區段如下：

workspace、model、web、gateway、daemon、channels、plugins、skills、health

openclaw configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

選取 gateway、daemon 或 health（或未指定 --section 而執行完整精靈）時，系統會提示閘道的執行位置，並更新 gateway.mode。若區段篩選器略過這三個區段，則會直接進入要求的設定流程，不顯示閘道模式提示。選擇遠端閘道模式後，系統會寫入遠端設定並立即結束；不會執行外掛安裝等僅限本機的步驟。

模型區段

當設定流程從供應商驗證選項開始時，預設模型與允許清單選擇器會自動優先顯示該供應商。對於 Volcengine 和 BytePlus 等成對供應商，相同的偏好也會比對其程式設計方案變體（volcengine-plan/*、byteplus-plan/*）。若偏好供應商篩選器會產生空白清單，設定流程會改用未篩選的目錄，而不會顯示空白選擇器。

網頁區段

openclaw configure --section web 會選取網頁搜尋供應商並設定其憑證。部分供應商會顯示供應商專屬的後續選項：

• Grok 可使用相同的 xAI OAuth 設定檔或 API 金鑰提供選用的 x_search 設定，並讓你選擇 x_search 模型。
• Kimi 可詢問 Moonshot API 區域（api.moonshot.ai 或 api.moonshot.cn）以及預設的 Kimi 網頁搜尋模型。

其他注意事項

• 寫入本機設定後，若所選設定路徑需要可下載的外掛，設定流程會安裝選取的外掛。遠端閘道設定不會安裝本機外掛套件。
• 以頻道為導向的服務（Slack／Discord／Matrix／Microsoft Teams）會在設定期間提示輸入頻道／聊天室允許清單。你可以輸入名稱或 ID；精靈會在可能的情況下將名稱解析為 ID。
• 若執行常駐程式安裝步驟，權杖驗證必須提供權杖。若 gateway.auth.token 由 SecretRef 管理，設定流程會驗證 SecretRef，但不會將解析後的明文權杖值保存至監督程式服務的環境中繼資料；若 SecretRef 無法解析，設定流程會阻止安裝常駐程式，並提供可採取行動的修正指引。
• 若已同時設定 gateway.auth.token 與 gateway.auth.password，但未設定 gateway.auth.mode，設定流程會阻止安裝常駐程式，直到你明確設定模式為止。

相關內容

• 命令列介面參考
• 設定
• 設定命令列介面：設定