BlueBubbles से आ रहे हैं

BlueBubbles समर्थन हटा दिया गया है। OpenClaw अब iMessage का समर्थन केवल बंडल किए गए imessage Plugin के माध्यम से करता है, जो JSON-RPC पर steipete/imsg को संचालित करता है और उसी निजी API सतह तक पहुँचता है जो BlueBubbles के पास थी (react, edit, unsend, reply, sendWithEffect, नेटिव पोल, समूह प्रबंधन, अटैचमेंट)। एक CLI बाइनरी BlueBubbles सर्वर + क्लाइंट ऐप + Webhook व्यवस्था की जगह लेती है: कोई REST एंडपॉइंट नहीं, कोई Webhook प्रमाणीकरण नहीं।

यह मार्गदर्शिका पुराने channels.bluebubbles कॉन्फ़िगरेशन को channels.imessage में माइग्रेट करती है। कोई अन्य समर्थित माइग्रेशन पथ नहीं है। वर्तमान OpenClaw में बचा हुआ channels.bluebubbles ब्लॉक निष्क्रिय रहता है — कोई रनटाइम इसे नहीं पढ़ता।

माइग्रेशन चेकलिस्ट

जब आपको अपना पुराना BlueBubbles कॉन्फ़िगरेशन पहले से पता हो, तो सबसे छोटा सुरक्षित पथ:

1. Messages.app चलाने वाले Mac पर सीधे imsg सत्यापित करें (imsg chats, imsg history, imsg send, imsg rpc --help)।
2. channels.bluebubbles से व्यवहार कुंजियाँ channels.imessage में कॉपी करें: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups, includeAttachments, attachmentRoots, mediaMaxMb, textChunkLimit, coalesceSameSenderDms, और actions।
3. अब मौजूद न रहने वाली ट्रांसपोर्ट कुंजियाँ हटाएँ: serverUrl, password, Webhook URL और BlueBubbles सर्वर सेटअप।
4. यदि Gateway Messages Mac पर नहीं चल रहा है, तो channels.imessage.cliPath को SSH रैपर पर सेट करें और रिमोट अटैचमेंट प्राप्त करने के लिए remoteHost सेट करें।
5. channels.imessage सक्षम करें, Gateway पुनः आरंभ करें, फिर openclaw channels status --probe --channel imessage चलाएँ।
6. एक DM, एक अनुमत समूह, सक्षम होने पर अटैचमेंट और प्रत्येक निजी API क्रिया का परीक्षण करें जिसका एजेंट से उपयोग करवाना अपेक्षित है।
7. iMessage पथ सत्यापित होने के बाद BlueBubbles सर्वर और पुराना channels.bluebubbles कॉन्फ़िगरेशन हटा दें।

imsg क्या करता है

imsg Messages के लिए एक स्थानीय macOS CLI है। OpenClaw imsg rpc को चाइल्ड प्रोसेस के रूप में शुरू करता है और stdin/stdout पर JSON-RPC के माध्यम से संचार करता है। एक्सपोज़ करने के लिए कोई HTTP सर्वर, Webhook URL, बैकग्राउंड डेमन, लॉन्च एजेंट या पोर्ट नहीं है।

• रीड-ओनली SQLite हैंडल का उपयोग करके ~/Library/Messages/chat.db से रीड किए जाते हैं।
• लाइव इनबाउंड संदेश imsg watch / watch.subscribe से आते हैं, जो पोलिंग फ़ॉलबैक के साथ chat.db फ़ाइल सिस्टम इवेंट का अनुसरण करता है।
• सामान्य टेक्स्ट और फ़ाइल भेजने के लिए Messages.app ऑटोमेशन का उपयोग किया जाता है।
• उन्नत क्रियाएँ Messages.app में imsg सहायक को इंजेक्ट करने के लिए imsg launch का उपयोग करती हैं। इसी से रीड रिसीट, टाइपिंग संकेतक, रिच सेंड, संपादन, भेजना वापस लेना, थ्रेडेड उत्तर, टैपबैक, पोल और समूह प्रबंधन उपलब्ध होते हैं।
• Linux बिल्ड कॉपी किए गए chat.db का निरीक्षण कर सकते हैं, लेकिन भेज नहीं सकते, लाइव Mac डेटाबेस पर नज़र नहीं रख सकते या Messages.app को संचालित नहीं कर सकते। OpenClaw iMessage के लिए, साइन-इन किए हुए Mac पर या उस Mac तक पहुँचने वाले SSH रैपर के माध्यम से imsg चलाएँ।

शुरू करने से पहले

1. Messages.app चलाने वाले Mac पर imsg इंस्टॉल करें:

   brew install steipete/tap/imsgbrew update && brew upgrade imsgimsg --versionimsg chats --limit 3

   सामान्य स्थानीय सेटअप के लिए, OpenClaw सेटअप साइन-इन किए हुए Messages Mac पर imsg के लिए उपयोगकर्ता द्वारा पुष्टि किया गया Homebrew इंस्टॉल या अपडेट प्रस्तुत कर सकता है। मैन्युअल सेटअप और SSH-रैपर टोपोलॉजी का प्रबंधन ऑपरेटर के पास रहता है: उसी स्थानीय या रिमोट उपयोगकर्ता संदर्भ में Homebrew अपडेट दोहराएँ जिसमें imsg चलेगा। यदि imsg chats, unable to open database file, खाली आउटपुट या authorization denied के साथ विफल होता है, तो imsg लॉन्च करने वाले टर्मिनल, एडिटर, Node प्रोसेस, Gateway सेवा या SSH पैरेंट प्रोसेस को Full Disk Access दें, फिर उस पैरेंट प्रोसेस को दोबारा खोलें।

2. OpenClaw कॉन्फ़िगरेशन बदलने से पहले रीड, वॉच, सेंड और RPC सतहों को सत्यापित करें:

   imsg chats --limit 10 --json | jq -simsg history --chat-id 42 --limit 10 --attachments --json | jq -simsg watch --chat-id 42 --reactions --jsonimsg send --chat-id 42 --text "OpenClaw imsg test"imsg rpc --help

   42 को imsg chats से प्राप्त वास्तविक चैट आईडी से बदलें। भेजने के लिए Messages.app की Automation अनुमति आवश्यक है। यदि OpenClaw SSH के माध्यम से चलेगा, तो ये कमांड उसी SSH रैपर या उपयोगकर्ता संदर्भ के माध्यम से चलाएँ जिसका OpenClaw उपयोग करेगा। यदि रीड काम करते हैं लेकिन AppleEvents -1743 के साथ भेजना विफल होता है, तो जाँचें कि Automation /usr/libexec/sshd-keygen-wrapper पर लागू हुआ है या नहीं; SSH रैपर से भेजना AppleEvents -1743 के साथ विफल होता है देखें।

3. निजी API ब्रिज सक्षम करें। OpenClaw iMessage के लिए इसकी पुरज़ोर अनुशंसा की जाती है क्योंकि उत्तर, टैपबैक, इफ़ेक्ट, पोल, अटैचमेंट उत्तर और समूह क्रियाएँ इस पर निर्भर करती हैं:

   imsg launchimsg status --json

   imsg launch के लिए SIP अक्षम होना आवश्यक है (और आधुनिक macOS पर लाइब्रेरी सत्यापन को शिथिल करना भी आवश्यक है — imsg निजी API सक्षम करना देखें)। मूलभूत सेंड, हिस्ट्री और वॉच imsg launch के बिना काम करते हैं; पूर्ण OpenClaw iMessage क्रिया सतह काम नहीं करती।

4. channels.imessage सक्षम करने और Gateway शुरू करने के बाद, OpenClaw के माध्यम से ब्रिज को सत्यापित करें:

   openclaw channels status --probe

   iMessage खाते को works रिपोर्ट करना चाहिए; --json के साथ, प्रोब पेलोड में privateApi.available: true शामिल होता है। यदि यह false रिपोर्ट करता है, तो पहले उसे ठीक करें — क्षमता पहचान देखें। प्रोबिंग के लिए पहुँच योग्य Gateway आवश्यक है (अन्यथा CLI केवल कॉन्फ़िगरेशन आउटपुट पर फ़ॉलबैक करता है) और यह केवल कॉन्फ़िगर किए गए, सक्षम खातों को प्रोब करता है।

5. अपने कॉन्फ़िगरेशन का स्नैपशॉट बनाएँ:

   cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

कॉन्फ़िगरेशन रूपांतरण

iMessage और BlueBubbles अधिकांश चैनल-स्तरीय व्यवहार कुंजियाँ साझा करते हैं। ट्रांसपोर्ट (REST सर्वर बनाम स्थानीय CLI) और समूह रजिस्ट्री कुंजी का प्रारूप बदलता है।

बहु-अकाउंट कॉन्फ़िगरेशन (channels.bluebubbles.accounts.*), channels.imessage.accounts.* में एक-से-एक रूपांतरित होते हैं।

समूह रजिस्ट्री का खतरनाक पहलू

बंडल किया गया iMessage Plugin लगातार दो समूह गेट चलाता है। एजेंट तक पहुँचने के लिए समूह संदेश को दोनों से गुजरना आवश्यक है:

1. प्रेषक / चैट-लक्ष्य अनुमति-सूची (channels.imessage.groupAllowFrom) — प्रेषक हैंडल या चैट लक्ष्य (chat_id:, chat_guid:, chat_identifier: प्रविष्टियाँ) से मिलान करती है। जब groupAllowFrom सेट नहीं हो, तो यह गेट allowFrom पर फ़ॉलबैक करता है; स्पष्ट groupAllowFrom: [] उस फ़ॉलबैक को अक्षम करता है और groupPolicy: "allowlist" के अंतर्गत प्रत्येक समूह संदेश को छोड़ देता है।
2. समूह रजिस्ट्री (channels.imessage.groups) — संख्यात्मक iMessage chat_id द्वारा कुंजीबद्ध:
   • कोई groups ब्लॉक नहीं (या रिक्त ब्लॉक): जब तक गेट 1 में प्रभावी प्रेषक अनुमति-सूची रिक्त न हो, समूह इस गेट से गुजरते हैं; प्रेषक फ़िल्टरिंग पहुँच नियंत्रित करती है और स्टार्टअप पर सभी को छोड़ने की चेतावनी सक्रिय नहीं होती।
   • groups में प्रविष्टियाँ हों लेकिन "*" न हो: केवल सूचीबद्ध chat_id कुंजियाँ गुजरती हैं। किसी भी समूह को सूचीबद्ध करने से रजिस्ट्री, groupPolicy: "open" के अंतर्गत भी अनुमति-सूची बन जाती है।
   • groups: { "*": { ... } }: प्रत्येक समूह इस गेट से गुजरता है।

माइग्रेशन का जाल: BlueBubbles ने groups प्रविष्टियों को चैट GUID / चैट पहचानकर्ता द्वारा कुंजीबद्ध किया था, जबकि iMessage रजिस्ट्री संख्यात्मक chat_id द्वारा कुंजीबद्ध होती है। अक्षरशः कॉपी की गई प्रति-समूह प्रविष्टियाँ ऐसी गैर-रिक्त रजिस्ट्री बनाती हैं जिसकी कुंजियाँ कभी मेल नहीं खातीं, इसलिए प्रत्येक समूह संदेश गेट 2 पर छोड़ दिया जाता है। "*" वाइल्डकार्ड को अक्षरशः कॉपी करें; विशिष्ट समूह प्रविष्टियों को imsg chats से प्राप्त chat_id मानों के साथ नई कुंजी दें।

दोनों ड्रॉप पथ डिफ़ॉल्ट लॉग स्तर पर warn पंक्तियों के माध्यम से दिखाई देते हैं:

• स्टार्टअप पर प्रति अकाउंट एक बार, जब groupPolicy: "allowlist" सेट हो और प्रभावी समूह प्रेषक अनुमति-सूची रिक्त हो: imessage: groupPolicy="allowlist" for account "<id>" but no group sender allowlist is configured ...। प्रेषकों को अनुमति देने के लिए groupAllowFrom (या allowFrom) सेट करें; केवल groups जोड़ने से प्रेषक गेट संतुष्ट नहीं होता।
• रनटाइम पर प्रति chat_id एक बार, जब रजिस्ट्री किसी समूह को छोड़ती है: imessage: dropping group message from chat_id=<id> ... not in channels.imessage.groups allowlist, जिसमें जोड़ने के लिए सटीक कुंजी बताई जाती है।

दोनों स्थितियों में DM काम करते रहते हैं — वे अलग कोड पथ अपनाते हैं, इसलिए DM की सफलता समूह रूटिंग को प्रमाणित नहीं करती।

groupPolicy: "allowlist" वाला न्यूनतम प्रेषक-सीमित कॉन्फ़िगरेशन:

{  channels: {    imessage: {      groupPolicy: "allowlist",      groupAllowFrom: ["+15555550123", "chat_guid:any;-;..."],    },  },}

यह कॉन्फ़िगर किए गए प्रेषकों को किसी भी समूह में अनुमति देता है। अनुमत चैट का दायरा सीमित करने या requireMention जैसे प्रति-चैट विकल्प सेट करने के लिए groups प्रविष्टियाँ जोड़ें; BlueBubbles की "*" प्रविष्टि अक्षरशः कॉपी करें, लेकिन विशिष्ट प्रविष्टियों को संख्यात्मक iMessage chat_id मानों के साथ नई कुंजी दें।

चरण-दर-चरण

1. कॉन्फ़िगरेशन रूपांतरित करें। संपादन के दौरान नया ब्लॉक अक्षम रखें; वर्तमान OpenClaw पुराने channels.bluebubbles ब्लॉक को अनदेखा करता है और वह संदर्भ के रूप में साथ रह सकता है:

   {  channels: {    imessage: {      enabled: false, // कटओवर के लिए तैयार होने पर true करें      cliPath: "/opt/homebrew/bin/imsg",      dmPolicy: "pairing",      allowFrom: ["+15555550123"], // bluebubbles.allowFrom से कॉपी करें      groupPolicy: "allowlist",      groupAllowFrom: [], // bluebubbles.groupAllowFrom से कॉपी करें      groups: { "*": { requireMention: true } }, // वाइल्डकार्ड हूबहू कॉपी होता है; प्रत्येक चैट की प्रविष्टि को chat_id के अनुसार फिर से कुंजीबद्ध करें      // क्रियाएँ डिफ़ॉल्ट रूप से सक्षम हैं; अक्षम करने के लिए अलग-अलग टॉगल false पर सेट करें    },  },}

2. कटओवर करें और जाँचें। channels.imessage.enabled: true सेट करें, Gateway को पुनः आरंभ करें और पुष्टि करें कि चैनल स्वस्थ रिपोर्ट होता है:

   openclaw gateway restartopenclaw channels status --probe --channel imessage   # "works" अपेक्षित है; --json privateApi.available: true दिखाता है

   जाँच के लिए पहुँच योग्य Gateway आवश्यक है और यह केवल कॉन्फ़िगर किए गए, सक्षम खातों की जाँच करती है। स्वयं Mac को सत्यापित करने के लिए शुरू करने से पहले में दिए गए सीधे imsg कमांड का उपयोग करें।

3. DM सत्यापित करें। एजेंट को सीधा संदेश भेजें; पुष्टि करें कि उत्तर पहुँचता है।

4. समूहों को अलग से सत्यापित करें। DM और समूह अलग-अलग कोड पथ अपनाते हैं — DM की सफलता यह सिद्ध नहीं करती कि समूहों की रूटिंग हो रही है। किसी अनुमत समूह चैट में संदेश भेजें और पुष्टि करें कि उत्तर पहुँचता है। यदि समूह शांत हो जाता है (एजेंट का कोई उत्तर या त्रुटि नहीं), तो ऊपर दिए गए "समूह रजिस्ट्री की आम चूक" के दो warn संदेशों के लिए Gateway लॉग जाँचें। स्टार्टअप चेतावनी का अर्थ है कि प्रभावी प्रेषक अनुमति-सूची खाली है; प्रत्येक chat_id की चेतावनी का अर्थ है कि भरी हुई groups रजिस्ट्री में वह चैट मौजूद नहीं है।

5. क्रिया सतह सत्यापित करें। किसी युग्मित DM से एजेंट को प्रतिक्रिया देने, संपादित करने, भेजा हुआ संदेश वापस लेने, उत्तर देने, फ़ोटो भेजने और (समूह में) समूह का नाम बदलने या किसी प्रतिभागी को जोड़ने/हटाने के लिए कहें। प्रत्येक क्रिया Messages.app में मूल रूप से पूरी होनी चाहिए। यदि कोई क्रिया iMessage <action> requires the imsg private API bridge त्रुटि देती है, तो imsg launch फिर से चलाएँ और openclaw channels status --probe से रीफ़्रेश करें।

6. iMessage के DM, समूह और क्रियाएँ सत्यापित हो जाने के बाद BlueBubbles सर्वर और channels.bluebubbles ब्लॉक हटाएँ। OpenClaw channels.bluebubbles को नहीं पढ़ता।

क्रिया समानता एक नज़र में

Gateway बंद रहने के दौरान छूटे संदेशों को iMessage पुनर्प्राप्त करता है: स्टार्टअप पर यह अंतिम प्रेषित rowid से imsg watch.subscribe since_rowid के माध्यम से रीप्ले करता है, GUID के आधार पर डुप्लिकेट हटाता है और पुरानी बैकलॉग आयु-सीमा Push-flush "बैकलॉग बम" को रोकती है। यह imsg RPC कनेक्शन पर चलता है, इसलिए दूरस्थ SSH cliPath सेटअप के लिए भी काम करता है; स्थानीय सेटअप को अधिक विस्तृत पुनर्प्राप्ति अवधि मिलती है क्योंकि वे chat.db पढ़ सकते हैं। ब्रिज या Gateway पुनः आरंभ होने के बाद इनबाउंड पुनर्प्राप्ति देखें।

युग्मन, सत्र और ACP बाइंडिंग

• अनुमति-सूचियाँ हैंडल के अनुसार स्थानांतरित होती हैं। channels.imessage.allowFrom उन्हीं +15555550123 / user@example.com स्ट्रिंग को पहचानता है जिनका BlueBubbles उपयोग करता था — उन्हें हूबहू कॉपी करें।
• युग्मन स्टोर की स्वीकृतियाँ स्थानांतरित नहीं होतीं। युग्मन स्टोर प्रत्येक चैनल के लिए अलग है और पुराने BlueBubbles स्टोर को कुछ भी माइग्रेट नहीं करता। जिन प्रेषकों को केवल युग्मन के माध्यम से स्वीकृत किया गया था, उन्हें iMessage के अंतर्गत एक बार फिर युग्मन करना होगा या उनके हैंडल allowFrom में जोड़ने होंगे।
• सत्र प्रत्येक एजेंट + चैट तक सीमित रहते हैं। डिफ़ॉल्ट session.dmScope=main के अंतर्गत DM एजेंट के मुख्य सत्र में समाहित हो जाते हैं; समूह सत्र प्रत्येक chat_id (agent:<agentId>:imessage:group:<chat_id>) के लिए अलग रहते हैं। BlueBubbles सत्र कुंजियों के अंतर्गत पुराना वार्तालाप इतिहास iMessage सत्रों में स्थानांतरित नहीं होता।
• match.channel: "bluebubbles" को संदर्भित करने वाली ACP बाइंडिंग को "imessage" में बदलना होगा। match.peer.id के प्रारूप (chat_id:, chat_guid:, chat_identifier:, केवल हैंडल) समान हैं।

कोई रोलबैक चैनल नहीं

वापस स्विच करने के लिए कोई समर्थित BlueBubbles रनटाइम नहीं है। यदि iMessage सत्यापन विफल हो जाता है, तो channels.imessage.enabled: false सेट करें, Gateway को पुनः आरंभ करें, imsg अवरोधक ठीक करें और कटओवर का पुनः प्रयास करें।

उत्तर कैश SQLite Plugin स्थिति में रहता है। मौजूद होने पर openclaw doctor --fix पुराने imessage/reply-cache.jsonl साइडकार को आयात और संग्रहीत करता है।

संबंधित

• BlueBubbles को हटाना और imsg iMessage पथ — संक्षिप्त घोषणा और ऑपरेटर सारांश।
• iMessage — पूर्ण iMessage चैनल संदर्भ, जिसमें imsg launch सेटअप और क्षमता पहचान शामिल हैं।
• /channels/bluebubbles — पुराना URL, जो इस माइग्रेशन मार्गदर्शिका पर रीडायरेक्ट करता है।
• युग्मन — DM प्रमाणीकरण और युग्मन प्रवाह।
• चैनल रूटिंग — Gateway आउटबाउंड उत्तरों के लिए चैनल कैसे चुनता है।