Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw devices
Cihaz eşleştirme isteklerini ve cihaz kapsamlı tokenları yönetin.
Komutlar
openclaw devices list
Bekleyen eşleştirme isteklerini ve eşleştirilmiş cihazları listeleyin.
openclaw devices remove <deviceId>
Bir eşleştirilmiş cihaz kaydını kaldırın.
Eşleştirilmiş bir cihaz tokenı ile kimlik doğrulaması yaptığınızda, yönetici olmayan çağıranlar
yalnızca kendi cihaz kaydını kaldırabilir. Başka bir cihazı kaldırmak
operator.admin gerektirir.
openclaw devices clear --yes [--pending]
Eşleştirilmiş cihazları toplu olarak temizleyin.
openclaw devices approve [requestId] [--latest]
Bekleyen bir cihaz eşleştirme isteğini tam requestId ile onaylayın. requestId
atlanırsa veya --latest geçirilirse, OpenClaw yalnızca seçili bekleyen
isteği yazdırır ve çıkar; ayrıntıları doğruladıktan sonra tam istek kimliğiyle
onayı yeniden çalıştırın.
Bir cihaz değişen kimlik doğrulama ayrıntılarıyla (rol, kapsamlar veya açık anahtar) eşleştirmeyi yeniden denerse, OpenClaw önceki bekleyen kaydın yerine geçer ve yeni bir
requestId verir. Geçerli kimliği kullanmak için onaydan hemen önce openclaw devices list çalıştırın.openclaw devices list içindeki Requested ve Approved sütunlarını inceleyin
veya onaylamadan önce tam yükseltmeyi önizlemek için openclaw devices approve --latest kullanın.
Gateway açıkça
gateway.nodes.pairing.autoApproveCidrs ile yapılandırılmışsa, eşleşen istemci IP’lerinden gelen ilk kez yapılan role: node istekleri
bu listede görünmeden önce onaylanabilir. Bu politika varsayılan olarak
devre dışıdır ve operatör/tarayıcı istemcilerine veya yükseltme
isteklerine asla uygulanmaz.
openclaw devices reject <requestId>
Bekleyen bir cihaz eşleştirme isteğini reddedin.
openclaw devices rotate --device <id> --role <role> [--scope <scope...>]
Belirli bir rol için cihaz tokenını döndürün (isteğe bağlı olarak kapsamları güncelleyerek).
Hedef rol, o cihazın onaylı eşleştirme sözleşmesinde zaten mevcut olmalıdır;
döndürme yeni onaylanmamış bir rol üretemez.
--scope değerini atlarsanız, saklanan döndürülmüş token ile sonraki yeniden bağlantılar
o tokenın önbelleğe alınmış onaylı kapsamlarını yeniden kullanır. Açık --scope değerleri geçirirseniz, bunlar
gelecekteki önbelleğe alınmış token yeniden bağlantıları için saklanan kapsam kümesi olur.
Yönetici olmayan eşleştirilmiş cihaz çağıranları yalnızca kendi cihaz tokenını döndürebilir.
Hedef token kapsam kümesi, çağıranın kendi oturumundaki operatör
kapsamları içinde kalmalıdır; döndürme, çağıranın zaten sahip olduğundan
daha geniş bir operatör tokenı üretemez veya koruyamaz.
openclaw devices revoke --device <id> --role <role>
Belirli bir rol için cihaz tokenını iptal edin.
Yönetici olmayan eşleştirilmiş cihaz çağıranları yalnızca kendi cihaz tokenını iptal edebilir.
Başka bir cihazın tokenını iptal etmek operator.admin gerektirir.
Hedef token kapsam kümesi de çağıranın kendi oturumundaki
operatör kapsamlarına sığmalıdır; yalnızca eşleştirme yetkili çağıranlar yönetici/yazma operatör tokenlarını iptal edemez.
Yaygın seçenekler
--url <url>: Gateway WebSocket URL’si (yapılandırıldığında varsayılan olarakgateway.remote.url).--token <token>: Gateway tokenı (gerekliyse).--password <password>: Gateway parolası (parola kimlik doğrulaması).--timeout <ms>: RPC zaman aşımı.--json: JSON çıktısı (betik yazımı için önerilir).
Notlar
- Token döndürme yeni bir token döndürür (hassas). Ona gizli bilgi gibi davranın.
- Bu komutlar
operator.pairing(veyaoperator.admin) kapsamı gerektirir. Bazı onaylar, çağıranın hedef cihazın üreteceği veya devralacağı operatör kapsamlarına sahip olmasını da gerektirir; bkz. Operatör kapsamları. gateway.nodes.pairing.autoApproveCidrs, yalnızca yeni node cihaz eşleştirmesi için isteğe bağlı bir Gateway politikasıdır; CLI onay yetkisini değiştirmez.- Token döndürme ve iptal, o cihaz için onaylı eşleştirme rol kümesi ve onaylı kapsam temel çizgisi içinde kalır. Başıboş bir önbelleğe alınmış token kaydı token yönetimi hedefi sağlamaz.
- Eşleştirilmiş cihaz token oturumları için cihazlar arası yönetim yalnızca yöneticilere özeldir:
remove,rotateverevoke, çağırandaoperator.adminyoksa yalnızca kendi cihazıyla sınırlıdır. - Token değişikliği de çağıran kapsamıyla sınırlıdır: yalnızca eşleştirme yetkili bir oturum,
şu anda
operator.adminveyaoperator.writetaşıyan bir tokenı döndüremez veya iptal edemez. devices clearkasıtlı olarak--yesile kapılanmıştır.- Eşleştirme kapsamı local loopback üzerinde kullanılamıyorsa (ve açık
--urlgeçirilmemişse), listeleme/onaylama yerel eşleştirme geri dönüşünü kullanabilir. devices approve, token üretmeden önce açık bir istek kimliği gerektirir;requestIdatlamak veya--latestgeçirmek yalnızca en yeni bekleyen isteği önizler.
Token sapması kurtarma kontrol listesi
Control UI veya diğer istemcilerAUTH_TOKEN_MISMATCH, AUTH_DEVICE_TOKEN_MISMATCH ya da AUTH_SCOPE_MISMATCH ile başarısız olmaya devam ettiğinde bunu kullanın.
- Geçerli Gateway token kaynağını doğrulayın:
- Eşleştirilmiş cihazları listeleyin ve etkilenen cihaz kimliğini belirleyin:
- Etkilenen cihaz için operatör tokenını döndürün:
- Döndürme yeterli değilse, eski eşleştirmeyi kaldırın ve yeniden onaylayın:
- Geçerli paylaşılan token/parola ile istemci bağlantısını yeniden deneyin.
- Normal yeniden bağlantı kimlik doğrulama önceliği önce açık paylaşılan token/parola, sonra açık
deviceToken, sonra saklanan cihaz tokenı, sonra bootstrap tokenıdır. - Güvenilir
AUTH_TOKEN_MISMATCHkurtarması, tek sınırlı yeniden deneme için hem paylaşılan tokenı hem de saklanan cihaz tokenını birlikte geçici olarak gönderebilir. AUTH_SCOPE_MISMATCH, cihaz tokenının tanındığı ancak istenen kapsam kümesini taşımadığı anlamına gelir; paylaşılan Gateway kimlik doğrulamasını değiştirmeden önce eşleştirme/kapsam onay sözleşmesini düzeltin.