Skip to main content

​
openclaw configure

針對現有設定進行特定變更的互動式提示：認證資訊、裝置、代理程式預設值、閘道、頻道、外掛、Skills 與健康狀態檢查。 使用 openclaw onboard 或 openclaw setup 進行完整的首次執行引導流程；僅需基準設定／工作區時，請使用 openclaw setup --baseline；只需設定頻道帳號時，請使用 openclaw channels add。
不含子命令的 openclaw config 會開啟相同的精靈。若要進行非互動式編輯，請使用 openclaw config get|set|unset。

​
選項

--section <section>：可重複使用的區段篩選器。可用區段： workspace、model、web、gateway、daemon、channels、plugins、skills、health
選取 gateway、daemon 或 health（或在不含 --section 的情況下執行完整精靈）時，系統會詢問閘道的執行位置，並更新 gateway.mode。若區段篩選器略過這三者，則不會顯示閘道模式提示，而是直接進入所要求的設定。選擇遠端閘道模式後，系統會寫入遠端設定並立即結束；不會執行安裝外掛等僅限本機的步驟。
openclaw configure 需要互動式終端機（stdin 與 stdout 都必須是 TTY）。若沒有互動式終端機，它會列印等效的非互動式 openclaw config get|set|patch|validate 命令並回報錯誤後結束，而不會只執行部分流程。

​
模型區段

模型包含明確 agents.defaults.modelPolicy.allow 清單的多選項目（即 /model 和模型選擇器中顯示的內容）。限定供應商範圍的設定選項會將所選模型合併至現有清單，而不會取代設定中既有的其他無關供應商。各模型的別名與參數仍位於 agents.defaults.models；這些項目本身不會限制模型覆寫。從 configure 重新執行供應商驗證時，會保留現有的 agents.defaults.model.primary，即使供應商的驗證步驟傳回包含其建議預設模型的設定修補亦同。新增供應商或重新驗證供應商，可讓其模型供你使用，但不會取代目前的主要模型。若要刻意變更預設模型，請使用 openclaw models auth login --provider <id> --set-default 或 openclaw models set <model>。
當 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 會阻止安裝常駐程式，直到你明確設定模式為止。

​
相關內容