الانتقال إلى المحتوى الرئيسي

مهايئات RPC

يدمج OpenClaw واجهات CLI الخارجية عبر JSON-RPC. ويتم استخدام نمطين اليوم.

النمط A: daemon عبر HTTP ‏(signal-cli)

  • يعمل signal-cli كخدمة daemon مع JSON-RPC عبر HTTP.
  • يكون تدفق الأحداث عبر SSE ‏(/api/v1/events).
  • فحص الصحة: /api/v1/check.
  • يتولى OpenClaw دورة الحياة عندما تكون channels.signal.autoStart=true.
راجع Signal لمعرفة الإعداد ونقاط النهاية.

النمط B: عملية فرعية عبر stdio ‏(قديم: imsg)

ملاحظة: بالنسبة إلى إعدادات iMessage الجديدة، استخدم BlueBubbles بدلًا من ذلك.
  • يقوم OpenClaw بتشغيل imsg rpc كعملية فرعية (تكامل iMessage القديم).
  • يكون JSON-RPC محددًا سطرًا بسطر عبر stdin/stdout (كائن JSON واحد لكل سطر).
  • لا يوجد منفذ TCP ولا حاجة إلى daemon.
الأساليب الأساسية المستخدمة:
  • watch.subscribe → إشعارات (method: "message")
  • watch.unsubscribe
  • send
  • chats.list ‏(للفحص/التشخيص)
راجع iMessage لمعرفة الإعداد القديم والعنونة (ويُفضَّل chat_id).

إرشادات المهايئ

  • تتولى البوابة العملية (يرتبط البدء/الإيقاف بدورة حياة المزوّد).
  • اجعل عملاء RPC قادرين على الصمود: مهلات زمنية، وإعادة تشغيل عند الإنهاء.
  • فضّل المعرّفات المستقرة (مثل chat_id) على سلاسل العرض.