​

openclaw config

• --section <section>: openclaw config komutunu alt komut olmadan çalıştırdığınızda tekrarlanabilir rehberli kurulum bölüm filtresi

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

​

Örnekler

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

• Geçerli kök config şeması ve editör araçları için kök $schema dize alanı
• Control UI tarafından kullanılan alan title ve description belge meta verisi
• Eşleşen alan belgeleri mevcut olduğunda iç içe nesne, joker (*) ve dizi öğesi ([]) düğümleri aynı title / description meta verisini devralır
• Eşleşen alan belgeleri mevcut olduğunda anyOf / oneOf / allOf dalları da aynı belge meta verisini devralır
• Çalışma zamanı manifestleri yüklenebildiğinde en iyi çabayla canlı plugin + kanal şema meta verisi
• Geçerli config geçersiz olduğunda bile temiz bir geri dönüş şeması

• config.schema.lookup, tek bir normalize edilmiş config yolu ile sığ bir şema düğümü (title, description, type, enum, const, yaygın sınırlar), eşleşen UI ipucu meta verisi ve doğrudan alt öğe özetlerini döndürür. Bunu path kapsamlı derinlemesine inceleme için Control UI veya özel istemcilerde kullanın.

openclaw config schema

openclaw config schema > openclaw.schema.json

​

Yollar

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

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

​

Değerler

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 kipleri

1. Değer kipi: openclaw config set <path> <value>
2. SecretRef oluşturucu kipi:

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

3. Sağlayıcı oluşturucu kipi (yalnızca secrets.providers.<alias> yolu):

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

4. Toplu kip (--batch-json veya --batch-file):

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

• Desteklenmeyen çalışma zamanı değiştirilebilir yüzeylerde SecretRef atamaları reddedilir (örneğin hooks.token, commands.ownerDisplaySecret, Discord iş parçacığı bağlama webhook token’ları ve WhatsApp creds JSON). Bkz. SecretRef Kimlik Bilgisi Yüzeyi.

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

​

Sağlayıcı Oluşturucu Bayrakları

• --provider-source <env|file|exec>
• --provider-timeout-ms <ms> (file, exec)

• --provider-allowlist <ENV_VAR> (tekrarlanabilir)

• --provider-path <path> (zorunlu)
• --provider-mode <singleValue|json>
• --provider-max-bytes <bytes>

• --provider-command <path> (zorunlu)
• --provider-arg <arg> (tekrarlanabilir)
• --provider-no-output-timeout-ms <ms>
• --provider-max-output-bytes <bytes>
• --provider-json-only
• --provider-env <KEY=VALUE> (tekrarlanabilir)
• --provider-pass-env <ENV_VAR> (tekrarlanabilir)
• --provider-trusted-dir <path> (tekrarlanabilir)
• --provider-allow-insecure-path
• --provider-allow-symlink-command

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

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

• Oluşturucu kipi: değişen ref/sağlayıcılar için SecretRef çözümlenebilirlik denetimlerini çalıştırır.
• JSON kipi (--strict-json, --json veya toplu kip): şema doğrulamasını ve SecretRef çözümlenebilirlik denetimlerini çalıştırır.
• Bilinen desteklenmeyen SecretRef hedef yüzeyleri için ilke doğrulaması da çalışır.
• İlke denetimleri tam değişiklik sonrası config’i değerlendirir; bu nedenle üst nesne yazımları (örneğin hooks’u nesne olarak ayarlama) desteklenmeyen yüzey doğrulamasını atlatamaz.
• Exec SecretRef denetimleri, komut yan etkilerinden kaçınmak için dry-run sırasında varsayılan olarak atlanır.
• Exec SecretRef denetimlerine isteğe bağlı katılmak için --dry-run ile birlikte --allow-exec kullanın (bu, sağlayıcı komutlarını çalıştırabilir).
• --allow-exec yalnızca dry-run içindir ve --dry-run olmadan kullanılırsa hata verir.

• ok: dry-run başarılı mı
• operations: değerlendirilen atama sayısı
• checks: şema/çözümlenebilirlik denetimlerinin çalışıp çalışmadığı
• checks.resolvabilityComplete: çözümlenebilirlik denetimlerinin tamamlanıp tamamlanmadığı (exec ref’leri atlandığında false olur)
• refsChecked: dry-run sırasında gerçekten çözümlenen ref sayısı
• skippedExecRefs: --allow-exec ayarlanmadığı için atlanan exec ref sayısı
• errors: ok=false olduğunda yapılandırılmış şema/çözümlenebilirlik hataları

​

JSON Çıktı Şekli

{
  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, // çözümlenebilirlik hataları için bulunur
    },
  ],
}

{
  "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"
    }
  ]
}

• config schema validation failed: değişiklik sonrası config şekliniz geçersiz; yol/değer veya sağlayıcı/ref nesne şeklini düzeltin.
• Config policy validation failed: unsupported SecretRef usage: bu kimlik bilgisini tekrar düz metin/dize girdisine taşıyın ve SecretRef’leri yalnızca desteklenen yüzeylerde tutun.
• SecretRef assignment(s) could not be resolved: başvurulan sağlayıcı/ref şu anda çözümlenemiyor (eksik ortam değişkeni, geçersiz dosya işaretçisi, exec sağlayıcısı hatası veya sağlayıcı/kaynak uyumsuzluğu).
• Dry run note: skipped <n> exec SecretRef resolvability check(s): dry-run exec ref’lerini atladı; exec çözümlenebilirlik doğrulamasına ihtiyacınız varsa --allow-exec ile yeniden çalıştırın.
• Toplu kipte, başarısız girdileri düzeltin ve yazmadan önce --dry-run komutunu yeniden çalıştırın.

​

Alt komutlar

• config file: Etkin config dosyası yolunu yazdırır (OPENCLAW_CONFIG_PATH veya varsayılan konumdan çözümlenir).

​

Doğrulama

openclaw config validate
openclaw config validate --json