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-clichạ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 rpcdướ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.unsubscribesendchats.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ị.