Skip to main content

​
openclaw configure

Interaktive Eingabeaufforderungen für gezielte Änderungen an einer bestehenden Einrichtung: Anmeldedaten, Geräte, Agent-Standardwerte, Gateway, Kanäle, Plugins, Skills und Integritätsprüfungen. Verwenden Sie openclaw onboard oder openclaw setup für die vollständige geführte Ersteinrichtung, openclaw setup --baseline nur für die Basiskonfiguration und den Workspace sowie openclaw channels add, wenn Sie lediglich ein Kanalkonto einrichten müssen.
openclaw config ohne Unterbefehl öffnet denselben Assistenten. Verwenden Sie openclaw config get|set|unset für nicht interaktive Änderungen.

​
Optionen

--section <section>: wiederholbarer Abschnittsfilter. Verfügbare Abschnitte: workspace, model, web, gateway, daemon, channels, plugins, skills, health
Bei Auswahl von gateway, daemon oder health (oder beim Ausführen des vollständigen Assistenten ohne --section) wird abgefragt, wo das Gateway ausgeführt wird, und gateway.mode aktualisiert. Abschnittsfilter, die alle drei überspringen, führen ohne Abfrage des Gateway-Modus direkt zur angeforderten Einrichtung. Bei Auswahl des Remote-Gateway-Modus wird die Remote-Konfiguration geschrieben und der Vorgang sofort beendet; ausschließlich lokale Schritte wie Plugin-Installationen werden nicht ausgeführt.
openclaw configure erfordert ein interaktives Terminal (sowohl stdin als auch stdout müssen TTYs sein). Ohne ein solches Terminal gibt der Befehl die entsprechenden nicht interaktiven openclaw config get|set|patch|validate-Befehle aus und wird mit einem Fehler beendet, statt nur teilweise ausgeführt zu werden.

​
Modellabschnitt

Modell enthält eine Mehrfachauswahl für die explizite Liste agents.defaults.modelPolicy.allow (die in /model und der Modellauswahl angezeigt wird). Provider-spezifische Einrichtungsoptionen führen die ausgewählten Modelle mit der bestehenden Liste zusammen, anstatt bereits in der Konfiguration vorhandene, nicht betroffene Provider zu ersetzen. Modellspezifische Aliasse und Parameter verbleiben unter agents.defaults.models; diese Einträge schränken Modellüberschreibungen nicht von sich aus ein.Bei erneuter Ausführung der Provider-Authentifizierung über „configure“ bleibt ein vorhandener Wert für agents.defaults.model.primary erhalten, selbst wenn der Authentifizierungsschritt des Providers einen Konfigurations-Patch mit einem eigenen empfohlenen Standardmodell zurückgibt. Durch das Hinzufügen oder erneute Authentifizieren eines Providers werden dessen Modelle verfügbar, ohne Ihr aktuelles primäres Modell zu übernehmen. Verwenden Sie openclaw models auth login --provider <id> --set-default oder openclaw models set <model>, um das Standardmodell bewusst zu ändern.
Wenn „configure“ über eine Provider-Authentifizierungsoption gestartet wird, bevorzugen die Auswahldialoge für Standardmodell und Modellrichtlinie automatisch diesen Provider. Bei gekoppelten Providern wie Volcengine und BytePlus gilt dieselbe Präferenz auch für deren Coding-Plan-Varianten (volcengine-plan/*, byteplus-plan/*). Falls der Filter für den bevorzugten Provider eine leere Liste ergeben würde, greift „configure“ auf den ungefilterten Katalog zurück, statt eine leere Auswahl anzuzeigen.

​
Webabschnitt

openclaw configure --section web wählt einen Provider für die Websuche aus und konfiguriert dessen Anmeldedaten. Einige Provider zeigen Provider-spezifische Folgeoptionen an:
  • Grok kann optional die Einrichtung von x_search mit demselben xAI-OAuth-Profil oder API-Schlüssel anbieten und die Auswahl eines x_search-Modells ermöglichen.
  • Kimi kann nach der Moonshot-API-Region (api.moonshot.ai oder api.moonshot.cn) und dem standardmäßigen Kimi-Modell für die Websuche fragen.

​
Weitere Hinweise

  • Nach dem Schreiben der lokalen Konfiguration installiert „configure“ die ausgewählten herunterladbaren Plugins, wenn der gewählte Einrichtungsablauf diese erfordert. Bei einer Remote-Gateway-Konfiguration werden keine lokalen Plugin-Pakete installiert.
  • Bei kanalorientierten Diensten (Slack/Discord/Matrix/Microsoft Teams) werden während der Einrichtung Positivlisten für Kanäle bzw. Räume abgefragt. Sie können Namen oder IDs eingeben; der Assistent löst Namen nach Möglichkeit in IDs auf.
  • Wenn Sie den Schritt zur Daemon-Installation ausführen, ist für die Token-Authentifizierung ein Token erforderlich. Wenn gateway.auth.token über SecretRef verwaltet wird, validiert „configure“ die SecretRef, speichert jedoch keine aufgelösten Klartext-Tokenwerte in den Umgebungsmetadaten des Supervisor-Dienstes. Wenn die SecretRef nicht aufgelöst werden kann, blockiert „configure“ die Daemon-Installation und gibt konkrete Hinweise zur Behebung aus.
  • Wenn sowohl gateway.auth.token als auch gateway.auth.password konfiguriert sind und gateway.auth.mode nicht festgelegt ist, blockiert „configure“ die Daemon-Installation, bis Sie den Modus ausdrücklich festlegen.

​
Verwandte Themen