iOS uygulaması

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.

​

Ne yapar?

• WebSocket üzerinden bir Gateway’e bağlanır (LAN veya tailnet).
• Node yeteneklerini sunar: Canvas, ekran anlık görüntüsü, kamera yakalama, konum, konuşma modu, sesle uyandırma.
• node.invoke komutlarını alır ve Node durum olaylarını bildirir.

​

Gereksinimler

• Başka bir cihazda çalışan Gateway (macOS, Linux veya WSL2 üzerinden Windows).
• Ağ yolu:
  • Bonjour ile aynı LAN, veya
  • Tek noktaya yayın DNS-SD ile tailnet (örnek alan adı: openclaw.internal.), veya
  • Manuel ana makine/bağlantı noktası (yedek).

​

Hızlı başlangıç (eşleştir + bağlan)

1. Gateway’i başlatın:

openclaw gateway --port 18789

2. iOS uygulamasında Ayarlar’ı açın ve keşfedilen bir Gateway seçin (veya Manuel Ana Makine’yi etkinleştirip ana makine/bağlantı noktasını girin).
3. Gateway ana makinesinde eşleştirme isteğini onaylayın:

openclaw devices list
openclaw devices approve <requestId>

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

4. Bağlantıyı doğrulayın:

openclaw nodes status
openclaw gateway call node.list --params "{}"

​

Resmi derlemeler için röle destekli push

{
  gateway: {
    push: {
      apns: {
        relay: {
          baseUrl: "https://relay.example.com",
        },
      },
    },
  },
}

• iOS uygulaması, App Attest ve StoreKit uygulama işlem JWS’si kullanarak röleye kaydolur.
• Röle, opak bir röle tanıtıcısı ve kayıt kapsamlı bir gönderme izni döndürür.
• iOS uygulaması eşleştirilmiş Gateway kimliğini alır ve röle kaydına dahil eder; böylece röle destekli kayıt bu belirli Gateway’e devredilir.
• Uygulama, bu röle destekli kaydı push.apns.register ile eşleştirilmiş Gateway’e iletir.
• Gateway, push.test, arka plan uyandırmaları ve uyandırma dürtmeleri için saklanan bu röle tanıtıcısını kullanır.
• Gateway röle temel URL’si, resmi/TestFlight iOS derlemesine gömülü röle URL’siyle eşleşmelidir.
• Uygulama daha sonra farklı bir Gateway’e veya farklı röle temel URL’sine sahip bir derlemeye bağlanırsa eski bağlamayı yeniden kullanmak yerine röle kaydını yeniler.

• Dağıtım genelinde röle token’ı yoktur.
• Resmi/TestFlight röle destekli gönderimler için doğrudan APNs anahtarı gerekmez.

1. Resmi/TestFlight iOS derlemesini yükleyin.
2. Gateway’de gateway.push.apns.relay.baseUrl değerini ayarlayın.
3. Uygulamayı Gateway ile eşleştirin ve bağlanmayı tamamlamasına izin verin.
4. Uygulama, APNs token’ına sahip olduktan, operatör oturumu bağlandıktan ve röle kaydı başarılı olduktan sonra push.apns.register otomatik olarak yayımlar.
5. Bundan sonra push.test, yeniden bağlanma uyandırmaları ve uyandırma dürtmeleri saklanan röle destekli kaydı kullanabilir.

​

Arka plan canlılık sinyalleri

• OPENCLAW_APNS_RELAY_BASE_URL, Gateway için geçici env geçersiz kılması olarak hâlâ çalışır.

​

Kimlik doğrulama ve güven akışı

• Barındırılan röleyi yalnızca Apple üzerinden dağıtılan gerçek OpenClaw iOS derlemeleri kullanabilir.
• Bir Gateway, röle destekli push’ları yalnızca o belirli Gateway ile eşleşmiş iOS cihazlarına gönderebilir.

1. iOS app -> gateway
   • Uygulama önce normal Gateway kimlik doğrulama akışıyla Gateway ile eşleşir.
   • Bu, uygulamaya kimliği doğrulanmış bir Node oturumu ve kimliği doğrulanmış bir operatör oturumu verir.
   • Operatör oturumu gateway.identity.get çağırmak için kullanılır.
2. iOS app -> relay
   • Uygulama, HTTPS üzerinden röle kayıt uç noktalarını çağırır.
   • Kayıt, App Attest kanıtı ve StoreKit uygulama işlem JWS’si içerir.
   • Röle, bundle ID’yi, App Attest kanıtını ve Apple dağıtım kanıtını doğrular ve resmi/production dağıtım yolunu zorunlu kılar.
   • Yerel Xcode/dev derlemelerinin barındırılan röleyi kullanmasını engelleyen şey budur. Yerel bir derleme imzalanmış olabilir, ancak rölenin beklediği resmi Apple dağıtım kanıtını karşılamaz.
3. gateway identity delegation
   • Röle kaydından önce uygulama, eşleştirilmiş Gateway kimliğini gateway.identity.get üzerinden alır.
   • Uygulama, bu Gateway kimliğini röle kayıt yüküne dahil eder.
   • Röle, bu Gateway kimliğine devredilmiş bir röle tanıtıcısı ve kayıt kapsamlı gönderme izni döndürür.
4. gateway -> relay
   • Gateway, push.apns.register tarafından gelen röle tanıtıcısını ve gönderme iznini saklar.
   • push.test, yeniden bağlanma uyandırmaları ve uyandırma dürtmelerinde Gateway, gönderme isteğini kendi cihaz kimliğiyle imzalar.
   • Röle, hem saklanan gönderme iznini hem de Gateway imzasını kayıttaki devredilmiş Gateway kimliğine göre doğrular.
   • Başka bir Gateway, tanıtıcıyı bir şekilde ele geçirse bile saklanan bu kaydı yeniden kullanamaz.
5. relay -> APNs
   • Röle, production APNs kimlik bilgilerine ve resmi derleme için ham APNs token’ına sahiptir.
   • Gateway, röle destekli resmi derlemeler için ham APNs token’ını asla saklamaz.
   • Röle, eşleştirilmiş Gateway adına son push’u APNs’ye gönderir.

• Production APNs kimlik bilgilerini kullanıcı Gateway’lerinin dışında tutmak.
• Ham resmi derleme APNs token’larını Gateway’de saklamaktan kaçınmak.
• Barındırılan röle kullanımına yalnızca resmi/TestFlight OpenClaw derlemeleri için izin vermek.
• Bir Gateway’in farklı bir Gateway’e ait iOS cihazlarına uyandırma push’ları göndermesini önlemek.

export OPENCLAW_APNS_TEAM_ID="TEAMID"
export OPENCLAW_APNS_KEY_ID="KEYID"
export OPENCLAW_APNS_PRIVATE_KEY_P8="$(cat /path/to/AuthKey_KEYID.p8)"

mkdir -p ~/.openclaw/credentials/apns
chmod 700 ~/.openclaw/credentials/apns
mv /path/to/AuthKey_KEYID.p8 ~/.openclaw/credentials/apns/AuthKey_KEYID.p8
chmod 600 ~/.openclaw/credentials/apns/AuthKey_KEYID.p8
export OPENCLAW_APNS_PRIVATE_KEY_PATH="$HOME/.openclaw/credentials/apns/AuthKey_KEYID.p8"

​

Keşif yolları

​

Bonjour (LAN)

​

Tailnet (ağlar arası)

​

Manuel ana makine/bağlantı noktası

​

Canvas + A2UI

openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18789/__openclaw__/canvas/"}'

• Gateway canvas ana makinesi /__openclaw__/canvas/ ve /__openclaw__/a2ui/ sunar.
• Gateway HTTP sunucusundan sunulur (gateway.port ile aynı bağlantı noktası, varsayılan 18789).
• iOS Node, bir canvas ana makine URL’si duyurulduğunda bağlantı sırasında otomatik olarak A2UI’ye gider.
• Yerleşik iskelete canvas.navigate ve {"url":""} ile dönün.

​

Computer Use ilişkisi

​

Canvas eval / anlık görüntü

openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'

openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

​

Sesle uyandırma + konuşma modu

• Sesle uyandırma ve konuşma modu Ayarlar’da kullanılabilir.
• Konuşma destekli iOS Node’ları talk yeteneğini duyurur ve talk.ptt.start, talk.ptt.stop, talk.ptt.cancel ve talk.ptt.once bildirebilir; Gateway, güvenilir konuşma destekli Node’lar için bu bas-konuş komutlarına varsayılan olarak izin verir.
• iOS arka plan sesini askıya alabilir; uygulama etkin değilken ses özelliklerini en iyi çaba olarak değerlendirin.

​

Yaygın hatalar

• NODE_BACKGROUND_UNAVAILABLE: iOS uygulamasını ön plana getirin (canvas/kamera/ekran komutları bunu gerektirir).
• A2UI_HOST_NOT_CONFIGURED: Gateway, Canvas Plugin yüzey URL’sini duyurmadı; Gateway yapılandırması içindeki plugins.entries.canvas.config.host değerini kontrol edin.
• Eşleştirme istemi hiç görünmüyor: openclaw devices list çalıştırın ve manuel olarak onaylayın.
• Yeniden yüklemeden sonra yeniden bağlanma başarısız oluyor: Keychain eşleştirme token’ı temizlenmiş; Node’u yeniden eşleştirin.

​

İlgili belgeler

• Eşleştirme
• Keşif
• Bonjour