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。若區段篩選器略過這三者，則不會顯示閘道模式提示，而是直接進入所要求的設定。選擇遠端閘道模式後，系統會寫入遠端設定並立即結束；不會執行安裝外掛等僅限本機的步驟。

模型區段

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

Web 區段

openclaw configure --section web 會選擇網頁搜尋供應商並設定其認證資訊。部分供應商會顯示該供應商專屬的後續步驟：

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

其他注意事項

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

相關內容

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