​

Adapter RPC

28. Hết hạn khi rảnh (session.reset.idleMinutes hoặc legacy session.idleMinutes) tạo sessionId mới khi có tin nhắn đến sau cửa sổ rảnh. Hiện nay có hai mẫu được sử dụng.

​

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

• signal-cli chạy như một daemon với JSON-RPC qua HTTP.
• Luồng sự kiện là SSE (/api/v1/events).
• Kiểm tra tình trạng: /api/v1/check.
• OpenClaw sở hữu vòng đời khi channels.signal.autoStart=true.

Xem Signal để biết thiết lập và các endpoint.

​

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

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

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

Các phương thức cốt 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 thiết lập legacy và cách định địa chỉ (chat_id được ưu tiên).

​

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 nhà cung cấp).
• Giữ client RPC bền bỉ: timeout, tự khởi động lại khi thoát.
• Ưu tiên ID ổn định (ví dụ: chat_id) hơn là chuỗi hiển thị.