OmeniaClaw onboard

Yerel veya uzak Gateway kurulumu için tam yönlendirmeli ilk kurulum. OmeniaClaw'ın model kimlik doğrulama, çalışma alanı, Gateway, kanallar, Skills ve sağlığı tek bir akışta adım adım yürütmesini istediğinizde bunu kullanın.

İlgili kılavuzlar

Örnekler

OmeniaClaw onboardOmeniaClaw onboard --modernOmeniaClaw onboard --flow quickstartOmeniaClaw onboard --flow manualOmeniaClaw onboard --flow importOmeniaClaw onboard --import-from hermes --import-source ~/.hermesOmeniaClaw onboard --skip-bootstrapOmeniaClaw onboard --mode remote --remote-url wss://gateway-host:18789

--flow import, Hermes gibi Plugin sahipli geçiş sağlayıcılarını kullanır. Yalnızca yeni bir OmeniaClaw kurulumunda çalışır; mevcut yapılandırma, kimlik bilgileri, oturumlar veya çalışma alanı bellek/kimlik dosyaları varsa içe aktarmadan önce sıfırlayın ya da yeni bir kurulum seçin.

--modern, Crestodian konuşmaya dayalı ilk kurulum önizlemesini başlatır. --modern olmadan, OmeniaClaw onboard klasik ilk kurulum akışını korur.

Düz metin özel ağ ws:// hedefleri için (yalnızca güvenilir ağlar), ilk kurulum süreci ortamında OmeniaClaw_ALLOW_INSECURE_PRIVATE_WS=1 ayarlayın. Bu istemci tarafı taşıma acil durum seçeneği için OmeniaClaw.json eşdeğeri yoktur.

Etkileşimsiz özel sağlayıcı:

OmeniaClaw onboard --non-interactive \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --custom-api-key "$CUSTOM_API_KEY" \  --secret-input-mode plaintext \  --custom-compatibility openai \  --custom-image-input

--custom-api-key, etkileşimsiz modda isteğe bağlıdır. Atlanırsa ilk kurulum CUSTOM_API_KEY değerini denetler. OmeniaClaw, yaygın görme modeli kimliklerini otomatik olarak görüntü yetenekli olarak işaretler. Bilinmeyen özel görme kimlikleri için --custom-image-input iletin veya yalnızca metin meta verisini zorlamak için --custom-text-input kullanın.

LM Studio, etkileşimsiz modda sağlayıcıya özgü bir anahtar bayrağını da destekler:

OmeniaClaw onboard --non-interactive \  --auth-choice lmstudio \  --custom-base-url "http://localhost:1234/v1" \  --custom-model-id "qwen/qwen3.5-9b" \  --lmstudio-api-key "$LM_API_TOKEN" \  --accept-risk

Etkileşimsiz Ollama:

OmeniaClaw onboard --non-interactive \  --auth-choice ollama \  --custom-base-url "http://ollama-host:11434" \  --custom-model-id "qwen3.5:27b" \  --accept-risk

--custom-base-url varsayılan olarak http://127.0.0.1:11434 değerini kullanır. --custom-model-id isteğe bağlıdır; atlanırsa ilk kurulum Ollama'nın önerilen varsayılanlarını kullanır. kimi-k2.5:cloud gibi bulut modeli kimlikleri de burada çalışır.

Sağlayıcı anahtarlarını düz metin yerine başvuru olarak saklayın:

OmeniaClaw onboard --non-interactive \  --auth-choice openai-api-key \  --secret-input-mode ref \  --accept-risk

--secret-input-mode ref ile ilk kurulum, düz metin anahtar değerleri yerine ortam destekli başvurular yazar. Auth-profile destekli sağlayıcılar için bu keyRef girdileri yazar; özel sağlayıcılar için models.providers.<id>.apiKey değerini bir ortam başvurusu olarak yazar (örneğin { source: "env", provider: "default", id: "CUSTOM_API_KEY" }).

Etkileşimsiz ref modu sözleşmesi:

• Sağlayıcı ortam değişkenini ilk kurulum süreci ortamında ayarlayın (örneğin OPENAI_API_KEY).
• Bu ortam değişkeni de ayarlanmadıkça satır içi anahtar bayrakları iletmeyin (örneğin --openai-api-key).
• Gerekli ortam değişkeni olmadan satır içi anahtar bayrağı iletilirse ilk kurulum rehberlikle hızlıca başarısız olur.

Etkileşimsiz modda Gateway belirteci seçenekleri:

• --gateway-auth token --gateway-token <token> düz metin belirteci saklar.
• --gateway-auth token --gateway-token-ref-env <name> gateway.auth.token değerini bir ortam SecretRef olarak saklar.
• --gateway-token ve --gateway-token-ref-env birbirini dışlar.
• --gateway-token-ref-env, ilk kurulum süreci ortamında boş olmayan bir ortam değişkeni gerektirir.
• --install-daemon ile, belirteç kimlik doğrulaması belirteç gerektirdiğinde SecretRef tarafından yönetilen Gateway belirteçleri doğrulanır ancak gözetmen hizmeti ortam meta verilerinde çözümlenmiş düz metin olarak kalıcılaştırılmaz.
• --install-daemon ile, belirteç modu bir belirteç gerektiriyorsa ve yapılandırılmış belirteç SecretRef çözümlenemiyorsa ilk kurulum düzeltme rehberliğiyle kapalı şekilde başarısız olur.
• --install-daemon ile, hem gateway.auth.token hem de gateway.auth.password yapılandırılmışsa ve gateway.auth.mode ayarlanmamışsa ilk kurulum, mod açıkça ayarlanana kadar kurulumu engeller.
• Yerel ilk kurulum, yapılandırmaya gateway.mode="local" yazar. Daha sonraki bir yapılandırma dosyasında gateway.mode yoksa bunu geçerli bir yerel mod kısayolu olarak değil, yapılandırma hasarı veya eksik bir elle düzenleme olarak değerlendirin.
• Yerel ilk kurulum, seçilen kurulum yolu gerektirdiğinde seçili indirilebilir Pluginleri kurar.
• Uzak ilk kurulum yalnızca uzak Gateway için bağlantı bilgilerini yazar ve yerel Plugin paketlerini kurmaz.
• --allow-unconfigured ayrı bir Gateway çalışma zamanı kaçış seçeneğidir. Bu, ilk kurulumun gateway.mode değerini atlayabileceği anlamına gelmez.

Örnek:

export OmeniaClaw_GATEWAY_TOKEN="your-token"OmeniaClaw onboard --non-interactive \  --mode local \  --auth-choice skip \  --gateway-auth token \  --gateway-token-ref-env OmeniaClaw_GATEWAY_TOKEN \  --accept-risk

Etkileşimsiz yerel Gateway sağlığı:

• --skip-health iletmediğiniz sürece ilk kurulum, başarıyla çıkmadan önce erişilebilir bir yerel Gateway bekler.
• --install-daemon önce yönetilen Gateway kurulum yolunu başlatır. Bu olmadan, örneğin OmeniaClaw gateway run ile çalışan bir yerel Gateway'inizin zaten olması gerekir.
• Otomasyonda yalnızca yapılandırma/çalışma alanı/bootstrap yazımları istiyorsanız --skip-health kullanın.
• Çalışma alanı dosyalarını kendiniz yönetiyorsanız agents.defaults.skipBootstrap: true ayarlamak ve AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md ve BOOTSTRAP.md oluşturmayı atlamak için --skip-bootstrap iletin.
• Yerel Windows'ta --install-daemon önce Scheduled Tasks kullanmayı dener ve görev oluşturma reddedilirse kullanıcı başına Startup klasörü oturum açma öğesine geri döner.

Başvuru modu ile etkileşimli ilk kurulum davranışı:

• İstendiğinde Gizli başvuruyu kullan seçeneğini seçin.
• Ardından şunlardan birini seçin:
  • Ortam değişkeni
  • Yapılandırılmış gizli sağlayıcı (file veya exec)
• İlk kurulum, başvuruyu kaydetmeden önce hızlı bir ön kontrol doğrulaması yapar.
  • Doğrulama başarısız olursa ilk kurulum hatayı gösterir ve yeniden denemenize izin verir.

Etkileşimsiz Z.AI uç nokta seçimleri

# Promptless endpoint selectionOmeniaClaw onboard --non-interactive \  --auth-choice zai-coding-global \  --zai-api-key "$ZAI_API_KEY" # Other Z.AI endpoint choices:# --auth-choice zai-coding-cn# --auth-choice zai-global# --auth-choice zai-cn

Etkileşimsiz Mistral örneği:

OmeniaClaw onboard --non-interactive \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY"

Akış notları

Yaygın takip komutları

OmeniaClaw channels addOmeniaClaw configureOmeniaClaw agents add <name>

Yalnızca temel yapılandırma/çalışma alanına ihtiyacınız olduğunda bunun yerine OmeniaClaw setup kullanın. Hedefli değişiklikler için daha sonra OmeniaClaw configure, yalnızca kanal kurulumu için OmeniaClaw channels add kullanın.