| name | eldercare-sos |
| description | Hệ thống SOS khẩn cấp cho bà nội. Nhận trigger từ: nút vật lý Zigbee
(qua Home Assistant), AI detection (từ eldercare-monitor), hoặc gia đình
gõ "SOS" trong Zalo/Telegram. Escalation chain tự động:
Level 1 (Zalo) → Level 2 (Phone) → Level 3 (gọi tất cả).
Gửi kèm camera snapshot. Có cancel mechanism.
|
| metadata | {"openclaw":{"emoji":"🆘","requires":{"config":"[Truncated]"}}} |
Eldercare SOS — Hệ thống khẩn cấp
Skill này xử lý tình huống khẩn cấp cho bà nội. Khi được trigger, nó thực hiện escalation chain tự động: Zalo → Phone → gọi tất cả gia đình.
Khi nào skill này được trigger
1. Nút SOS vật lý (qua Home Assistant)
Bà hoặc ông bấm nút Zigbee. Kiểm tra entity sensor.sos_button_action:
| Hành động | Giá trị sensor | Xử lý |
|---|
| Bấm 1 lần | single | Bắt đầu từ Level 1 (Zalo trước) |
| Bấm 2 lần | double | Skip Level 1, vào thẳng Level 2 (gọi điện) |
| Giữ 3 giây | long | Skip Level 1+2, vào thẳng Level 3 (gọi TẤT CẢ) |
2. AI auto-detect (từ eldercare-monitor)
Khi skill eldercare-monitor phân loại mức KHẨN CẤP → trigger SOS bắt đầu từ Level 2 (vì AI đã xác nhận nghiêm trọng).
2b. Fall Detection (từ eldercare-fall-detect)
Khi skill eldercare-fall-detect phát hiện ngã VÀ bà không phản hồi TTS xác nhận (2 lần, tổng 45 giây) → trigger SOS bắt đầu từ Level 2. Source = "fall_detect". Kèm theo 2 ảnh camera snapshot (trước và sau TTS).
3. Manual (gia đình gõ chat)
Khi ai đó gõ "SOS", "cứu", "khẩn cấp" trong Zalo hoặc Telegram → trigger từ Level 1.
QUAN TRỌNG: Kiểm tra duplicate
Trước khi bắt đầu SOS mới, kiểm tra memory eldercare_sos_active:
- Nếu đã có SOS active (
resolved = false) → KHÔNG tạo SOS mới
- Log: "SOS đã active từ {triggered_at}. Không tạo duplicate."
- Nếu SOS cũ đã resolve → tiếp tục tạo mới
Hành động tức thì (T+0, MỌI level)
Ngay khi SOS trigger, thực hiện ĐỒNG THỜI:
1. Bật đèn phòng bà sáng tối đa
Dùng tool home_assistant:
action: call_service
domain: light
service: turn_on
target_entity_id: light.grandma_room
service_data: { "brightness": 255 }
2. TTS thông báo cho bà qua loa (VOLUME CAO)
Dùng tool home_assistant:
action: call_service
domain: tts
service: speak
target_entity_id: media_player.grandma_room
service_data: {
"message": "Bà ơi, đã gửi tín hiệu cho người nhà rồi ạ. Người nhà sẽ liên lạc ngay!",
"language": "vi"
}
Nếu TTS service không available, dùng media_player.volume_set với volume 1.0 trước, rồi phát audio.
3. Chụp camera snapshot
Dùng tool camsnap hoặc home_assistant:
action: call_service
domain: camera
service: snapshot
target_entity_id: camera.grandma_room
service_data: { "filename": "/config/www/sos_snapshot.jpg" }
Lưu path ảnh để gửi kèm message.
4. Lưu trạng thái SOS vào memory
eldercare_sos_active: {
"triggered_at": "{ISO timestamp}",
"source": "button_single | button_double | button_long | ai_detect | manual",
"start_level": 1 | 2 | 3,
"current_level": 1,
"resolved": false
}
Level 1: Zalo Alert (T+3 giây)
Gửi tin nhắn Zalo cho contact ưu tiên #1 (đọc từ memory eldercare_contacts):
🆘 SOS — BÀ NỘI CẦN HỖ TRỢ!
📍 Thời gian: {giờ:phút ngày/tháng}
📸 [Ảnh camera phòng bà]
🔊 Nguồn: {nút bấm / AI phát hiện / manual}
Reply "OK" hoặc "đã xử lý" để xác nhận.
⏰ Nếu không phản hồi trong 3 phút → hệ thống sẽ tự gọi điện.
Đồng thời gửi Zalo group gia đình cùng nội dung.
Chờ 3 phút (180 giây). Trong thời gian chờ, kiểm tra reply:
- Nếu ai đó reply "OK", "đã xử lý", "ổn rồi", "cancel" → Chuyển đến phần Cancel SOS bên dưới
- Nếu không ai reply → Tiếp tục Level 2
Level 2: Phone Call (T+180 giây)
Nếu Level 1 không có phản hồi, hoặc SOS bắt đầu từ Level 2:
- Gửi Zalo:
⚠️ Không ai phản hồi Zalo. Đang gọi điện cho {contact #1}...
- Dùng tool
voice_call (skill voice-call):
action: initiate_call
to: "{phone contact #1}"
message: "Khẩn cấp! Bà nội cần hỗ trợ. Vui lòng kiểm tra ngay. Bấm phím bất kỳ để xác nhận."
- Nếu contact #1 không nghe (30 giây timeout) → gọi contact #2
- Chờ 3 phút (180 giây)
- Nếu không ai phản hồi → Tiếp tục Level 3
Level 3: ALL (T+360 giây)
Nếu Level 2 không có phản hồi, hoặc SOS bắt đầu từ Level 3 (nút giữ 3s):
- Gọi điện ĐỒNG THỜI tất cả contacts trong danh sách
- Chụp thêm 1 camera snapshot mới
- Gửi Zalo + Telegram cho TẤT CẢ:
🚨 KHẨN CẤP: CHƯA AI PHẢN HỒI SAU 6 PHÚT!
📸 [Ảnh camera mới nhất]
📞 Đang gọi tất cả người thân.
Vui lòng liên hệ ngay!
- Log:
eldercare_sos_level3: {timestamp} — no response after 6 minutes, calling all contacts
Cancel SOS
Khi ai đó phản hồi (Zalo/Telegram) với các từ: "OK", "đã xử lý", "ổn rồi", "cancel", "hủy":
- Cancel ngay mọi timer/escalation đang chờ
- Gửi cho TẤT CẢ contacts:
✅ SOS đã được xử lý bởi {tên người reply}.
🕐 Lúc: {giờ:phút}
⏱️ Thời gian phản hồi: {số phút} phút
📊 Mức escalation cao nhất: Level {X}
- HA: Đèn về bình thường
action: call_service
domain: light
service: turn_on
target_entity_id: light.grandma_room
service_data: { "brightness": 100 }
- Cập nhật memory:
eldercare_sos_active: {
...previous,
"resolved": true,
"resolved_by": "{tên}",
"resolved_at": "{timestamp}",
"max_level_reached": {1|2|3},
"response_time_seconds": {số giây từ trigger đến resolve}
}
Nút SOS mapping tóm tắt
Bấm 1 lần (single):
T+0s → Đèn + TTS + Snapshot
T+3s → Zalo Level 1
T+183s → Phone Level 2 (nếu chưa OK)
T+363s → ALL Level 3 (nếu chưa OK)
Bấm 2 lần (double):
T+0s → Đèn + TTS + Snapshot
T+3s → Zalo + Phone Level 2 ngay
T+183s → ALL Level 3 (nếu chưa OK)
Giữ 3 giây (long):
T+0s → Đèn + TTS + Snapshot
T+3s → Gọi TẤT CẢ + Zalo + Telegram Level 3 ngay
Quy tắc an toàn
- KHÔNG tự động gọi 115 (cấp cứu) — chỉ gia đình tự quyết định
- KHÔNG tạo SOS mới khi đã có SOS active
- PHẢI có cancel mechanism
- PHẢI log đầy đủ cho daily report
- PHẢI gửi camera snapshot kèm mọi message cảnh báo
- TTS cho bà phải CHẬM, RÕ RÀNG, VOLUME CAO
Contacts
Đọc từ memory eldercare_contacts. Sắp xếp theo priority (1 = cao nhất).
Nếu chưa có contacts, gửi message cảnh báo vào channel hiện tại:
"⚠️ SOS triggered nhưng chưa có contacts! Cần config eldercare_contacts trong memory."
Config Override (đọc từ memory)
Trước khi dùng giá trị mặc định, PHẢI kiểm tra memory:
- Dùng memory search query
eldercare_sos_config
- Nếu tìm thấy → parse JSON, dùng config từ memory
- Nếu KHÔNG tìm thấy → dùng defaults trong SKILL.md này
Các field có thể override:
escalation.level1_wait_seconds (mặc định: 180)escalation.level2_wait_seconds (mặc định: 180)tts.message (custom message TTS cho bà)tts.volume (mặc định: 1.0)
Offline Queue Integration
Khi gửi alert thất bại (Zalo hoặc Telegram error):
- Lưu message vào memory với key:
eldercare_queue_{timestamp}
- Format:
{
"id": "queue_{timestamp}_{random}",
"created_at": "ISO timestamp",
"source_skill": "eldercare-sos",
"priority": "EMERGENCY",
"channels": ["zalo", "telegram"],
"message": "Nội dung SOS alert gốc",
"target": "all",
"retry_count": 0,
"max_retries": 10,
"last_retry_at": null,
"status": "pending",
"metadata": {
"sos_level":
QUAN TRỌNG: Mỗi level escalation (Level 1, 2, 3) nếu gửi thất bại
đều tạo queue entry riêng. Ví dụ Level 1 fail → queue entry priority EMERGENCY.
Level 2 fail → thêm 1 queue entry nữa.
Multi-Elder Support
Skill này hỗ trợ nhiều người thân:
- Đọc
eldercare_profiles từ memory
- Nếu không tồn tại → auto-migrate default profile "ba_noi" (xem skill eldercare-profiles)
- Loop qua tất cả active elders
- 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ể
sensor.sos_button_action → elder.ha_entities.sos_buttonlight.grandma_room → elder.ha_entities.lightmedia_player.grandma_room → elder.ha_entities.media_playercamera.grandma_room → elder.ha_entities.camera- Memory:
eldercare_sos_active → eldercare_{elder.id}_sos_active
- Memory:
eldercare_sos_config → eldercare_{elder.id}_sos_config
- Contacts:
eldercare_contacts → elder.contacts
- TTS: Dùng
elder.tts.volume, elder.tts.rate cho TTS service
