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.unsubscribesendchats.list(الفحص/التشخيصات)
راجع iMessage لمعرفة الإعداد القديم والعنونة (يُفضَّل chat_id).
إرشادات Adapter
- يتولى Gateway ملكية العملية (يرتبط البدء/الإيقاف بدورة حياة المزوّد).
- اجعل عملاء RPC قادرين على الصمود: المهل الزمنية، وإعادة التشغيل عند الخروج.
- فضّل المعرّفات المستقرة (مثل
chat_id) على سلاسل العرض.