Ana içeriğe atla

​
Uzak OpenClaw (macOS ⇄ uzak ana makine)

Bu akış, macOS uygulamasının başka bir ana makinede (masaüstü/sunucu) çalışan bir OpenClaw gateway’i için tam teşekküllü bir uzaktan kumanda olarak çalışmasını sağlar. Bu, uygulamanın SSH üzerinden uzaktan bağlantı (remote run) özelliğidir. Tüm özellikler—sağlık kontrolleri, Voice Wake yönlendirme ve Web Chat—Ayarlar → Genel bölümündeki aynı uzak SSH yapılandırmasını yeniden kullanır.

​
Modlar

  • Yerel (bu Mac): Her şey dizüstünde çalışır. SSH yoktur.
  • SSH üzerinden uzaktan (varsayılan): OpenClaw komutları uzak ana makinede yürütülür. macOS uygulaması, -o BatchMode ile birlikte seçtiğiniz kimlik/anahtar ve bir yerel port yönlendirmesi kullanarak bir SSH bağlantısı açar.
  • Doğrudan uzaktan (ws/wss): SSH tüneli yoktur. macOS uygulaması gateway URL’sine doğrudan bağlanır (örneğin Tailscale Serve veya herkese açık bir HTTPS ters proxy üzerinden).

​
Uzak taşıma yöntemleri

Uzak mod iki taşıma yöntemini destekler:
  • SSH tüneli (varsayılan): Gateway portunu localhost’a yönlendirmek için ssh -N -L ... kullanır. Tünel local loopback olduğu için gateway, düğüm IP’sini 127.0.0.1 olarak görür.
  • Doğrudan (ws/wss): Gateway URL’sine doğrudan bağlanır. Gateway gerçek istemci IP’sini görür.

​
Uzak ana bilgisayardaki ön koşullar

  1. Node + pnpm’i kurun ve OpenClaw CLI’yi derleyip/yükleyin (pnpm install && pnpm build && pnpm link --global).
  2. Etkileşimsiz kabuklar için openclaw’in PATH üzerinde olduğundan emin olun (gerekirse /usr/local/bin veya /opt/homebrew/bin içine sembolik bağlantı oluşturun).
  3. Anahtar tabanlı kimlik doğrulama ile SSH’ı açın. LAN dışı stabil erişim için Tailscale IP’lerini öneririz.

​
macOS uygulama kurulumu

  1. Ayarlar → Genel bölümünü açın.
  2. OpenClaw runs altında SSH üzerinden uzaktan’ı seçin ve şunları ayarlayın:
    • Transport: SSH tüneli veya Doğrudan (ws/wss).
    • SSH target: user@host (isteğe bağlı :port).
      • Gateway aynı LAN üzerindeyse ve Bonjour yayımlıyorsa, alanı otomatik doldurmak için keşfedilen listeden seçin.
    • Gateway URL (yalnızca Doğrudan): wss://gateway.example.ts.net (yerel/LAN için ws://...).
    • Identity file (gelişmiş): anahtarınızın yolu.
    • Project root (gelişmiş): komutlar için kullanılan uzak depo yolu.
    • CLI path (gelişmiş): çalıştırılabilir bir openclaw giriş noktası/ikili dosya için isteğe bağlı yol (ilan edildiğinde otomatik doldurulur).
  3. Test remote’a tıklayın. Başarı, uzak openclaw status --json’ün doğru çalıştığını gösterir. Hatalar genellikle PATH/CLI sorunlarına işaret eder; çıkış 127, CLI’nin uzakta bulunamadığı anlamına gelir.
  4. Sağlık kontrolleri ve Web Chat artık otomatik olarak bu SSH tüneli üzerinden çalışır.

​
Web Sohbeti

  • SSH tüneli: Web Chat, yönlendirilmiş WebSocket kontrol portu (varsayılan 18789) üzerinden gateway’e bağlanır.
  • Doğrudan (ws/wss): Web Chat, yapılandırılmış gateway URL’sine doğrudan bağlanır.
  • Artık ayrı bir WebChat HTTP sunucusu yoktur.

​
Permissions

  • Uzak ana makine, yerel ile aynı TCC onaylarına ihtiyaç duyar (Otomasyon, Erişilebilirlik, Ekran Kaydı, Mikrofon, Konuşma Tanıma, Bildirimler). Bir kez vermek için o makinede onboarding’i çalıştırın.
  • Düğümler, ajanların nelerin kullanılabilir olduğunu bilmesi için izin durumlarını node.list / node.describe üzerinden ilan eder.

​
Güvenlik notları

  • Uzak ana makinede loopback bağlamalarını tercih edin ve SSH veya Tailscale üzerinden bağlanın.
  • Gateway’i loopback olmayan bir arayüze bağlarsanız, belirteç/parola ile kimlik doğrulama zorunlu kılın.
  • Security ve Tailscale bölümlerine bakın.

​
WhatsApp giriş akışı (uzak)

  • openclaw channels login --verbose’yı uzak ana makinede çalıştırın. QR kodunu telefonunuzdaki WhatsApp ile tarayın.
  • Kimlik doğrulama süresi dolarsa o ana makinede yeniden giriş yapın. Sağlık kontrolü bağlantı sorunlarını gösterecektir.

​
Sorun Giderme

  • exit 127 / not found: openclaw etkileşimsiz kabuklar için PATH üzerinde değil. /etc/paths’e, kabuk rc dosyanıza ekleyin veya /usr/local/bin//opt/homebrew/bin içine sembolik bağlantı oluşturun.
  • Health probe failed: SSH erişilebilirliğini, PATH’i ve Baileys’in giriş yapmış olduğunu kontrol edin (openclaw status --json).
  • Web Chat takılı kalıyor: gateway’in uzak ana makinede çalıştığını ve yönlendirilen portun gateway WS portuyla eşleştiğini doğrulayın; arayüz sağlıklı bir WS bağlantısı gerektirir.
  • Node IP 127.0.0.1 görünüyor: SSH tüneli ile beklenen davranıştır. Gateway’in gerçek istemci IP’sini görmesini istiyorsanız Transport’u Doğrudan (ws/wss) olarak değiştirin.
  • Voice Wake: tetikleyici ifadeler uzak modda otomatik olarak yönlendirilir; ayrı bir yönlendirici gerekmez.

​
Bildirim sesleri

Bildirim başına sesleri, openclaw ve node.invoke ile betiklerden seçin, örn.: 
openclaw nodes notify --node <id> --title "Ping" --body "Remote gateway ready" --sound Glass
Uygulamada artık genel bir “varsayılan ses” anahtarı yoktur; çağıranlar her istek için bir ses (ya da hiçbiri) seçer.