---
read_when:
    - می‌خواهید OpenClaw از محیط اصلی macOS شما جدا باشد
    - شما یکپارچه‌سازی iMessage را در یک محیط ایزوله می‌خواهید
    - به یک محیط macOS قابل بازنشانی نیاز دارید که بتوانید آن را کلون کنید
    - می‌خواهید گزینه‌های ماشین مجازی macOS محلی را با گزینه‌های میزبانی‌شده مقایسه کنید
summary: OpenClaw را هنگامی که به ایزوله‌سازی یا iMessage نیاز دارید، در یک VM سندباکس‌شدهٔ macOS (محلی یا میزبانی‌شده) اجرا کنید
title: ماشین‌های مجازی macOS
x-i18n:
    generated_at: "2026-05-10T19:50:02Z"
    model: gpt-5.5
    provider: openai
    source_hash: 3502ccaee51261573764440f9e782d2512e9da0332bd15eef3a5c4a83b0c2936
    source_path: install/macos-vm.md
    workflow: 16
---

## پیش‌فرض پیشنهادی (اکثر کاربران)

- **VPS کوچک لینوکسی** برای Gateway همیشه‌روشن و هزینه کم. [میزبانی VPS](/fa/vps) را ببینید.
- **سخت‌افزار اختصاصی** (Mac mini یا دستگاه Linux) اگر کنترل کامل و یک **IP خانگی** برای خودکارسازی مرورگر می‌خواهید. بسیاری از سایت‌ها IPهای مرکز داده را مسدود می‌کنند، بنابراین مرور محلی اغلب بهتر کار می‌کند.
- **ترکیبی:** Gateway را روی یک VPS ارزان نگه دارید و وقتی به خودکارسازی مرورگر/UI نیاز دارید، Mac خود را به‌عنوان یک **Node** وصل کنید. [Nodeها](/fa/nodes) و [Gateway از راه دور](/fa/gateway/remote) را ببینید.

وقتی به‌طور مشخص به قابلیت‌های فقط macOS مانند iMessage نیاز دارید یا می‌خواهید از Mac روزمره خود جداسازی سخت‌گیرانه داشته باشید، از یک VM macOS استفاده کنید.

## گزینه‌های VM macOS

### VM محلی روی Apple Silicon Mac شما (Lume)

OpenClaw را با استفاده از [Lume](https://cua.ai/docs/lume) در یک VM macOS سندباکس‌شده روی Apple Silicon Mac موجود خود اجرا کنید.

این به شما می‌دهد:

- محیط کامل macOS در حالت جداشده (میزبان شما تمیز می‌ماند)
- پشتیبانی iMessage از طریق `imsg` (مسیر محلی پیش‌فرض روی Linux/Windows غیرممکن است)
- بازنشانی فوری با کلون‌کردن VMها
- بدون سخت‌افزار اضافه یا هزینه ابری

### ارائه‌دهندگان Mac میزبانی‌شده (ابر)

اگر macOS را در ابر می‌خواهید، ارائه‌دهندگان Mac میزبانی‌شده هم کار می‌کنند:

- [MacStadium](https://www.macstadium.com/) (Macهای میزبانی‌شده)
- فروشندگان دیگر Mac میزبانی‌شده هم کار می‌کنند؛ مستندات VM + SSH آن‌ها را دنبال کنید

پس از اینکه به یک VM macOS دسترسی SSH داشتید، از گام ۶ زیر ادامه دهید.

---

## مسیر سریع (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 یا جدیدتر روی میزبان
- حدود ۶۰ GB فضای دیسک آزاد برای هر VM
- حدود ۲۰ دقیقه

---

## 1) نصب Lume

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

اگر `~/.local/bin` در PATH شما نیست:

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

بررسی کنید:

```bash
lume --version
```

مستندات: [نصب Lume](https://cua.ai/docs/lume/guide/getting-started/installation)

---

## 2) ساخت VM macOS

```bash
lume create openclaw --os macos --ipsw latest
```

این فرمان macOS را دانلود می‌کند و VM را می‌سازد. یک پنجره VNC به‌طور خودکار باز می‌شود.

<Note>
بسته به اتصال شما، دانلود ممکن است مدتی طول بکشد.
</Note>

---

## 3) تکمیل Setup Assistant

در پنجره VNC:

1. زبان و منطقه را انتخاب کنید
2. Apple ID را رد کنید (یا اگر بعدا iMessage می‌خواهید وارد شوید)
3. یک حساب کاربری بسازید (نام کاربری و رمز عبور را به خاطر بسپارید)
4. همه قابلیت‌های اختیاری را رد کنید

پس از تکمیل راه‌اندازی، SSH را فعال کنید:

1. System Settings → General → Sharing را باز کنید
2. "Remote Login" را فعال کنید

---

## 4) دریافت نشانی IP مربوط به VM

```bash
lume get openclaw
```

نشانی IP را پیدا کنید (معمولا `192.168.64.x`).

---

## 5) ورود SSH به VM

```bash
ssh youruser@192.168.64.X
```

`youruser` را با حسابی که ساختید، و IP را با IP مربوط به VM خود جایگزین کنید.

---

## 6) نصب OpenClaw

داخل VM:

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

اعلان‌های onboarding را دنبال کنید تا ارائه‌دهنده مدل خود را تنظیم کنید (Anthropic، OpenAI و غیره).

---

## 7) پیکربندی کانال‌ها

فایل پیکربندی را ویرایش کنید:

```bash
nano ~/.openclaw/openclaw.json
```

کانال‌های خود را اضافه کنید:

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

سپس به WhatsApp وارد شوید (QR را اسکن کنید):

```bash
openclaw channels login
```

---

## 8) اجرای VM بدون نمایشگر

VM را متوقف کنید و بدون نمایشگر دوباره راه‌اندازی کنید:

```bash
lume stop openclaw
lume run openclaw --no-display
```

VM در پس‌زمینه اجرا می‌شود. daemon مربوط به OpenClaw، Gateway را در حال اجرا نگه می‌دارد.

برای بررسی وضعیت:

```bash
ssh youruser@192.168.64.X "openclaw status"
```

---

## پاداش: یکپارچه‌سازی iMessage

این قابلیت برجسته اجرای OpenClaw روی macOS است. از [iMessage](/fa/channels/imessage) همراه با `imsg` استفاده کنید تا Messages را به OpenClaw اضافه کنید.

داخل VM:

1. وارد Messages شوید.
2. `imsg` را نصب کنید.
3. برای فرایندی که OpenClaw/`imsg` را اجرا می‌کند، مجوز Full Disk Access و Automation را بدهید.
4. پشتیبانی RPC را با `imsg rpc --help` بررسی کنید.

به پیکربندی OpenClaw خود اضافه کنید:

```json5
{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}
```

Gateway را دوباره راه‌اندازی کنید. اکنون عامل شما می‌تواند iMessageها را ارسال و دریافت کند.

جزئیات کامل راه‌اندازی: [کانال iMessage](/fa/channels/imessage)

---

## ذخیره یک تصویر طلایی

پیش از سفارشی‌سازی بیشتر، از وضعیت تمیز خود snapshot بگیرید:

```bash
lume stop openclaw
lume clone openclaw openclaw-golden
```

هر زمان بازنشانی کنید:

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

---

## اجرای ۲۴/۷

VM را با این کارها در حال اجرا نگه دارید:

- Mac خود را به برق وصل نگه دارید
- sleep را در System Settings → Energy Saver غیرفعال کنید
- در صورت نیاز از `caffeinate` استفاده کنید

برای حالت واقعا همیشه‌روشن، یک Mac mini اختصاصی یا یک VPS کوچک را در نظر بگیرید. [میزبانی VPS](/fa/vps) را ببینید.

---

## عیب‌یابی

| مشکل                         | راه‌حل                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------ |
| نمی‌توان با SSH وارد VM شد   | بررسی کنید "Remote Login" در System Settings مربوط به VM فعال باشد                         |
| IP مربوط به VM نمایش داده نمی‌شود | صبر کنید VM کامل بوت شود، سپس دوباره `lume get openclaw` را اجرا کنید                     |
| فرمان Lume پیدا نمی‌شود      | `~/.local/bin` را به PATH خود اضافه کنید                                                   |
| QR واتساپ اسکن نمی‌شود       | هنگام اجرای `openclaw channels login` مطمئن شوید وارد VM هستید (نه میزبان)                 |

---

## مستندات مرتبط

- [میزبانی VPS](/fa/vps)
- [Nodeها](/fa/nodes)
- [Gateway از راه دور](/fa/gateway/remote)
- [کانال iMessage](/fa/channels/imessage)
- [شروع سریع Lume](https://cua.ai/docs/lume/guide/getting-started/quickstart)
- [مرجع CLI برای Lume](https://cua.ai/docs/lume/reference/cli-reference)
- [راه‌اندازی VM بدون نظارت](https://cua.ai/docs/lume/guide/fundamentals/unattended-setup) (پیشرفته)
- [سندباکس‌سازی Docker](/fa/install/docker) (رویکرد جایگزین برای جداسازی)