RPC and API

Bộ điều hợp RPC

OpenClaw tích hợp các CLI bên ngoài thông qua JSON-RPC. Hiện nay có hai mẫu được sử dụng.

Mẫu A: Tiến trình nền HTTP (signal-cli)

  • signal-cli chạy dưới dạng tiến trình nền với JSON-RPC qua HTTP.
  • Luồng sự kiện sử dụng SSE (/api/v1/events).
  • Điểm kiểm tra tình trạng: /api/v1/check.
  • OpenClaw quản lý vòng đời khi channels.signal.autoStart=true.

Xem Signal để biết cách thiết lập và các điểm cuối.

Mẫu B: Tiến trình con stdio (imsg)

  • OpenClaw khởi chạy imsg rpc dưới dạng tiến trình con cho iMessage.
  • JSON-RPC được phân tách theo dòng qua stdin/stdout (mỗi dòng là một đối tượng JSON).
  • Không cần cổng TCP hay tiến trình nền.

Các phương thức cốt lõi được sử dụng:

  • watch.subscribe → thông báo (method: "message")
  • watch.unsubscribe
  • send
  • chats.list (thăm dò/chẩn đoán)

Xem iMessage để biết cách thiết lập và định địa chỉ (ưu tiên chat_id hơn chuỗi hiển thị).

Hướng dẫn về bộ chuyển đổi

  • Gateway quản lý tiến trình (việc khởi động/dừng gắn với vòng đời của nhà cung cấp).
  • Duy trì khả năng phục hồi của các máy khách RPC: đặt thời gian chờ, khởi động lại khi tiến trình thoát.
  • Ưu tiên mã định danh ổn định (ví dụ: chat_id) hơn chuỗi hiển thị.

Liên quan

Was this useful?
On this page

On this page