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.transport.kind="managed-native" باشد (حالت پیش‌فرض)، OpenClaw چرخهٔ حیات را مدیریت می‌کند.

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

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

  • OpenClaw برای iMessage، ‏imsg rpc را به‌عنوان فرایند فرزند اجرا می‌کند.
  • 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