macOS VMs پر OpenClaw (Sandboxing)¶

سفارش کردہ ڈیفالٹ (زیادہ تر صارفین)¶

• ہمیشہ آن رہنے والے Gateway اور کم لاگت کے لیے Small Linux VPS۔ مزید دیکھیں VPS hosting.
• اگر آپ مکمل کنٹرول اور براؤزر آٹومیشن کے لیے residential IP چاہتے ہیں تو Dedicated hardware (Mac mini یا Linux box) استعمال کریں۔ بہت سی ویب سائٹس ڈیٹا سینٹر IPs کو بلاک کر دیتی ہیں، اس لیے مقامی براؤزنگ اکثر بہتر کام کرتی ہے۔
• Hybrid: سستا VPS پر Gateway رکھیں، اور جب براؤزر/UI آٹومیشن کی ضرورت ہو تو اپنے Mac کو بطور node منسلک کریں۔ دیکھیں Nodes اور Gateway remote.

macOS VM اس وقت استعمال کریں جب آپ کو خاص طور پر macOS تک محدود صلاحیتوں (iMessage/BlueBubbles) کی ضرورت ہو یا اپنے روزمرہ Mac سے سخت علیحدگی چاہتے ہوں۔

macOS VM کے اختیارات¶

آپ کے Apple Silicon Mac پر لوکل VM (Lume)¶

اپنے موجودہ Apple Silicon Mac پر Lume استعمال کرتے ہوئے sandboxed macOS VM میں OpenClaw چلائیں۔

اس سے آپ کو ملتا ہے:

• مکمل macOS ماحول علیحدگی کے ساتھ (آپ کا ہوسٹ صاف رہتا ہے)
• BlueBubbles کے ذریعے iMessage سپورٹ (Linux/Windows پر ناممکن)
• VM کلوننگ کے ذریعے فوری ری سیٹ
• اضافی ہارڈویئر یا کلاؤڈ لاگت نہیں

ہوسٹڈ Mac فراہم کنندگان (کلاؤڈ)¶

اگر آپ کو کلاؤڈ میں macOS چاہیے، تو ہوسٹڈ Mac فراہم کنندگان بھی کام کرتے ہیں:

• MacStadium (ہوسٹڈ Macs)
• دیگر ہوسٹڈ Mac وینڈرز بھی کام کرتے ہیں؛ ان کی VM + SSH دستاویزات کی پیروی کریں

جیسے ہی آپ کو macOS VM تک SSH رسائی مل جائے، نیچے مرحلہ 6 سے آگے بڑھیں۔

---

فوری راستہ (Lume، تجربہ کار صارفین)¶

1. Lume انسٹال کریں
2. lume create openclaw --os macos --ipsw latest
3. Setup Assistant مکمل کریں، Remote Login (SSH) فعال کریں
4. lume run openclaw --no-display
5. SSH کے ذریعے لاگ ان ہوں، OpenClaw انسٹال کریں، چینلز کنفیگر کریں
6. مکمل

---

آپ کو کیا درکار ہے (Lume)¶

• Apple Silicon Mac (M1/M2/M3/M4)
• ہوسٹ پر macOS Sequoia یا اس کے بعد
• فی VM تقریباً 60 GB خالی ڈسک اسپیس
• تقریباً 20 منٹ

---

1. Lume انسٹال کریں¶

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

اگر ~/.local/bin آپ کے PATH میں نہیں ہے:

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

تصدیق کریں:

lume --version

دستاویزات: Lume Installation

---

2. macOS VM بنائیں¶

lume create openclaw --os macos --ipsw latest

یہ macOS ڈاؤن لوڈ کرتا ہے اور VM بناتا ہے۔ ایک VNC ونڈو خودکار طور پر کھل جاتی ہے۔

نوٹ: آپ کے کنکشن پر منحصر ہے، ڈاؤن لوڈ میں کچھ وقت لگ سکتا ہے۔

---

3. Setup Assistant مکمل کریں¶

VNC ونڈو میں:

1. زبان اور علاقہ منتخب کریں
2. Apple ID چھوڑ دیں (یا اگر بعد میں iMessage چاہتے ہیں تو سائن اِن کریں)
3. ایک یوزر اکاؤنٹ بنائیں (یوزرنیم اور پاس ورڈ یاد رکھیں)
4. تمام اختیاری فیچرز چھوڑ دیں

سیٹ اپ مکمل ہونے کے بعد، SSH فعال کریں:

1. System Settings → General → Sharing کھولیں
2. "Remote Login" فعال کریں

---

4. VM کا IP ایڈریس حاصل کریں¶

lume get openclaw

IP ایڈریس تلاش کریں (عام طور پر 192.168.64.x)۔

---

5. VM میں SSH کریں¶

ssh youruser@192.168.64.X

youruser کو اس اکاؤنٹ سے بدلیں جو آپ نے بنایا ہے، اور IP کو اپنے VM کے IP سے بدلیں۔

---

6. OpenClaw انسٹال کریں¶

VM کے اندر:

npm install -g openclaw@latest
openclaw onboard --install-daemon

آن بورڈنگ پرامپٹس کی پیروی کریں تاکہ اپنے ماڈل فراہم کنندہ (Anthropic، OpenAI، وغیرہ) سیٹ اپ کریں۔

---

7. چینلز کنفیگر کریں¶

کنفیگ فائل ایڈٹ کریں:

nano ~/.openclaw/openclaw.json

اپنے چینلز شامل کریں:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    },
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

پھر WhatsApp میں لاگ ان کریں (QR اسکین کریں):

openclaw channels login

---

8. VM کو headless چلائیں¶

VM کو روکیں اور بغیر ڈسپلے کے دوبارہ شروع کریں:

lume stop openclaw
lume run openclaw --no-display

The VM runs in the background. OpenClaw's daemon keeps the gateway running.

اسٹیٹس چیک کرنے کے لیے:

ssh youruser@192.168.64.X "openclaw status"

---

بونس: iMessage انضمام¶

This is the killer feature of running on macOS. Use BlueBubbles to add iMessage to OpenClaw.

VM کے اندر:

1. bluebubbles.app سے BlueBubbles ڈاؤن لوڈ کریں
2. اپنے Apple ID سے سائن اِن کریں
3. Web API فعال کریں اور پاس ورڈ سیٹ کریں
4. BlueBubbles webhooks کو اپنے gateway کی طرف پوائنٹ کریں (مثال: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

اپنی OpenClaw کنفیگ میں شامل کریں:

{
  "channels": {
    "bluebubbles": {
      "serverUrl": "http://localhost:1234",
      "password": "your-api-password",
      "webhookPath": "/bluebubbles-webhook"
    }
  }
}

gateway کو ری اسٹارٹ کریں۔ Now your agent can send and receive iMessages.

مکمل سیٹ اپ کی تفصیلات: BlueBubbles channel

---

گولڈن امیج محفوظ کریں¶

مزید حسبِ منشا کرنے سے پہلے، اپنی صاف حالت کا اسنیپ شاٹ لیں:

lume stop openclaw
lume clone openclaw openclaw-golden

کسی بھی وقت ری سیٹ کریں:

lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

---

24/7 چلانا¶

VM کو چلتا رکھنے کے لیے:

• اپنے Mac کو پلگ اِن رکھیں
• System Settings → Energy Saver میں سلیپ غیر فعال کریں
• ضرورت ہو تو caffeinate استعمال کریں

For true always-on, consider a dedicated Mac mini or a small VPS. See VPS hosting.

---

خرابیوں کا ازالہ¶

مسئلہ	حل
VM میں SSH نہیں ہو رہا	تصدیق کریں کہ VM کی System Settings میں "Remote Login" فعال ہے
VM IP نظر نہیں آ رہا	VM کے مکمل بوٹ ہونے کا انتظار کریں، پھر lume get openclaw دوبارہ چلائیں
Lume کمانڈ نہیں مل رہی	~/.local/bin کو اپنے PATH میں شامل کریں
WhatsApp QR اسکین نہیں ہو رہا	یقینی بنائیں کہ openclaw channels login چلاتے وقت آپ VM میں لاگ اِن ہیں (ہوسٹ میں نہیں)

---

متعلقہ دستاویزات¶

• VPS hosting
• Nodes
• Gateway remote
• BlueBubbles channel
• Lume Quickstart
• Lume CLI Reference
• Unattended VM Setup (ایڈوانسڈ)
• Docker Sandboxing (متبادل علیحدگی کا طریقہ)