Ana içeriğe atla

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.

​
Önerilen varsayılan (çoğu kullanıcı)

  • Her zaman açık Gateway ve düşük maliyet için küçük Linux VPS. Bkz. VPS barındırma.
  • Tarayıcı otomasyonu için tam kontrol ve konut IP adresi istiyorsanız özel donanım (Mac mini veya Linux kutusu). Birçok site veri merkezi IP adreslerini engeller, bu nedenle yerel gezinme çoğu zaman daha iyi çalışır.
  • Hibrit: Gateway’i ucuz bir VPS üzerinde tutun ve tarayıcı/UI otomasyonuna ihtiyaç duyduğunuzda Mac’inizi bir Node olarak bağlayın. Bkz. Node’lar ve Gateway uzak bağlantısı.
macOS’a özgü iMessage gibi yeteneklere özellikle ihtiyaç duyduğunuzda veya günlük Mac’inizden sıkı yalıtım istediğinizde bir macOS VM kullanın.

​
macOS VM seçenekleri

​
Apple Silicon Mac’inizde yerel VM (Lume)

Mevcut Apple Silicon Mac’inizde Lume kullanarak OpenClaw’ı korumalı bir macOS VM içinde çalıştırın. Bu size şunları sağlar:
  • Yalıtılmış tam macOS ortamı (ana makineniz temiz kalır)
  • imsg üzerinden iMessage desteği (varsayılan yerel yol Linux/Windows üzerinde mümkün değildir)
  • VM’leri klonlayarak anında sıfırlama
  • Ek donanım veya bulut maliyeti yok

​
Barındırılan Mac sağlayıcıları (bulut)

Bulutta macOS istiyorsanız, barındırılan Mac sağlayıcıları da çalışır:
  • MacStadium (barındırılan Mac’ler)
  • Diğer barındırılan Mac satıcıları da çalışır; onların VM + SSH belgelerini izleyin
Bir macOS VM’ye SSH erişiminiz olduğunda, aşağıdaki 6. adımdan devam edin.

​
Hızlı yol (Lume, deneyimli kullanıcılar)

  1. Lume’u yükleyin
  2. lume create openclaw --os macos --ipsw latest
  3. Kurulum Yardımcısı’nı tamamlayın, Uzaktan Oturum Açma’yı (SSH) etkinleştirin
  4. lume run openclaw --no-display
  5. SSH ile bağlanın, OpenClaw’ı yükleyin, kanalları yapılandırın
  6. Tamamlandı

​
Gerekenler (Lume)

  • Apple Silicon Mac (M1/M2/M3/M4)
  • Ana makinede macOS Sequoia veya sonrası
  • VM başına ~60 GB boş disk alanı
  • ~20 dakika

​
1) Lume’u yükleyin

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
~/.local/bin PATH’inizde değilse: 
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
Doğrulayın: 
lume --version
Belgeler: Lume Kurulumu

​
2) macOS VM’yi oluşturun

lume create openclaw --os macos --ipsw latest
Bu komut macOS’u indirir ve VM’yi oluşturur. Bir VNC penceresi otomatik olarak açılır.
İndirme, bağlantınıza bağlı olarak biraz zaman alabilir.

​
3) Kurulum Yardımcısı’nı tamamlayın

VNC penceresinde:
  1. Dil ve bölge seçin
  2. Apple ID’yi atlayın (veya daha sonra iMessage istiyorsanız giriş yapın)
  3. Bir kullanıcı hesabı oluşturun (kullanıcı adını ve parolayı unutmayın)
  4. Tüm isteğe bağlı özellikleri atlayın
Kurulum tamamlandıktan sonra SSH’yi etkinleştirin:
  1. Sistem Ayarları → Genel → Paylaşım’ı açın
  2. “Uzaktan Oturum Açma”yı etkinleştirin

​
4) VM IP adresini alın

lume get openclaw
IP adresini arayın (genellikle 192.168.64.x).

​
5) VM’ye SSH ile bağlanın

ssh youruser@192.168.64.X
youruser yerine oluşturduğunuz hesabı, IP yerine de VM’nizin IP adresini yazın.

​
6) OpenClaw’ı yükleyin

VM içinde: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Model sağlayıcınızı (Anthropic, OpenAI vb.) ayarlamak için başlangıç istemlerini izleyin.

​
7) Kanalları yapılandırın

Yapılandırma dosyasını düzenleyin: 
nano ~/.openclaw/openclaw.json
Kanallarınızı ekleyin: 
{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
  },
}
Ardından WhatsApp’a giriş yapın (QR tarayın): 
openclaw channels login

​
8) VM’yi başsız çalıştırın

VM’yi durdurun ve ekransız yeniden başlatın: 
lume stop openclaw
lume run openclaw --no-display
VM arka planda çalışır. OpenClaw’ın daemon’u Gateway’i çalışır durumda tutar. Durumu kontrol etmek için: 
ssh youruser@192.168.64.X "openclaw status"

​
Bonus: iMessage entegrasyonu

macOS üzerinde çalıştırmanın öne çıkan özelliği budur. Mesajlar’ı OpenClaw’a eklemek için imsg ile iMessage kullanın. VM içinde:
  1. Mesajlar’a giriş yapın.
  2. imsg yükleyin.
  3. OpenClaw/imsg çalıştıran işleme Tam Disk Erişimi ve Otomasyon izni verin.
  4. RPC desteğini imsg rpc --help ile doğrulayın.
OpenClaw yapılandırmanıza ekleyin: 
{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}
Gateway’i yeniden başlatın. Artık agent’ınız iMessage gönderebilir ve alabilir. Tam kurulum ayrıntıları: iMessage kanalı

​
Altın imaj kaydedin

Daha fazla özelleştirmeden önce temiz durumunuzun anlık görüntüsünü alın: 
lume stop openclaw
lume clone openclaw openclaw-golden
İstediğiniz zaman sıfırlayın: 
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

​
7/24 çalıştırma

VM’yi çalışır durumda tutmak için:
  • Mac’inizi prize takılı tutun
  • Sistem Ayarları → Enerji Tasarrufu içinde uyku modunu devre dışı bırakın
  • Gerekirse caffeinate kullanın
Gerçek anlamda her zaman açık kullanım için özel bir Mac mini veya küçük bir VPS düşünün. Bkz. VPS barındırma.

​
Sorun giderme

SorunÇözüm
VM’ye SSH ile bağlanılamıyorVM’nin Sistem Ayarları’nda “Uzaktan Oturum Açma”nın etkin olduğunu kontrol edin
VM IP’si görünmüyorVM’nin tamamen açılmasını bekleyin, lume get openclaw komutunu tekrar çalıştırın
Lume komutu bulunamadı~/.local/bin dizinini PATH’inize ekleyin
WhatsApp QR taranmıyoropenclaw channels login çalıştırırken VM’ye (ana makineye değil) giriş yaptığınızdan emin olun

​
İlgili belgeler