RPC and API

Bộ điều hợp RPC

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

Mẫu A: daemon HTTP (signal-cli)

  • signal-cli chạy dưới dạng daemon với JSON-RPC qua HTTP.
  • Luồng sự kiện là SSE (/api/v1/events).
  • Kiểm tra sức khỏe: /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 (cũ: imsg)

Lưu ý: Đối với các thiết lập iMessage mới, hãy dùng BlueBubbles thay thế.

  • OpenClaw sinh imsg rpc dưới dạng tiến trình con (tích hợp iMessage cũ).
  • JSON-RPC được phân tách theo dòng qua stdin/stdout (một đối tượng JSON trên mỗi dòng).
  • Không cần cổng TCP, không cần daemon.

Các phương thức lõi được 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 cũ và định địa chỉ (ưu tiên chat_id).

Hướng dẫn adapter

  • Gateway sở hữu tiến trình (khởi động/dừng gắn với vòng đời provider).
  • Giữ cho các client RPC có khả năng chống lỗi: timeout, khởi động lại khi thoát.
  • Ưu tiên ID ổn định (ví dụ: chat_id) thay vì chuỗi hiển thị.

Liên quan