---
read_when:
    - از کانال قدیمی BlueBubbles استفاده کرده‌اید و باید به iMessage مهاجرت کنید
    - شما در حال انتخاب راه‌اندازی پشتیبانی‌شدهٔ OpenClaw برای iMessage هستید
    - به توضیح کوتاهی دربارهٔ حذف BlueBubbles نیاز دارید
summary: پشتیبانی BlueBubbles از OpenClaw حذف شد. برای راه‌اندازی‌های جدید و مهاجرت‌داده‌شدهٔ iMessage، از Plugin همراه iMessage با imsg استفاده کنید.
title: حذف BlueBubbles و مسیر imsg برای iMessage
x-i18n:
    generated_at: "2026-05-11T20:20:42Z"
    model: gpt-5.5
    provider: openai
    source_hash: 970e33772534fd3e3d8d3012222bdd9c645ed713b8d38cff21b25b276ae1f544
    source_path: announcements/bluebubbles-imessage.md
    workflow: 16
---

# حذف BlueBubbles و مسیر imsg برای iMessage

OpenClaw دیگر کانال BlueBubbles را ارائه نمی‌کند. پشتیبانی iMessage اکنون از طریق Plugin داخلی `imessage` اجرا می‌شود که [`imsg`](https://github.com/steipete/imsg) را به‌صورت محلی یا از طریق یک پوشش SSH راه‌اندازی می‌کند و با JSON-RPC روی stdin/stdout ارتباط می‌گیرد.

اگر پیکربندی شما هنوز شامل `channels.bluebubbles` است، آن را به `channels.imessage` مهاجرت دهید. نشانی مستندات قدیمی `/channels/bluebubbles` به [مهاجرت از BlueBubbles](/fa/channels/imessage-from-bluebubbles) هدایت می‌شود که جدول کامل تبدیل پیکربندی و چک‌لیست جابه‌جایی را دارد.

## چه چیزی تغییر کرد

- در مسیر پشتیبانی‌شده OpenClaw برای iMessage، هیچ سرور HTTP مربوط به BlueBubbles، مسیر webhook، گذرواژه REST، یا runtime مربوط به Plugin BlueBubbles وجود ندارد.
- OpenClaw پیام‌ها را از طریق `imsg` روی همان Mac که Messages.app در آن وارد حساب شده است می‌خواند و پایش می‌کند.
- ارسال، دریافت، تاریخچه، و رسانه‌های پایه از سطح‌های معمول `imsg` و مجوزهای macOS استفاده می‌کنند.
- کنش‌های پیشرفته مانند پاسخ‌های رشته‌ای، tapbackها، ویرایش، لغو ارسال، افکت‌ها، رسیدهای خواندن، نشانگرهای در حال تایپ، و مدیریت گروه به `imsg launch` همراه با پل API خصوصی در دسترس نیاز دارند.
- Gatewayهای Linux و Windows همچنان می‌توانند با تنظیم `channels.imessage.cliPath` روی یک پوشش SSH که `imsg` را روی Mac واردشده اجرا می‌کند، از iMessage استفاده کنند.

## چه کاری انجام دهید

1. `imsg` را روی Mac مربوط به Messages نصب و تأیید کنید:

   ```bash
   brew install steipete/tap/imsg
   imsg --version
   imsg chats --limit 3
   imsg rpc --help
   ```

2. مجوزهای Full Disk Access و Automation را به زمینه فرایندی که `imsg` و OpenClaw را اجرا می‌کند اعطا کنید.

3. پیکربندی قدیمی را تبدیل کنید:

   ```json5
   {
     channels: {
       imessage: {
         enabled: true,
         cliPath: "/opt/homebrew/bin/imsg",
         dmPolicy: "pairing",
         allowFrom: ["+15555550123"],
         groupPolicy: "allowlist",
         groupAllowFrom: ["+15555550123"],
         groups: {
           "*": { requireMention: true },
         },
         includeAttachments: true,
       },
     },
   }
   ```

4. Gateway را بازراه‌اندازی و تأیید کنید:

   ```bash
   openclaw channels status --probe
   ```

5. پیش از حذف سرور قدیمی BlueBubbles خود، پیام‌های مستقیم، گروه‌ها، پیوست‌ها، و هر کنش API خصوصی‌ای را که به آن وابسته‌اید آزمایش کنید.

## یادداشت‌های مهاجرت

- `channels.bluebubbles.serverUrl` و `channels.bluebubbles.password` معادل iMessage ندارند.
- `channels.bluebubbles.allowFrom`، `groupAllowFrom`، `groups`، `includeAttachments`، ریشه‌های پیوست، محدودیت‌های اندازه رسانه، قطعه‌بندی، و کلیدهای کنش معادل‌های iMessage دارند.
- `channels.imessage.includeAttachments` همچنان به‌صورت پیش‌فرض خاموش است. اگر انتظار دارید عکس‌های ورودی، یادداشت‌های صوتی، ویدیوها، یا فایل‌ها به agent برسند، آن را صریحاً تنظیم کنید.
- با `groupPolicy: "allowlist"`، بلوک قدیمی `groups` را، از جمله هر ورودی wildcard با مقدار `"*"`، کپی کنید. فهرست‌های مجاز فرستنده گروه و رجیستری گروه دروازه‌های جداگانه‌ای هستند.
- اتصال‌های ACP که با `channel: "bluebubbles"` مطابقت داشتند باید به `channel: "imessage"` تغییر کنند.
- کلیدهای نشست قدیمی BlueBubbles به کلیدهای نشست iMessage تبدیل نمی‌شوند. تأییدهای pairing بر اساس handle منتقل می‌شوند، اما تاریخچه گفت‌وگو زیر کلیدهای نشست BlueBubbles منتقل نمی‌شود.

## همچنین ببینید

- [مهاجرت از BlueBubbles](/fa/channels/imessage-from-bluebubbles)
- [iMessage](/fa/channels/imessage)
- [مرجع پیکربندی - iMessage](/fa/gateway/config-channels#imessage)