Node eşleştirme

• Cihaz eşleştirme (node rolü), connect el sıkışmasını denetler. Aşağıdaki Güvenilir CIDR cihaz otomatik onayı ve Kanal eşleştirme bölümlerine bakın.
• Node yetenek onayı (node.pair.*), bağlı bir Node’un hangi beyan edilmiş yetenekleri/komutları sunabileceğini denetler. Doğruluk kaynağı Gateway’dir; kullanıcı arayüzleri (macOS uygulaması, Control UI), bekleyen istekleri onaylayan veya reddeden ön yüzlerdir.

​

Yetenek onayı nasıl çalışır?

1. Bir Node, Gateway WS’ye bağlanır (cihaz eşleştirme bu adımı denetler).
2. Gateway, beyan edilen yetenek/komut yüzeyini onaylanmış yüzeyle karşılaştırır; yeni veya genişletilmiş yüzeyler, cihaz kaydında bir bekleyen istek saklar ve node.pair.requested olayını yayınlar.
3. İsteği onaylar veya reddedersiniz (CLI ya da kullanıcı arayüzü).
4. Onay verilene kadar Node komutları filtrelenmiş olarak kalır; onay, normal komut politikasına tabi olmak üzere beyan edilen yüzeyi kullanıma açar.

​

CLI iş akışı (ekransız kullanıma uygun)

openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes reject <requestId>
openclaw nodes status
openclaw nodes remove --node <id|name|ip>
openclaw nodes rename --node <id|name|ip> --name "Living Room iPad"

​

API yüzeyi (Gateway protokolü)

• node.pair.requested - yeni bir bekleyen istek oluşturulduğunda yayınlanır.
• node.pair.resolved - bir istek onaylandığında, reddedildiğinde veya süresi dolduğunda yayınlanır.

• node.pair.list - bekleyen ve eşleştirilmiş Node’ları listeler (operator.pairing).
• node.pair.approve - bekleyen bir isteği onaylar.
• node.pair.reject - bekleyen bir isteği reddeder.
• node.pair.remove - eşleştirilmiş bir Node’u kaldırır. Bu işlem, eşleştirilmiş cihaz deposunda cihazın node rolünü iptal eder, onaylanmış Node yüzeyini onunla birlikte kaldırır ve bu cihazın Node rolü oturumlarını geçersiz kılar/bağlantılarını keser. Karma rollü bir cihaz (örneğin aynı zamanda operator rolüne de sahip olan bir cihaz) satırını korur ve yalnızca node rolünü kaybeder; yalnızca Node olan bir cihazın satırı silinir. Yetkilendirme: operator.pairing, operatör olmayan Node satırlarını kaldırabilir; karma rollü bir cihazda kendi Node rolünü iptal eden cihaz belirteçli bir çağıranın ayrıca operator.admin yetkisine ihtiyacı vardır.
• node.rename - eşleştirilmiş bir Node’un operatöre gösterilen görüntüleme adını değiştirir.

• Değişmemiş bir yüzeyle yeniden bağlanıldığında bekleyen istek yeniden kullanılır; yinelenen istekler, operatör görünürlüğü için saklanan Node meta verilerini ve izin listesine alınmış en son beyan edilen komut anlık görüntüsünü yeniler.
• Operatör kapsam düzeyleri ve onay sırasındaki denetimler Operatör kapsamları bölümünde özetlenmiştir.
• node.pair.approve, ek onay kapsamlarını zorunlu kılmak için bekleyen isteğin beyan edilmiş komutlarını kullanır:
  • komutsuz istek: operator.pairing
  • normal komut isteği: operator.pairing + operator.write
  • system.run, system.run.prepare, system.which, browser.proxy, fs.listDir veya system.execApprovals.get/set içeren yönetici açısından hassas istek: operator.pairing + operator.admin

​

Node komutu denetimi (2026.3.31+)

• Daha önce komutları kullanıma açmak için yalnızca cihaz eşleştirmeye dayanan Node’lar artık Node eşleştirmeyi de tamamlamalıdır.
• Eşleştirme onayından önce kuyruğa alınan komutlar ertelenmez, bırakılır.

​

Node olayı güven sınırları (2026.3.31+)

​

SSH ile doğrulanmış cihaz otomatik onayı (varsayılan)

• Gateway işleminin kullanıcısı (veya sshVerify.user), Node ana makinesine etkileşimsiz olarak SSH ile bağlanabilir (anahtarlar/aracı; Tailscale SSH de çalışır) ve ana makine anahtarı zaten güvenilirdir.
• openclaw, etkileşimsiz sh -lc için uzak PATH üzerinde çözümlenir.
• Bağlanan IP, doğrudan (proxy kullanılmayan ve geri döngü olmayan) bir özel, ULA, bağlantı-yerel veya CGNAT adresidir ya da ayarlanmışsa sshVerify.cidrs ile eşleşir.
• Güvenilir CIDR onayıyla aynı uygunluk alt sınırı geçerlidir: yalnızca yeni ve kapsamsız Node eşleştirme; yükseltmeler, tarayıcılar, Control UI ve WebChat her zaman istem gösterir.

{
  gateway: {
    nodes: {
      pairing: {
        // Tamamen devre dışı bırak:
        sshVerify: false,
        // ...veya yoklamanın kapsamını/ayarlarını belirle:
        // sshVerify: { user: "me", identity: "~/.ssh/probe", timeoutMs: 7000, cidrs: ["10.0.0.0/8"] },
      },
    },
  },
}

​

Otomatik onay (macOS uygulaması)

• istek silent olarak işaretlenmişse (cihaz eşleştirme etkileşimsiz olarak onaylandığında Gateway ilk yetenek yüzeyini sessiz olarak işaretler) ve
• uygulama, aynı kullanıcıyı kullanarak Gateway ana makinesine SSH bağlantısını doğrulayabiliyorsa.

​

Güvenilir CIDR cihaz otomatik onayı

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

• gateway.nodes.pairing.autoApproveCidrs ayarlanmamışsa devre dışıdır.
• Genel bir LAN veya özel ağ otomatik onay modu yoktur; SSH ile doğrulanmış otomatik onay (yukarıda) kriptografik bir cihaz anahtarı eşleşmesi gerektirir, yalnızca ağ yakınlığı hiçbir zaman yeterli değildir.
• Yalnızca istenen kapsamı olmayan yeni bir role: node cihaz eşleştirme isteği uygundur.
• Operatör, tarayıcı, Control UI ve WebChat istemcileri manuel kalır.
• Rol, kapsam, meta veri ve açık anahtar yükseltmeleri manuel kalır.
• Aynı ana makinedeki geri döngü güvenilir proxy üst bilgisi yolları uygun değildir; çünkü bu yol yerel çağıranlar tarafından taklit edilebilir.

​

Sessiz eşleştirmede yerine geçme temizliği

• Yalnızca en son onayı aynı ana makinede yerel (silent) olarak verilen kayıtlar hem tetikleyici hem de hedef olarak uygundur. Güvenilir CIDR ve SSH ile doğrulanmış eşleştirmeler, görüntüleme meta verilerinin bir makine kimliği olmadığı ana makineler arasında gerçekleştiğinden hiçbir zaman otomatik olarak kaldırılmaz — bunlar için Control UI temizliğini veya openclaw nodes remove kullanın.
• Sahibi tarafından onaylanan ve QR/kurulum koduyla (önyükleme) yapılan eşleştirmeler hiçbir zaman otomatik olarak kaldırılmaz. Kaynak bilgisi mevcut olmadan önce onaylanan kayıtlar, aynı cihaz kimliği daha sonra sessizce yeniden onaylansa bile korunmaya devam eder.
• O anda bağlı olan cihazlar atlanır; böylece ayrı durum dizinlerine sahip eşzamanlı yerel oturumlar, etkin oldukları sürece token’larını korur. Son bir dakika içinde onaylanan kayıtlar da atlanır; böylece eşzamanlı eşleştirme el sıkışmaları, bağlantıları kaydedilmeden önce birbirini devre dışı bırakamaz.
• Etkilenen istemciler yapıları gereği yereldir; bu nedenle bir sonraki bağlantılarında sessizce yeniden eşleşirler.

​

Meta veri yükseltmesini otomatik onaylama

​

QR eşleştirme yardımcıları

​

Yerellik ve iletilen üstbilgiler

​

Depolama (yerel, özel)

• ~/.openclaw/state/openclaw.sqlite (cihaz kimlik doğrulamasına sahip eşleştirilmiş cihazlar, onaylanmış Node yüzeyleri, bekleyen yüzey istekleri, bekleyen cihaz eşleştirme istekleri ve önyükleme token’ları)

• Cihaz token’ları gizlidir; durum veritabanını hassas kabul edin.
• Bir cihaz token’ını döndürmek için openclaw devices rotate / device.token.rotate kullanılır.

​

Aktarım davranışı

• Aktarım durumsuzdur; üyelik bilgilerini depolamaz.
• Gateway çevrimdışıysa veya eşleştirme devre dışıysa Node’lar eşleşemez.
• Uzak modda eşleştirme, uzak Gateway’in deposunda gerçekleştirilir.

​

İlgili konular

• Kanal eşleştirmesi
• Node CLI
• Cihazlar CLI