RPC and API
آداپتورهای RPC
OpenClaw از طریق JSON-RPC با CLIهای خارجی یکپارچه میشود. امروز از دو الگو استفاده میشود.
الگوی A: دیمون HTTP (signal-cli)
signal-cliبهصورت دیمون با JSON-RPC روی HTTP اجرا میشود.- جریان رویداد SSE است (
/api/v1/events). - پروب سلامت:
/api/v1/check. - وقتی
channels.signal.autoStart=trueباشد، OpenClaw مالک چرخهٔ حیات است.
برای راهاندازی و endpointها به Signal مراجعه کنید.
الگوی B: فرایند فرزند stdio (imsg)
- OpenClaw،
imsg rpcرا بهعنوان فرایند فرزند برای iMessage اجرا میکند. - JSON-RPC بهصورت خطبهخط روی stdin/stdout جدا میشود (هر خط یک شیء JSON).
- هیچ پورت TCP و هیچ دیمونی لازم نیست.
روشهای اصلی استفادهشده:
watch.subscribe→ اعلانها (method: "message")watch.unsubscribesendchats.list(پروب/عیبیابی)
برای راهاندازی قدیمی و آدرسدهی (chat_id ترجیح داده میشود) به iMessage مراجعه کنید.
رهنمودهای آداپتور
- Gateway مالک فرایند است (شروع/توقف به چرخهٔ حیات provider گره خورده است).
- کلاینتهای RPC را تابآور نگه دارید: timeoutها، راهاندازی دوباره هنگام خروج.
- شناسههای پایدار (مثلاً
chat_id) را به رشتههای نمایشی ترجیح دهید.