OmeniaClaw node

Gateway WebSocket'a bağlanan ve bu makinede system.run / system.which sunan bir başsız Node ana makinesi çalıştırın.

Neden bir Node ana makinesi kullanılır?

Ağınızdaki başka makinelere tam bir macOS companion app yüklemeden agent'ların bu makinelerde komut çalıştırmasını istediğinizde bir Node ana makinesi kullanın.

Yaygın kullanım örnekleri:

• Uzak Linux/Windows makinelerinde komut çalıştırma (build sunucuları, laboratuvar makineleri, NAS).
• exec'i gateway üzerinde sandbox içinde tutarken onaylanmış çalıştırmaları başka ana makinelere devretme.
• Otomasyon veya CI node'ları için hafif, başsız bir yürütme hedefi sağlama.

Yürütme yine de Node ana makinesindeki exec onayları ve agent başına izin listeleriyle korunur; böylece komut erişimini kapsamlı ve açık tutabilirsiniz.

Tarayıcı proxy'si (sıfır yapılandırma)

Node ana makineleri, Node üzerinde browser.enabled devre dışı bırakılmamışsa otomatik olarak bir tarayıcı proxy'si duyurur. Bu, agent'ın ek yapılandırma olmadan o Node üzerinde tarayıcı otomasyonu kullanmasını sağlar.

Varsayılan olarak proxy, Node'un normal tarayıcı profili yüzeyini sunar. Eğer nodeHost.browserProxy.allowProfiles ayarlarsanız proxy kısıtlayıcı olur: izin listesinde olmayan profil hedefleme reddedilir ve kalıcı profil oluşturma/silme yolları proxy üzerinden engellenir.

Gerekirse Node üzerinde devre dışı bırakın:

{  nodeHost: {    browserProxy: {      enabled: false,    },  },}

Çalıştırma (ön plan)

OmeniaClaw node run --host <gateway-host> --port 18789

Seçenekler:

• --host <host>: Gateway WebSocket ana makinesi (varsayılan: 127.0.0.1)
• --port <port>: Gateway WebSocket portu (varsayılan: 18789)
• --tls: Gateway bağlantısı için TLS kullan
• --tls-fingerprint <sha256>: Beklenen TLS sertifika parmak izi (sha256)
• --node-id <id>: Node kimliğini geçersiz kıl (eşleştirme token'ını temizler)
• --display-name <name>: Node görünen adını geçersiz kıl

Node ana makinesi için Gateway kimlik doğrulaması

OmeniaClaw node run ve OmeniaClaw node install, Gateway kimlik doğrulamasını config/env üzerinden çözer (Node komutlarında --token/--password bayrakları yoktur):

• Önce OmeniaClaw_GATEWAY_TOKEN / OmeniaClaw_GATEWAY_PASSWORD kontrol edilir.
• Ardından yerel config yedeği: gateway.auth.token / gateway.auth.password.
• Yerel modda, Node ana makinesi bilinçli olarak gateway.remote.token / gateway.remote.password değerlerini devralmaz.
• gateway.auth.token / gateway.auth.password açıkça SecretRef ile yapılandırılmış ve çözümlenmemişse, Node kimlik doğrulama çözümlemesi kapalı başarısız olur (uzak yedek maskelemesi yoktur).
• gateway.mode=remote içinde, uzak istemci alanları (gateway.remote.token / gateway.remote.password) da uzak öncelik kurallarına göre uygundur.
• Node ana makinesi kimlik doğrulama çözümlemesi yalnızca OmeniaClaw_GATEWAY_* env değişkenlerini dikkate alır.

Güvenilir özel ağda, local loopback olmayan bir ws:// Gateway'e bağlanan bir Node için OmeniaClaw_ALLOW_INSECURE_PRIVATE_WS=1 ayarlayın. Bu olmadan Node başlatma kapalı başarısız olur ve sizden wss://, bir SSH tüneli veya Tailscale kullanmanızı ister. Bu, işlem ortamı düzeyinde bir katılımdır; OmeniaClaw.json config anahtarı değildir. OmeniaClaw node install, kurulum komutu ortamında mevcut olduğunda bunu denetlenen Node hizmetine kalıcı olarak yazar.

Hizmet (arka plan)

Başsız bir Node ana makinesini kullanıcı hizmeti olarak kurun.

OmeniaClaw node install --host <gateway-host> --port 18789

Seçenekler:

• --host <host>: Gateway WebSocket ana makinesi (varsayılan: 127.0.0.1)
• --port <port>: Gateway WebSocket portu (varsayılan: 18789)
• --tls: Gateway bağlantısı için TLS kullan
• --tls-fingerprint <sha256>: Beklenen TLS sertifika parmak izi (sha256)
• --node-id <id>: Node kimliğini geçersiz kıl (eşleştirme token'ını temizler)
• --display-name <name>: Node görünen adını geçersiz kıl
• --runtime <runtime>: Hizmet runtime'ı (node veya bun)
• --force: Zaten kuruluysa yeniden kur/üzerine yaz

Hizmeti yönetin:

OmeniaClaw node statusOmeniaClaw node startOmeniaClaw node stopOmeniaClaw node restartOmeniaClaw node uninstall

Ön planda çalışan bir Node ana makinesi için OmeniaClaw node run kullanın (hizmet yok).

Hizmet komutları, makine tarafından okunabilir çıktı için --json kabul eder.

Node ana makinesi, Gateway yeniden başlatmasını ve ağ kapanmalarını işlem içinde yeniden dener. Gateway terminal bir token/parola/bootstrap kimlik doğrulama duraklaması bildirirse, Node ana makinesi kapanış ayrıntısını günlüğe yazar ve sıfır olmayan kodla çıkar; böylece launchd/systemd onu yeni config ve kimlik bilgileriyle yeniden başlatabilir. Eşleştirme gerektiren duraklamalar, bekleyen isteğin onaylanabilmesi için ön plan akışında kalır.

Eşleştirme

İlk bağlantı, Gateway üzerinde bekleyen bir cihaz eşleştirme isteği (role: node) oluşturur. Şununla onaylayın:

OmeniaClaw devices listOmeniaClaw devices approve <requestId>

Sıkı denetimli Node ağlarında, Gateway operatörü güvenilir CIDR'lardan ilk kez Node eşleştirmesini otomatik onaylamayı açıkça etkinleştirebilir:

{  gateway: {    nodes: {      pairing: {        autoApproveCidrs: ["192.168.1.0/24"],      },    },  },}

Bu varsayılan olarak devre dışıdır. Yalnızca istenen kapsamları olmayan yeni role: node eşleştirmeleri için geçerlidir. Operatör/tarayıcı istemcileri, Control UI, WebChat ve rol, kapsam, metadata veya açık anahtar yükseltmeleri yine de elle onay gerektirir.

Node, değişen kimlik doğrulama ayrıntılarıyla (rol/kapsamlar/açık anahtar) eşleştirmeyi yeniden denerse, önceki bekleyen istek geçersiz kılınır ve yeni bir requestId oluşturulur. Onaylamadan önce OmeniaClaw devices list komutunu tekrar çalıştırın.

Node ana makinesi; Node kimliğini, token'ını, görünen adını ve gateway bağlantı bilgilerini ~/.OmeniaClaw/node.json içinde saklar.

Exec onayları

system.run, yerel exec onaylarıyla denetlenir:

• ~/.OmeniaClaw/exec-approvals.json
• Exec onayları
• OmeniaClaw approvals --node <id|name|ip> (Gateway'den düzenle)

Onaylanmış async Node exec için OmeniaClaw, istemden önce kanonik bir systemRunPlan hazırlar. Daha sonra onaylanan system.run iletimi bu saklanan planı yeniden kullanır; bu nedenle onay isteği oluşturulduktan sonra komut/cwd/session alanlarında yapılan düzenlemeler, Node'un yürüteceği şeyi değiştirmek yerine reddedilir.

İlgili

• CLI referansı
• Node'lar