RPC and API

مهايئات RPC

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

النمط أ: خدمة HTTP خفية (signal-cli)

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

راجع Signal لمعرفة خطوات الإعداد ونقاط النهاية.

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

  • يُشغّل OpenClaw الأمر imsg rpc كعملية فرعية من أجل iMessage.
  • تُفصل رسائل JSON-RPC بأسطر عبر stdin/stdout (كائن JSON واحد في كل سطر).
  • لا يلزم منفذ TCP ولا خدمة خفية.

الأساليب الأساسية المستخدمة:

  • watch.subscribe ← إشعارات (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (الفحص/التشخيص)

راجع iMessage لمعرفة خطوات الإعداد والعنونة (يُفضّل chat_id على سلاسل العرض).

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

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

ذو صلة

Was this useful?
On this page

On this page