Android uygulaması

​

Destek özeti

• Rol: eşlikçi Node uygulaması (Android, Gateway’i barındırmaz).
• Gateway gerekli: evet (macOS, Linux veya WSL2 aracılığıyla Windows üzerinde çalıştırın).
• Kurulum: Google Play veya desteklenen bir GitHub Sürümünden OpenClaw-Android.apk; Gateway için Başlarken, ardından Eşleştirme.
• Gateway: Çalıştırma kılavuzu + Yapılandırma.
  • Protokoller: Gateway protokolü (Node’lar + kontrol düzlemi).
• Settings → OpenClaw, operatör bağlantısında operator.admin bulunduğunda ve Gateway openclaw.chat desteklediğinde özel bir Gateway ayarları yardımcısını açar. Kurulum görüşmesi sıradan Sohbetten ayrı kalır, gizli yanıtları yerel olarak karartır ve yalnızca Open Chat seçeneğine dokunulduktan sonra Sohbete geçer.

​

Eş zamanlı Gateway oturumları

​

Wear OS eşlikçisi

​

Google Play dışından kurulum

release_tag=vYYYY.M.PATCH
gh release download "$release_tag" \
  --repo openclaw/openclaw \
  --pattern OpenClaw-Android.apk \
  --pattern OpenClaw-Android-SHA256SUMS.txt
sha256sum --check OpenClaw-Android-SHA256SUMS.txt
gh attestation verify OpenClaw-Android.apk \
  --repo openclaw/openclaw \
  --signer-workflow openclaw/openclaw/.github/workflows/android-release.yml \
  --source-ref "refs/tags/${release_tag}" \
  --deny-self-hosted-runners

​

Android’i uzak bir Mac’ten yansıtma ve denetleme

​

Başlamadan önce

• Android cihaza ve Mac’e Tailscale yükleyin ve her ikisini de aynı tailnet’e bağlayın.
• Android’de Developer options ve USB debugging seçeneklerini etkinleştirin. Android 16, Wireless debugging seçeneğini Settings > System > Developer options altında bulundurur. Bkz. Android geliştirici seçenekleri.
• Mac’e scrcpy ve ADB yükleyin:
  brew install scrcpy
  brew install --cask android-platform-tools
  
• İlk bağlantı için Android cihazı erişilebilir durumda tutun. Android, ilgili Mac’in cihazı denetleyebilmesi için her Mac’in ADB anahtarını onaylamalıdır.

​

TCP üzerinden ADB’yi etkinleştirme

adb devices
adb tcpip 5555

​

Yalnızca denetleyici Mac’e izin verme

{
  grants: [
    {
      src: ["<remote-mac-tailnet-ip>"],
      dst: ["<android-tailnet-ip>"],
      ip: ["tcp:5555"],
    },
  ],
}

​

Bağlanma ve yansıtmayı başlatma

adb connect <android-tailnet-ip>:5555
adb devices
scrcpy --serial <android-tailnet-ip>:5555

​

Sorun giderme

• Connection timed out: TCP 5555 için tailnet iznini doğrulayın. Başarılı bir tailscale ping, eşler arası erişilebilirliği kanıtlar; politikanın bu TCP bağlantı noktasına izin verdiğini kanıtlamaz. Mac’ten nc -vz <android-tailnet-ip> 5555 ile test edin.
• unauthorized: Android’in kilidini açıp uzak Mac’in ADB anahtarını onaylayın veya Wireless debugging > Paired devices altındaki eski iş istasyonunu kaldırıp yeniden eşleştirin.
• Connection refused: yerel olarak yeniden bağlanın ve adb tcpip 5555 komutunu tekrar çalıştırın.
• Birden fazla cihaz listelendi: açık --serial <android-tailnet-ip>:5555 bağımsız değişkenini kullanmaya devam edin.

adb disconnect <android-tailnet-ip>:5555

​

Bağlantı çalıştırma kılavuzu

• Tercih edilen: https://<magicdns> / wss://<magicdns> ile Tailscale Serve / Funnel
• Ayrıca desteklenir: gerçek bir TLS uç noktasına sahip diğer tüm wss:// Gateway URL’leri
• Şifrelenmemiş ws://; özel LAN adreslerinde / .local ana makinelerinde, ayrıca localhost, 127.0.0.1 ve Android emülatör köprüsünde (10.0.2.2) desteklenmeye devam eder; geri döngü dışı kurulum otomatik olarak sınırlı operatör erişimini kullanır

​

Ön koşullar

• Gateway başka bir makinede çalışıyor (veya SSH aracılığıyla erişilebilir).
• Android cihazı/emülatörü Gateway WebSocket’e erişebiliyor:
  • mDNS/NSD ile aynı LAN’da, veya
  • Wide-Area Bonjour / tek noktaya yayın DNS-SD kullanılarak aynı Tailscale tailnet’inde (aşağıya bakın), veya
  • Elle girilen Gateway ana makinesi/bağlantı noktası (geri dönüş)
• Tailnet/genel mobil eşleştirme, ham tailnet IP ws:// uç noktalarını kullanmaz. Bunun yerine Tailscale Serve veya başka bir wss:// URL’si kullanın.
• Eşleştirme isteklerini onaylamak için Gateway makinesinde (veya SSH aracılığıyla) openclaw CLI bulunmalıdır.

​

1. Gateway’i başlatma

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2. Keşfi doğrulama (isteğe bağlı)

dns-sd -B _openclaw-gw._tcp local.

openclaw gateway discover --json

​

Tek noktaya yayın DNS-SD ile ağlar arası keşif

1. Gateway ana makinesinde bir DNS-SD bölgesi (örnek: openclaw.internal.) kurun ve _openclaw-gw._tcp kayıtlarını yayımlayın.
2. Seçtiğiniz etki alanı için bu DNS sunucusunu işaret eden Tailscale bölünmüş DNS’i yapılandırın.

​

3. Android’den bağlanma

• Uygulama, Gateway bağlantısını bir ön plan hizmeti (kalıcı bildirim) aracılığıyla etkin tutar.
• Connect sekmesini açın.
• Setup Code veya Manual modunu kullanın.
• Keşif engelleniyorsa Advanced controls bölümünde ana makineyi/bağlantı noktasını elle girin. Özel LAN ana makinelerinde ws:// çalışmaya devam eder. Tailscale/genel ana makinelerde TLS’yi açın ve bir wss:// / Tailscale Serve uç noktası kullanın.

​

Eşleştirilmiş Gateway’leri yönetme

• Ayarlar → Gateway, odaklanmış olan işaretlenmiş şekilde eşleştirilmiş Gateway’leri listeler. Odaklamak için bir girdiye dokunun; etkin olan diğer operatör oturumları bağlı kalır.
• Her anahtar, uygulama ön plandayken odaklanılmayan ilgili Gateway’in bağlı kalıp kalmayacağını denetler. Odaklanmış Gateway etkin kalır ve telefonun Node bağlantısıyla cihaz yeteneklerinin sahibi olur.
• Birden fazla Gateway eşleştirildiğinde Bağlan sekmesi hızlı bir değiştirici gösterir.
• Kimlik bilgileri, cihaz token’ları, TLS güveni, sohbet geçmişi ve kuyruğa alınmış çevrimdışı mesajlar Gateway başına saklanır. Odağı değiştirmek Gateway’ler arasındaki durumları asla karıştırmaz ve çevrimdışıyken kuyruğa alınan mesajlar yalnızca yazıldıkları Gateway’e teslim edilir.
• Unut, bir Gateway’in kayıt girdisini kimlik bilgileri, cihaz token’ları, TLS sabitlemesi ve önbelleğe alınmış sohbetleriyle birlikte kaldırır.

​

Canlılık bildirim sinyalleri

​

4. Eşleştirmeyi onaylama (CLI)

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

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

​

5. Node’un bağlı olduğunu doğrulama

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

​

6. Sohbet + geçmiş

• Geçmiş: chat.history (görüntüleme için normalleştirilmiştir — satır içi yönerge etiketleri, düz metin araç çağrısı XML yükleri (<tool_call>, <function_call>, <tool_calls>, <function_calls> ve kesilmiş varyantları) ve sızmış ASCII/tam genişlikli model kontrol token’ları kaldırılır; tam olarak NO_REPLY / no_reply olan sessiz token’lı asistan satırları atlanır; aşırı büyük satırlar yer tutucularla değiştirilebilir)
• Gönderme: chat.send
• Kalıcı gönderim: her gönderim (metin, seçilmiş görseller ve sesli notlar), herhangi bir ağ denemesinden önce Gateway başına cihaz üzerindeki bir giden kutusuna kaydedilir; böylece uygulamanın sonlandırılması gönderilmiş girdilerin kaybolmasına neden olmaz. Çevrimdışıyken kuyruğa alınan gönderimler, kararlı idempotency anahtarlarıyla yeniden bağlanıldığında sırayla teslim edilir ve bir gönderim yalnızca tur, standart chat.history içinde görünür olduktan sonra tamamlanmış sayılır; tek başına onay, teslimat kanıtı olarak değerlendirilmez. Belirsiz sonuçlar (kaybolan onay, gönderim sırasında uygulamanın kapatılması, döküm yazılmadan önce Gateway’in yeniden başlatılması), otomatik yeniden gönderim yerine açık Yeniden dene/Sil seçenekleri bulunan görünür satırlar olarak gösterilir. Eğik çizgi komutları yeniden bağlantı sonrasında asla otomatik olarak yeniden yürütülmez; açıkça yeniden denenmek üzere bekletilir. Kuyruk sınırlıdır (Gateway başına 50 mesaj ve 48 MB ek baytı) ve gönderilmemiş satırların süresi 48 saat sonra dolar. Hiç gönderilmemiş düzenleyici taslakları süreçler arasında kalıcı değildir.
• Anlık güncellemeler (en iyi çaba): chat.subscribe -> event:"chat"
• Dinleme: dinlemek için bir asistan mesajına uzun basın ve Dinle seçeneğini belirleyin; ses, yapılandırılmış TTS sağlayıcı zinciriyle Gateway tts.speak üzerinden oluşturulur ve Gateway ses oluşturamadığında cihazdaki sistem TTS’si kullanılır. Oturum değiştirildiğinde, yeni sohbet başlatıldığında, uygulama arka plana geçtiğinde veya sohbet kapatıldığında oynatma durur.

​

7. Canvas + kamera

​

Gateway Canvas Sunucusu (web içeriği için önerilir)

1. Gateway ana makinesinde ~/.openclaw/workspace/canvas/index.html oluşturun.
2. Node’u buna yönlendirin (LAN):

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

• canvas.eval, canvas.snapshot, canvas.navigate (varsayılan iskelete dönmek için {"url":""} veya {"url":"/"} kullanın). canvas.snapshot, { format, base64 } döndürür (varsayılan format="jpeg").
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL eski diğer adıdır). Bunlar eylem özellikli görüntüleme için paketle gelen ve uygulamaya ait A2UI sayfasını kullanır.

​

8. Ses + genişletilmiş Android komut yüzeyi

• Android kabuk gezintisi Ana Sayfa, Sohbet ve Ayarlar bölümlerinden oluşur. Sesli giriş Sohbet düzenleyicisine aittir; ayrı bir Ses sekmesi yoktur.
• Taslağa döküm ekleyen cihaz üzerindeki konuşma tanımayı kullanmak için düzenleyici mikrofonuna dokunun. Sesli not eki kaydetmek için mikrofona uzun basın. Kullanıcı arayüzü, denemeyi sessizce yok saymak yerine kullanılamayan tanımayı, eksik izni, meşgul/ağ hatalarını ve konuşma algılanmaması sonuçlarını bildirir.
• Sohbet dalga biçiminden sürekli Konuşma modunu başlatın. Dikte, sesli not kaydı ve Konuşma, birbirini dışlayan mikrofon yollarıdır.
• Konuşma Modu, yakalama başlamadan önce mevcut ön plan hizmetini connectedDevice düzeyinden connectedDevice|microphone düzeyine yükseltir ve Konuşma Modu durduğunda eski düzeyine indirir. Node hizmeti, CHANGE_NETWORK_STATE ile FOREGROUND_SERVICE_CONNECTED_DEVICE bildirir; Android 14+ ayrıca FOREGROUND_SERVICE_MICROPHONE bildirimini, RECORD_AUDIO çalışma zamanı iznini ve çalışma zamanında mikrofon hizmeti türünü gerektirir.
• Android Konuşma varsayılan olarak yerel konuşma tanımayı, Gateway sohbetini ve yapılandırılmış Gateway Konuşma sağlayıcısı aracılığıyla talk.speak kullanır. Yerel sistem TTS’si yalnızca talk.speak kullanılamadığında kullanılır.
• Android Konuşma, gerçek zamanlı Gateway aktarımını yalnızca talk.realtime.mode değeri realtime ve talk.realtime.transport değeri gateway-relay olduğunda kullanır.
• Android, voiceWake yeteneğini duyurmaz. Sesli giriş için Sohbet diktesini, sesli notu veya Konuşma’yı kullanın.
• Ek Android komut aileleri (kullanılabilirlik cihaza, izinlere ve kullanıcı ayarlarına bağlıdır):
  • device.status, device.info, device.permissions, device.health
  • device.apps yalnızca Ayarlar > Telefon Yetenekleri > Yüklü Uygulamalar etkinleştirildiğinde kullanılabilir; varsayılan olarak başlatıcıda görünen uygulamaları listeler (tam liste için includeNonLaunchable geçirin).
  • notifications.list, notifications.actions (aşağıdaki Bildirim yönlendirme bölümüne bakın)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

9. Çalışma alanı dosyaları (salt okunur)

​

Komut onaylarını inceleme

​

Ajan sorularını yanıtlama

​

Asistan giriş noktaları

​

Bildirim yönlendirme

​

İlgili

• iOS uygulaması
• Node’lar
• Android Node sorun giderme