CLI commands

設定

openclaw configure

用於對現有設定進行目標式變更的互動式提示:認證資料、裝置、代理預設值、閘道、頻道、外掛、Skills,以及健康檢查。

使用 openclaw onboardopenclaw setup 進行完整引導式首次執行流程,使用 openclaw setup --baseline 只建立基準設定/工作區,當你只需要設定頻道帳號時則使用 openclaw channels add

當 configure 從提供者驗證選項啟動時,預設模型和允許清單選擇器會自動偏好該提供者。對於 Volcengine 和 BytePlus 這類配對提供者,同樣的偏好也會匹配其編碼方案變體(volcengine-plan/*byteplus-plan/*)。如果偏好提供者篩選會產生空清單,configure 會改為退回未篩選的目錄,而不是顯示空白選擇器。

對於網頁搜尋,openclaw configure --section web 可讓你選擇提供者 並設定其認證資料。有些提供者也會顯示提供者專屬的 後續提示:

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

相關:

  • 閘道設定參考:設定
  • 設定命令列介面:設定

選項

  • --section <section>:可重複的區段篩選器

可用區段:

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

備註:

  • 完整精靈和閘道相關區段會詢問閘道在哪裡執行,並更新 gateway.mode。不包含 gatewaydaemonhealth 的區段篩選器會直接進入要求的設定。
  • 寫入本機設定後,當所選設定路徑需要時,configure 會安裝選取的可下載外掛。遠端閘道設定不會安裝本機外掛套件。
  • 面向頻道的服務(Slack/Discord/Matrix/Microsoft Teams)會在設定期間提示輸入頻道/聊天室允許清單。你可以輸入名稱或 ID;精靈會在可能時將名稱解析為 ID。
  • 如果你執行 daemon 安裝步驟、權杖驗證需要權杖,且 gateway.auth.token 由 SecretRef 管理,configure 會驗證 SecretRef,但不會將解析後的明文權杖值保存到 supervisor 服務環境中繼資料。
  • 如果權杖驗證需要權杖,而已設定的權杖 SecretRef 無法解析,configure 會封鎖 daemon 安裝,並提供可操作的修復指引。
  • 如果同時設定了 gateway.auth.tokengateway.auth.password,且 gateway.auth.mode 未設定,configure 會封鎖 daemon 安裝,直到明確設定模式為止。

範例

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

相關

Was this useful?
On this page

On this page