RPC and API

محولات 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).

إرشادات Adapter

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

ذات صلة