Một hướng dẫn kiến trúc toàn diện để xây dựng các tích hợp tùy chỉnh Home Assistant và các thành phần HACS mạnh mẽ.
Cài đặt & Tải xuống
1. ClawHub CLI
Cách nhanh nhất để cài đặt kỹ năng trực tiếp từ thư viện.
npx clawhub@latest install ha-integration-patterns
2. Cài đặt Thủ công
Sao chép thư mục kỹ năng vào một trong những vị trí sau
~/.openclaw/skills/ <project>/skills/ Ưu tiên: Không gian làm việc > Cục bộ > Gói sẵn
3. Cài đặt Prompt
Sao chép prompt này vào OpenClaw để tự động cài đặt.
Giúp tôi cài đặt ha-integration-patterns bằng Clawhub. Nếu Clawhub chưa
Bạn muốn tải xuống?
Nhận các tệp kỹ năng gốc dưới dạng lưu trữ ZIP.
Các mẫu tích hợp Home Assistant là gì?
Kỹ năng này cung cấp một bản thiết kế kỹ thuật để kiến trúc các tích hợp tùy chỉnh Home Assistant, đóng vai trò là nguồn tài nguyên quan trọng trong hệ sinh thái Openclaw Skills. Nó tập trung vào việc chuyển đổi từ các dịch vụ 'gửi và quên' cũ sang các phản hồi dịch vụ hiện đại, giàu dữ liệu và các chế độ xem HTTP được xác thực. Bằng cách tuân theo các mẫu đã thiết lập này, các nhà phát triển có thể xây dựng các cầu nối đáng tin cậy hơn giữa các tác nhân AI và phần cứng nhà thông minh, đảm bảo rằng các tích hợp sẵn sàng cho tương lai và tuân thủ các tiêu chuẩn chính thức của nhà phát triển.
Tích hợp với Home Assistant yêu cầu sự hiểu biết sâu sắc về vòng lặp sự kiện và các đăng ký nội bộ của nó. Hướng dẫn này tổng hợp các phương pháp hay nhất để đăng ký dịch vụ, lưu trữ liên tục thông qua Store API và triển khai các chế độ xem HTTP tùy chỉnh. Nó được thiết kế để giúp các nhà phát triển tránh các bẫy phổ biến, chẳng hạn như sử dụng các API riêng tư không ổn định, thường dẫn đến lỗi tích hợp trong các bản cập nhật cốt lõi.
Trường hợp sử dụng Các mẫu tích hợp Home Assistant
- Phát triển các tích hợp HACS tùy chỉnh cho Home Assistant để mở rộng chức năng nhà thông minh.
- Xây dựng cầu nối API giữa các tác nhân AI bên ngoài và phần cứng nhà thông minh cục bộ.
- Di chuyển các tích hợp cũ để sử dụng các mẫu Dữ liệu phản hồi dịch vụ mới nhất (sau HA 2023.7).
- Triển khai lưu trữ liên tục an toàn cho các cài đặt tích hợp và trạng thái thiết bị bằng cách sử dụng các trình trợ giúp chính thức.
Cách thức hoạt động của Các mẫu tích hợp Home Assistant
- Xác định mẫu giao tiếp phù hợp: sử dụng Dịch vụ cho các hành động hoặc Chế độ xem HTTP để truy xuất dữ liệu phức tạp.
- Cấu hình manifest.json của tích hợp và xác định lược đồ dịch vụ trong services.yaml để hỗ trợ các cấu trúc phản hồi hiện đại.
- Triển khai trình xử lý dịch vụ trong Python, sử dụng các tham số SupportsResponse.ONLY hoặc SupportsResponse.OPTIONAL để trả về dữ liệu cho người gọi.
- Thiết lập lưu trữ liên tục không đồng bộ bằng Home Assistant Store API để đảm bảo cấu hình tồn tại sau khi hệ thống khởi động lại.
- Triển khai cấu trúc tích hợp trong thư mục custom_components và xác minh chức năng bằng danh sách kiểm tra thử nghiệm được cung cấp.
Cài đặt Các mẫu tích hợp Home Assistant
Đảm bảo môi trường phát triển của bạn có quyền truy cập vào một phiên bản Home Assistant. Thực hiện theo các bước sau để khởi tạo cấu trúc tích hợp của bạn:
# Tạo cấu trúc thư mục cho tích hợp của bạn
mkdir -p custom_components/your_domain
# Khởi tạo các tệp cốt lõi
touch custom_components/your_domain/__init__.py
touch custom_components/your_domain/manifest.json
touch custom_components/your_domain/services.yaml
Để bật phản hồi dịch vụ, hãy đăng ký dịch vụ của bạn trong logic khởi tạo thành phần của bạn:
# Trong mã tích hợp Python của bạn
from homeassistant.helpers.service import SupportsResponse
hass.services.async_register(
domain,
"get_data",
handle_service_call,
supports_response=SupportsResponse.ONLY
)
Lược đồ dữ liệu & Hệ thống phân loại của Các mẫu tích hợp Home Assistant
Kỹ năng tuân theo thư mục Home Assistant tiêu chuẩn và phân loại siêu dữ liệu cho các thành phần tùy chỉnh. Dữ liệu được tổ chức như sau:
| Thành phần | Tệp/Đường dẫn | Mô tả |
|---|---|---|
| manifest.json | Gốc | Siêu dữ liệu, phụ thuộc và thông tin phiên bản |
| services.yaml | Gốc | Định nghĩa chính thức về các cuộc gọi dịch vụ và lược đồ |
| Storage API | .storage/ | Các tệp JSON được phiên bản hóa để cài đặt liên tục |
| config_flow.py | Gốc | Logic cho trình hướng dẫn cấu hình dựa trên giao diện người dùng |
| init.py | Gốc | Thiết lập cốt lõi và điểm nhập cho tích hợp |
Tính năng Nâng cao của Các mẫu tích hợp Home Assistant
- Hỗ trợ Dữ liệu phản hồi dịch vụ cho phép Openclaw Skills nhận JSON có cấu trúc trực tiếp từ các cuộc gọi dịch vụ.
- Triển khai các lớp HomeAssistantView tùy chỉnh để xây dựng các điểm cuối REST được xác thực.
- Lưu trữ dữ liệu không đồng bộ bằng Store API với phiên bản và chu kỳ lưu/tải tự động.
- Hỗ trợ logic di chuyển thông qua async_migrate_entry để xử lý các thay đổi đột ngột trong cài đặt tích hợp.
- Tuân thủ nghiêm ngặt các tiêu chuẩn API công khai để đảm bảo tính tương thích trên các phiên bản cốt lõi khác nhau của Home Assistant.
SKILL.md
Đang tải
Các kỹ năng Openclaw liên quan
Scrappa MCP
Một máy chủ Model Context Protocol toàn diện cung cấp cho các AI agent quyền truy cập tức thì vào hơn 80 công cụ thu thập và truy xuất dữ liệu web.
Công cụ tạo nội dung thu hồi khách hàng
Một công cụ hỗ trợ bởi AI để tạo nội dung tái tương tác có tỷ lệ chuyển đổi cao nhằm thu hồi những người dùng thương mại điện tử không hoạt động.
Soạn thảo văn bản độc quyền VIP
Một tác nhân soạn thảo văn bản được hỗ trợ bởi AI chuyên tạo nội dung thương mại điện tử có tỷ lệ chuyển đổi cao và các tài liệu quảng cáo VIP.
Usage Scenario
Một công cụ soạn thảo nội dung AI chuyên dụng được thiết kế để tạo ra các nội dung marketing chất lượng cao, dựa trên kịch bản cho các ứng dụng thương mại điện tử.
Hướng dẫn Kỹ thuật Tiện ích Mở rộng Bàn phím iOS
Một bản thiết kế kỹ thuật chi tiết về các ràng buộc và cách khắc phục khi xây dựng các tiện ích mở rộng bàn phím tùy chỉnh trên iOS, đặc biệt là cho các tính năng âm thanh và AI.
Trình tạo và Đọc mã QR NEAR
Một tiện ích chạy bằng Python để tạo và giải mã mã QR của giao thức NEAR cho các địa chỉ và yêu cầu thanh toán.
Đặc sắc*
