openclaw config effizient nutzen

Es ist oft frustrierend, wenn manuelle Konfigurationsdateien durch Tippfehler oder falsche Strukturen die gesamte Anwendung lahmlegen. Mit den richtigen Werkzeugen lässt sich die Verwaltung deiner Einstellungen jedoch deutlich effizienter und sicherer gestalten.

Mit OpenClaw config kannst du deine Konfiguration direkt über die CLI verwalten, ohne dich mit der manuellen Bearbeitung der openclaw.json herumschlagen zu müssen. Dieses Tool bietet dir eine einfache Möglichkeit, Werte per Pfad zu setzen, zu lesen oder zu löschen, und sorgt gleichzeitig dafür, dass deine Änderungen immer dem gültigen Schema entsprechen.

Beispiele

Hier sind einige gängige Befehle, um deine Konfiguration effizient zu verwalten.

openclaw config file
openclaw config --section model
openclaw config --section gateway --section daemon
openclaw config schema
openclaw config get browser.executablePath
openclaw config set browser.executablePath "/usr/bin/google-chrome"
openclaw config set agents.defaults.heartbeat.every "2h"
openclaw config set agents.list[0].tools.exec.node "node-id-or-name"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set secrets.providers.vaultfile --provider-source file --provider-path /etc/openclaw/secrets.json --provider-mode json
openclaw config unset plugins.entries.brave.config.webSearch.apiKey
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN --dry-run
openclaw config validate
openclaw config validate --json

config schema

Du kannst dir das generierte JSON-Schema für openclaw.json direkt in der Konsole ausgeben lassen, um es für deine Editor-Tools zu nutzen.

openclaw config schema

Leite die Ausgabe in eine Datei um, wenn du sie mit anderen Tools inspizieren oder validieren möchtest:

openclaw config schema > openclaw.schema.json

Pfade

Pfade werden entweder in Punkt- oder Klammernotation angegeben.

openclaw config get agents.defaults.workspace
openclaw config get agents.list[0].id

Verwende den Index der Agentenliste, um einen spezifischen Agenten anzusprechen.

openclaw config get agents.list
openclaw config set agents.list[1].tools.exec.node "node-id-or-name"

Werte

Werte werden nach Möglichkeit als JSON5 geparst, andernfalls werden sie als einfache Strings behandelt.

openclaw config set agents.defaults.heartbeat.every "0m"
openclaw config set gateway.port 19001 --strict-json
openclaw config set channels.whatsapp.groups '["*"]' --strict-json

config set Modi

openclaw config set unterstützt vier verschiedene Zuweisungsstile für deine Konfiguration.

openclaw config set channels.discord.token \
  --ref-provider default \
  --ref-source env \
  --ref-id DISCORD_BOT_TOKEN

openclaw config set secrets.providers.vault \
  --provider-source exec \
  --provider-command /usr/local/bin/openclaw-vault \
  --provider-arg read \
  --provider-arg openai/api-key \
  --provider-timeout-ms 5000

openclaw config set --batch-json '[
  {
    "path": "secrets.providers.default",
    "provider": { "source": "env" }
  },
  {
    "path": "channels.discord.token",
    "ref": { "source": "env", "provider": "default", "id": "DISCORD_BOT_TOKEN" }
  }
]'

openclaw config set --batch-file ./config-set.batch.json --dry-run

openclaw config set channels.discord.token \
  '{"source":"env","provider":"default","id":"DISCORD_BOT_TOKEN"}' \
  --strict-json

openclaw config set secrets.providers.vaultfile \
  '{"source":"file","path":"/etc/openclaw/secrets.json","mode":"json"}' \
  --strict-json

Provider Builder Flags

Für Provider-Ziele musst du secrets.providers.<alias> als Pfad verwenden.

openclaw config set secrets.providers.vault \
  --provider-source exec \
  --provider-command /usr/local/bin/openclaw-vault \
  --provider-arg read \
  --provider-arg openai/api-key \
  --provider-json-only \
  --provider-pass-env VAULT_TOKEN \
  --provider-trusted-dir /usr/local/bin \
  --provider-timeout-ms 5000

Dry run

Nutze --dry-run, um Änderungen zu validieren, ohne die openclaw.json tatsächlich zu überschreiben.

openclaw config set channels.discord.token \
  --ref-provider default \
  --ref-source env \
  --ref-id DISCORD_BOT_TOKEN \
  --dry-run

openclaw config set channels.discord.token \
  --ref-provider default \
  --ref-source env \
  --ref-id DISCORD_BOT_TOKEN \
  --dry-run \
  --json

openclaw config set channels.discord.token \
  --ref-provider vault \
  --ref-source exec \
  --ref-id discord/token \
  --dry-run \
  --allow-exec

{
  ok: boolean,
  operations: number,
  configPath: string,
  inputModes: ["value" | "json" | "builder", ...],
  checks: {
    schema: boolean,
    resolvability: boolean,
    resolvabilityComplete: boolean,
  },
  refsChecked: number,
  skippedExecRefs: number,
  errors?: [
    {
      kind: "schema" | "resolvability",
      message: string,
      ref?: string, // present for resolvability errors
    },
  ],
}

{
  "ok": true,
  "operations": 1,
  "configPath": "~/.openclaw/openclaw.json",
  "inputModes": ["builder"],
  "checks": {
    "schema": false,
    "resolvability": true,
    "resolvabilityComplete": true
  },
  "refsChecked": 1,
  "skippedExecRefs": 0
}

{
  "ok": false,
  "operations": 1,
  "configPath": "~/.openclaw/openclaw.json",
  "inputModes": ["builder"],
  "checks": {
    "schema": false,
    "resolvability": true,
    "resolvabilityComplete": true
  },
  "refsChecked": 1,
  "skippedExecRefs": 0,
  "errors": [
    {
      "kind": "resolvability",
      "message": "Error: Environment variable \"MISSING_TEST_SECRET\" is not set.",
      "ref": "env:default:MISSING_TEST_SECRET"
    }
  ]
}

Write safety

OpenClaw validiert die Konfiguration vor dem Speichern, um sicherzustellen, dass keine fehlerhaften Daten geschrieben werden.

openclaw config set gateway.reload.mode hybrid --dry-run
openclaw config set gateway.reload.mode hybrid
openclaw config validate

CONFIG="$(openclaw config file)"
ls -lt "$CONFIG".rejected.* 2>/dev/null | head
openclaw config validate

Subcommands

Hier findest du Befehle, um den Status deiner Konfiguration zu prüfen.

openclaw config file

Validate

Überprüfe deine aktuelle Konfiguration gegen das aktive Schema, ohne den Gateway neu zu starten.

openclaw config validate
openclaw config validate --json

---

Nächste Schritte

• Gateway troubleshooting
• SecretRef Credential Surface

Bei weiteren Fragen hilft dir unser AI Setup Assistant gerne weiter.