RPC and API

آداپتورهای RPC

OpenClaw، CLIهای خارجی را از طریق JSON-RPC یکپارچه می‌کند. در حال حاضر از دو الگو استفاده می‌شود.

الگوی A: دیمن HTTP (signal-cli)

  • signal-cli به‌صورت دیمن با JSON-RPC روی HTTP اجرا می‌شود.
  • جریان رویداد SSE است (/api/v1/events).
  • کاوشگر سلامت: /api/v1/check.
  • وقتی channels.signal.autoStart=true باشد، OpenClaw چرخهٔ عمر را مدیریت می‌کند.

برای راه‌اندازی و نقاط پایانی، به Signal مراجعه کنید.

الگوی B: فرایند فرزند stdio (imsg)

  • OpenClaw، دستور imsg rpc را به‌عنوان فرایند فرزند برای iMessage اجرا می‌کند.
  • JSON-RPC روی stdin/stdout به‌صورت سطرجداسازی‌شده است (در هر سطر یک شیء JSON).
  • هیچ درگاه TCP و هیچ دیمنی لازم نیست.

متدهای اصلی مورد استفاده:

  • watch.subscribe ← اعلان‌ها (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (کاوش/عیب‌یابی)

برای راه‌اندازی و آدرس‌دهی (ترجیح chat_id بر رشته‌های نمایشی)، به iMessage مراجعه کنید.

رهنمودهای آداپتور

  • Gateway مالک فرایند است (شروع/توقف به چرخهٔ عمر ارائه‌دهنده وابسته است).
  • کلاینت‌های RPC را تاب‌آور نگه دارید: مهلت‌های زمانی و راه‌اندازی مجدد هنگام خروج.
  • شناسه‌های پایدار (برای مثال، chat_id) را به رشته‌های نمایشی ترجیح دهید.

مرتبط

Was this useful?
On this page

On this page