CLI commands

Yapılandırma

OmeniaClaw.json içinde etkileşimsiz düzenlemeler için config yardımcıları: path üzerinden değerleri get/set/patch/unset/file/schema/validate yapar ve etkin config dosyasını yazdırır. Yapılandırma sihirbazını açmak için alt komut olmadan çalıştırın (OmeniaClaw configure ile aynı).

Kök seçenekler

OmeniaClaw_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tc2VjdGlvbiA8c2VjdGlvbg " type="string"> OmeniaClaw config komutunu alt komut olmadan çalıştırdığınızda yinelenebilir kılavuzlu kurulum bölümü filtresi.

Desteklenen kılavuzlu bölümler: workspace, model, web, gateway, daemon, channels, plugins, skills, health.

Örnekler

bash

OmeniaClaw config fileOmeniaClaw config --section modelOmeniaClaw config --section gateway --section daemonOmeniaClaw config schemaOmeniaClaw config get browser.executablePathOmeniaClaw config set browser.executablePath "/usr/bin/google-chrome"OmeniaClaw config set browser.profiles.work.executablePath "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"OmeniaClaw config set agents.defaults.heartbeat.every "2h"OmeniaClaw config set agents.list[0].tools.exec.node "node-id-or-name"OmeniaClaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --mergeOmeniaClaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKENOmeniaClaw config set secrets.providers.vaultfile --provider-source file --provider-path /etc/OmeniaClaw/secrets.json --provider-mode jsonOmeniaClaw config patch --file ./OmeniaClaw.patch.json5 --dry-runOmeniaClaw config unset plugins.entries.brave.config.webSearch.apiKeyOmeniaClaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN --dry-runOmeniaClaw config validateOmeniaClaw config validate --json

`config schema`

OmeniaClaw.json için oluşturulan JSON şemasını JSON olarak stdout’a yazdırır.

What it includes

Geçerli kök config şeması ve düzenleyici araçları için kök $schema string alanı.
Control UI tarafından kullanılan alan title ve description dokümantasyon metaverisi.
İç içe object, wildcard (*) ve array-item ([]) düğümleri, eşleşen alan dokümantasyonu varsa aynı title / description metaverisini devralır.
anyOf / oneOf / allOf dalları da eşleşen alan dokümantasyonu varsa aynı dokümantasyon metaverisini devralır.
Runtime manifestleri yüklenebildiğinde en iyi çaba ile canlı Plugin + kanal şema metaverisi.
Geçerli config geçersiz olduğunda bile temiz bir fallback şeması.

Related runtime RPC

config.schema.lookup, sığ bir şema düğümü (title, description, type, enum, const, ortak sınırlar), eşleşen UI ipucu metaverisi ve doğrudan alt özetlerle normalleştirilmiş tek bir config path döndürür. Control UI veya özel istemcilerde path kapsamlı ayrıntı incelemesi için kullanın.

bash

OmeniaClaw config schema

Başka araçlarla incelemek veya doğrulamak istediğinizde bir dosyaya pipe edin:

bash

OmeniaClaw config schema > OmeniaClaw.schema.json

Path’ler

Path’ler nokta veya köşeli parantez gösterimi kullanır:

bash

OmeniaClaw config get agents.defaults.workspaceOmeniaClaw config get agents.list[0].id

Belirli bir agent’ı hedeflemek için agent liste indeksini kullanın:

bash

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

Değerler

Değerler mümkün olduğunda JSON5 olarak ayrıştırılır; aksi takdirde string olarak ele alınır. JSON5 ayrıştırmasını zorunlu kılmak için --strict-json kullanın. --json, eski alias olarak desteklenmeye devam eder.

bash

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

config get <path> --json, ham değeri terminal biçimli metin yerine JSON olarak yazdırır.

Bu map’lere girdi eklerken --merge kullanın:

bash

OmeniaClaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --mergeOmeniaClaw config set models.providers.ollama.models '[{"id":"llama3.2","name":"Llama 3.2"}]' --strict-json --merge

--replace yalnızca verilen değerin eksiksiz hedef değer olmasını bilerek istediğinizde kullanın.

`config set` modları

OmeniaClaw config set dört atama stilini destekler:

Value mode

bash

OmeniaClaw config set <path> <value>

SecretRef builder mode

bash

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

Provider builder mode

Provider oluşturucu modu yalnızca secrets.providers.<alias> path’lerini hedefler:

bash

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

Batch mode

bash

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

bash

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

Batch ayrıştırma her zaman doğruluk kaynağı olarak batch payload’ını (--batch-json/--batch-file) kullanır. --strict-json / --json, batch ayrıştırma davranışını değiştirmez.

`config patch`

Path tabanlı çok sayıda config set komutu çalıştırmak yerine config biçimli bir patch yapıştırmak veya pipe etmek istediğinizde config patch kullanın. Girdi bir JSON5 object’tir. Object’ler özyinelemeli olarak merge edilir, array’ler ve skaler değerler hedef değerin yerini alır, null hedef path’i siler.

bash

OmeniaClaw config patch --file ./OmeniaClaw.patch.json5 --dry-runOmeniaClaw config patch --file ./OmeniaClaw.patch.json5

Uzak kurulum script’leri için kullanışlı olan stdin üzerinden de patch pipe edebilirsiniz:

bash

ssh OmeniaClaw-host 'OmeniaClaw config patch --stdin --dry-run' < ./OmeniaClaw.patch.json5ssh OmeniaClaw-host 'OmeniaClaw config patch --stdin' < ./OmeniaClaw.patch.json5

Örnek patch:

json5

{  channels: {    slack: {      enabled: true,      mode: "socket",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      groupPolicy: "open",      requireMention: false,    },    discord: {      enabled: true,      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },      dmPolicy: "disabled",      dm: { enabled: false },      groupPolicy: "allowlist",    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },      models: {        "openai/gpt-5.5": { params: { fastMode: true } },      },    },  },}

Bir object veya array özyinelemeli olarak patch edilmek yerine tam olarak verilen değer olmalıysa --replace-path <path> kullanın:

bash

OmeniaClaw config patch --file ./discord.patch.json5 --replace-path 'channels.discord.guilds["123"].channels'

--dry-run, yazmadan şema ve SecretRef çözümlenebilirlik kontrollerini çalıştırır. Exec destekli SecretRef’ler dry-run sırasında varsayılan olarak atlanır; dry-run’ın provider komutlarını yürütmesini bilerek istiyorsanız --allow-exec ekleyin.

JSON path/değer modu hem SecretRef’ler hem provider’lar için desteklenmeye devam eder:

bash

OmeniaClaw config set channels.discord.token \  '{"source":"env","provider":"default","id":"DISCORD_BOT_TOKEN"}' \  --strict-json OmeniaClaw config set secrets.providers.vaultfile \  '{"source":"file","path":"/etc/OmeniaClaw/secrets.json","mode":"json"}' \  --strict-json

Provider oluşturucu flag’leri

Provider oluşturucu hedefleri path olarak secrets.providers.<alias> kullanmalıdır.

Common flags

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

Env provider (--provider-source env)

--provider-allowlist <ENV_VAR> (yinelenebilir)

File provider (--provider-source file)

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

Exec provider (--provider-source exec)

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

Sertleştirilmiş exec provider örneği:

bash

OmeniaClaw config set secrets.providers.vault \  --provider-source exec \  --provider-command /usr/local/bin/OmeniaClaw-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

OmeniaClaw.json yazmadan değişiklikleri doğrulamak için --dry-run kullanın.

bash

OmeniaClaw config set channels.discord.token \  --ref-provider default \  --ref-source env \  --ref-id DISCORD_BOT_TOKEN \  --dry-run OmeniaClaw config set channels.discord.token \  --ref-provider default \  --ref-source env \  --ref-id DISCORD_BOT_TOKEN \  --dry-run \  --json OmeniaClaw config set channels.discord.token \  --ref-provider vault \  --ref-source exec \  --ref-id discord/token \  --dry-run \  --allow-exec

Dry-run behavior

Oluşturucu modu: değişen ref’ler/provider’lar için SecretRef çözümlenebilirlik kontrollerini çalıştırır.
JSON modu (--strict-json, --json veya batch modu): şema doğrulamasını ve SecretRef çözümlenebilirlik kontrollerini çalıştırır.
Bilinen desteklenmeyen SecretRef hedef yüzeyleri için ilke doğrulaması da çalışır.
İlke kontrolleri değişiklik sonrası config’in tamamını değerlendirir, bu nedenle üst object yazmaları (örneğin hooks değerini object olarak ayarlamak) desteklenmeyen yüzey doğrulamasını atlayamaz.
Exec SecretRef kontrolleri komut yan etkilerini önlemek için dry-run sırasında varsayılan olarak atlanır.
Exec SecretRef kontrollerine dahil olmak için --dry-run ile --allow-exec kullanın (bu provider komutlarını yürütebilir).
--allow-exec yalnızca dry-run içindir ve --dry-run olmadan kullanılırsa hata verir.

--dry-run --json fields

--dry-run --json, makine tarafından okunabilir bir rapor yazdırır:

ok: dry-run'ın geçip geçmediği
operations: değerlendirilen atama sayısı
checks: şema/çözülebilirlik kontrollerinin çalışıp çalışmadığı
checks.resolvabilityComplete: çözülebilirlik kontrollerinin tamamlanana kadar çalışıp çalışmadığı (exec referansları atlandığında false)
refsChecked: dry-run sırasında gerçekten çözümlenen referans sayısı
skippedExecRefs: --allow-exec ayarlanmadığı için atlanan exec referans sayısı
errors: ok=false olduğunda yapılandırılmış şema/çözülebilirlik hataları

JSON çıktı biçimi

json5

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

Başarı örneği

json

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

Hata örneği

json

{  "ok": false,  "operations": 1,  "configPath": "~/.OmeniaClaw/OmeniaClaw.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"    }  ]}

Dry-run başarısız olursa

config schema validation failed: değişiklik sonrası yapılandırma biçiminiz geçersiz; yolu/değeri veya sağlayıcı/ref nesnesi biçimini düzeltin.
Config policy validation failed: unsupported SecretRef usage: bu kimlik bilgisini yeniden 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ülemiyor (eksik env 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ülebilirlik doğrulamasına ihtiyacınız varsa --allow-exec ile yeniden çalıştırın.
Toplu mod için, başarısız girdileri düzeltin ve yazmadan önce --dry-run'ı yeniden çalıştırın.

Yazma güvenliği

OmeniaClaw config set ve OmeniaClaw'a ait diğer yapılandırma yazıcıları, diske kaydetmeden önce değişiklik sonrası tam yapılandırmayı doğrular. Yeni yük şema doğrulamasından geçmezse veya yıkıcı bir üzerine yazma gibi görünürse, aktif yapılandırmaya dokunulmaz ve reddedilen yük yanına OmeniaClaw.json.rejected.* olarak kaydedilir.

Küçük düzenlemeler için CLI yazmalarını tercih edin:

bash

OmeniaClaw config set gateway.reload.mode hybrid --dry-runOmeniaClaw config set gateway.reload.mode hybridOmeniaClaw config validate

Bir yazma reddedilirse, kaydedilen yükü inceleyin ve tam yapılandırma biçimini düzeltin:

bash

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

Doğrudan düzenleyiciyle yazmalara hâlâ izin verilir, ancak çalışan Gateway bunları doğrulanana kadar güvenilmeyen olarak ele alır. Geçersiz doğrudan düzenlemeler başlangıcı başarısız kılar veya hot reload tarafından atlanır; Gateway OmeniaClaw.json dosyasını yeniden yazmaz. Öneklenmiş/üzerine yazılmış yapılandırmayı onarmak veya bilinen son iyi kopyayı geri yüklemek için OmeniaClaw doctor --fix çalıştırın. Bkz. Gateway sorun giderme.

Tüm dosya kurtarma yalnızca doctor onarımı için ayrılmıştır. Plugin şeması değişiklikleri veya minHostVersion uyumsuzluğu, modeller, sağlayıcılar, auth profilleri, kanallar, Gateway açığa çıkarma, araçlar, bellek, tarayıcı veya Cron yapılandırması gibi ilgisiz kullanıcı ayarlarını geri almak yerine görünür kalır.

Alt komutlar

config file: Aktif yapılandırma dosyası yolunu yazdırır (OmeniaClaw_CONFIG_PATH veya varsayılan konumdan çözümlenir). Yol bir sembolik bağlantıyı değil, normal bir dosyayı adlandırmalıdır.

Düzenlemelerden sonra Gateway'i yeniden başlatın.

Doğrulama

Gateway'i başlatmadan mevcut yapılandırmayı aktif şemaya göre doğrulayın.

bash

OmeniaClaw config validateOmeniaClaw config validate --json

OmeniaClaw config validate geçtikten sonra, aynı terminalden her değişikliği doğrularken gömülü bir ajanın aktif yapılandırmayı dokümanlarla karşılaştırması için yerel TUI'yi kullanabilirsiniz:

bash

OmeniaClaw chat

Ardından TUI içinde:

text

!OmeniaClaw config file!OmeniaClaw docs gateway auth token secretref!OmeniaClaw config validate!OmeniaClaw doctor

Tipik onarım döngüsü:

Dokümanlarla karşılaştır

Ajanın mevcut yapılandırmanızı ilgili doküman sayfasıyla karşılaştırmasını ve en küçük düzeltmeyi önermesini isteyin.

Hedefli düzenlemeleri uygula

Hedefli düzenlemeleri OmeniaClaw config set veya OmeniaClaw configure ile uygulayın.

Yeniden doğrula

Her değişiklikten sonra OmeniaClaw config validate komutunu yeniden çalıştırın.

Çalışma zamanı sorunları için doctor

Doğrulama geçiyor ancak çalışma zamanı hâlâ sağlıksızsa, geçiş ve onarım yardımı için OmeniaClaw doctor veya OmeniaClaw doctor --fix çalıştırın.

İlgili

Was this useful?

Yapılandırma

Kök seçenekler

Örnekler

`config schema`

Path’ler

Değerler

`config set` modları

Value mode

SecretRef builder mode

Provider builder mode

Batch mode

`config patch`

Provider oluşturucu flag’leri

Dry run

JSON çıktı biçimi

Başarı örneği

Hata örneği

Yazma güvenliği

Alt komutlar

Doğrulama

Dokümanlarla karşılaştır

Hedefli düzenlemeleri uygula

Yeniden doğrula

Çalışma zamanı sorunları için doctor

İlgili

On this page

Molty

Kök seçenekler

Örnekler

config schema

Path’ler

Değerler

config set modları

Value mode

SecretRef builder mode

Provider builder mode

Batch mode

config patch

Provider oluşturucu flag’leri

Dry run

JSON çıktı biçimi

Başarı örneği

Hata örneği

Yazma güvenliği

Alt komutlar

Doğrulama

Dokümanlarla karşılaştır

Hedefli düzenlemeleri uygula

Yeniden doğrula

Çalışma zamanı sorunları için doctor

İlgili

On this page

`config schema`

`config set` modları

`config patch`