CLI commands

Konfigurieren

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.

Optionen

--section <section>: wiederholbarer Abschnittsfilter. Verfügbare Abschnitte:

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

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

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.

Modellabschnitt

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

Was this useful?
On this page

On this page