RPC and API

Adaptor RPC

OpenClaw mengintegrasikan CLI eksternal melalui JSON-RPC. Saat ini, ada dua pola yang digunakan.

Pola A: daemon HTTP (signal-cli)

  • signal-cli berjalan sebagai daemon dengan JSON-RPC melalui HTTP.
  • Aliran peristiwa menggunakan SSE (/api/v1/events).
  • Pemeriksaan kesehatan: /api/v1/check.
  • OpenClaw mengelola siklus hidup ketika channels.signal.autoStart=true.

Lihat Signal untuk penyiapan dan endpoint.

Pola B: proses anak stdio (imsg)

  • OpenClaw menjalankan imsg rpc sebagai proses anak untuk iMessage.
  • JSON-RPC dipisahkan per baris melalui stdin/stdout (satu objek JSON per baris).
  • Tidak ada port TCP dan tidak memerlukan daemon.

Metode inti yang digunakan:

  • watch.subscribe → notifikasi (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (pemeriksaan/diagnostik)

Lihat iMessage untuk penyiapan dan pengalamatan (chat_id lebih disarankan daripada string tampilan).

Pedoman adaptor

  • Gateway mengelola proses (mulai/berhenti terkait dengan siklus hidup penyedia).
  • Pastikan klien RPC tetap tangguh: gunakan batas waktu dan mulai ulang saat proses berhenti.
  • Utamakan ID stabil (misalnya, chat_id) daripada string tampilan.

Terkait

Was this useful?
On this page

On this page