Eldercare Videocall

Eldercare Video Call — Kết nối gia đình với bà

Tổng quan

Video call đi qua Zalo video call trực tiếp (KHÔNG dùng SIP/WebRTC/Twilio). OpenClaw đóng vai trò điều phối: kiểm tra bà sẵn sàng, chuẩn bị phòng, và hướng dẫn gia đình thời điểm gọi.

Tablet đặt cạnh giường bà chạy Zalo đăng nhập sẵn (tài khoản Zalo bà/ông). Fully Kiosk Browser giữ Zalo foreground, màn hình luôn sẵn sàng.

Flow A: Gia đình chủ động gọi bà (on-demand)

Bước 1: Nhận intent gọi bà

Gia đình nhắn vào Zalo group hoặc chat Bờm bot:

• "gọi bà", "gọi bà nội", "video call bà", "gọi cho bà", "muốn gọi bà"

Bước 2: Check trạng thái bà

Dùng tool home_assistant đọc sensors:

• get_state entity binary_sensor.grandma_room_presence → có người?
• get_state entity sensor.grandma_room_motion_minutes → phút từ cử động cuối

Quy tắc phân loại:

Bà ĐANG THỨC (motion < 15 phút): → Tiếp tục chuẩn bị phòng (Bước 3)

Bà có thể ĐANG NGỦ TRƯA (motion > 15 phút VÀ giờ 13:00-15:00): → Reply: "Bà có vẻ đang nghỉ trưa 😴 Gọi sau 15h nhé? Hay bạn muốn gọi ngay?" → Nếu gia đình reply "gọi ngay" / "gọi luôn" → tiếp tục Bước 3 → Nếu không reply → dừng

Bà ĐANG NGỦ ĐÊM (motion > 30 phút VÀ giờ 22:00-06:00): → Reply: "Bà đang ngủ rồi 🌙 Sáng mai gọi nhé?" → Chỉ tiếp tục nếu gia đình nói "khẩn cấp" / "gọi ngay"

Bà KHÔNG TRONG PHÒNG (presence = off): → Reply: "⚠️ Sensor không phát hiện người trong phòng bà. Kiểm tra lại nhé."

Bước 3: Chuẩn bị phòng bà

Nếu OK để gọi, dùng tool home_assistant thực hiện tuần tự:

3a. Bật đèn sáng vừa (không chói):

action: call_service
domain: light
service: turn_on
target_entity_id: light.grandma_room
service_data: { "brightness": 150, "color_temp_kelvin": 3000 }

3b. Tablet: Bật màn hình + mở Zalo:

Nếu có Fully Kiosk Browser REST API qua HA shell_command hoặc REST command:

action: call_service
domain: shell_command
service: tablet_screen_on

Hoặc ghi chú cho gia đình tự setup HA automation để bật tablet khi trigger.

3c. TTS thông báo cho bà (VOLUME CAO):

Trước TTS, set volume MAX:

action: call_service
domain: media_player
service: volume_set
target_entity_id: media_player.grandma_room
service_data: { "volume_level": 1.0 }

Rồi TTS:

action: call_service
domain: tts
service: speak
target_entity_id: media_player.grandma_room
service_data: {
  "message": "Bà ơi, {tên người gọi} muốn gọi video cho bà nè! Bà nhìn màn hình nha!",
  "language": "vi"
}

3d. Chờ 5 giây (để bà nghe thông báo)

Bước 4: Hướng dẫn gia đình gọi

Reply cho gia đình trong Zalo:

✅ Phòng bà đã sẵn sàng!

📱 Bà đã được thông báo rồi.
📞 Bạn gọi Zalo video cho bà ngay nhé!
   Zalo bà: {thông tin Zalo bà từ config}
💡 Đèn đã bật, loa đã thông báo.
🔊 Nhớ nói TO và RÕ — cả bà và ông đều nặng tai.

Bước 5: Logging

Lưu memory sau khi trigger thành công:

eldercare_call_{timestamp}: {
  "caller": "{tên người yêu cầu}",
  "triggered_at": "{ISO timestamp}",
  "status": "room_prepared",
  "note": "Zalo video call directed"
}

Dữ liệu này dùng cho eldercare-daily-report skill.

Flow B: Lịch gọi cố định (Cron)

8:00 sáng — Nhắc lần 1

Gửi Zalo group gia đình:

🌅 Chào buổi sáng!
Nhắc mọi người gọi chào bà nội nha.
Reply "gọi bà" để Bờm chuẩn bị phòng bà sẵn sàng!

9:00 sáng — Nhắc lần 2 (nếu cần)

Kiểm tra memory: có eldercare_call_* nào có timestamp NGÀY HÔM NAY chưa?

• Nếu CHƯA CÓ cuộc gọi hôm nay → nhắc lại:

  ☀️ Chưa ai gọi bà sáng nay. Bà đang thức rồi đó!
  Reply "gọi bà" nhé~
  

• Nếu ĐÃ CÓ cuộc gọi hôm nay → không nhắc nữa

Whitelist & Security

Chỉ contacts trong whitelist mới trigger được flow gọi bà. Đọc whitelist từ memory eldercare_videocall_whitelist hoặc videocall-config.json.

Khi người KHÔNG trong whitelist nhắn "gọi bà": → Reply: "Bạn không có quyền thực hiện lệnh này. Liên hệ admin gia đình."

Quiet Hours

• Giờ 22:00-06:00: Từ chối gọi trừ khi gia đình nói rõ "khẩn cấp"
• Reply: "Bà đang ngủ rồi 🌙 Sáng mai gọi nhé? (Nếu khẩn cấp, reply 'khẩn cấp')"

Config

Đọc từ videocall-config.json hoặc memory eldercare_videocall_config:

• tablet.ip — IP tablet trong mạng local
• tablet.fully_kiosk_password — Fully Kiosk password
• grandma_zalo_contact — Thông tin Zalo bà để gia đình gọi
• whitelist — Danh sách người được phép gọi
• schedule.morning_reminder — Bật/tắt nhắc sáng
• schedule.quiet_hours_start/end — Giờ yên lặng

Config Override (đọc từ memory)

Trước khi dùng giá trị mặc định, PHẢI kiểm tra memory:

1. Dùng memory search query eldercare_videocall_config
2. Nếu tìm thấy → parse JSON, dùng config từ memory
3. Nếu KHÔNG tìm thấy → dùng defaults từ videocall-config.json

Các field có thể override:

• tablet.ip — IP tablet
• tablet.fully_kiosk_password
• grandma_zalo_contact — Zalo bà
• whitelist — người được phép gọi
• schedule.morning_reminder — bật/tắt nhắc sáng
• schedule.quiet_hours_start / quiet_hours_end
• tts.volume (mặc định: 1.0)

Phụ đề (Phase 2 — ghi nhận)

Phụ đề realtime chưa khả thi qua Zalo video call (Zalo không có API overlay). Ghi nhận cho tương lai:

• Option A: App phụ đề overlay Android chạy song song Zalo
• Option B: Micro riêng → Whisper STT → text trên second screen Hiện tại: Gia đình nói TO + RÕ, kết hợp nhắn text Zalo chat song song.

Multi-Elder Support

Skill này hỗ trợ nhiều người thân:

1. Đọc eldercare_profiles từ memory
2. Nếu không tồn tại → auto-migrate default profile "ba_noi" (xem skill eldercare-profiles)
3. Loop qua tất cả active elders
4. Với mỗi elder:
   • Dùng elder.ha_entities.* thay vì hardcoded entity names
   • Dùng eldercare_{elder.id}_* làm memory key prefix
   • Dùng elder.name trong messages/TTS
   • Dùng elder.contacts cho alert recipients (fallback global contacts)
   • Dùng elder.tts.* cho TTS settings

Thay đổi cụ thể

• binary_sensor.grandma_room_presence → elder.ha_entities.presence
• sensor.grandma_room_motion_minutes → elder.ha_entities.motion
• light.grandma_room → elder.ha_entities.light
• media_player.grandma_room → elder.ha_entities.media_player
• Memory: eldercare_call_* → eldercare_{elder.id}_call_*
• Memory: eldercare_videocall_config → eldercare_{elder.id}_videocall_config
• TTS: Dùng elder.tts.*