Home Claw

이 앱은 Homey를 위한 로컬 기반 AI 어시스턴트입니다. 디바이스 상태 확인, 예약 생성, 운영 점검을 따로 관리하는 과정이 번거롭다면, 이 앱이 그 작업을 하나의 흐름으로 묶어줍니다. Telegram 채팅의 자연어 명령만으로 Homey 디바이스 제어, 예약 작업(cron), HEARTBEAT 점검을 한곳에서 실행할 수 있습니다. 일상적인 제어는 채팅에서 바로 처리하고, 반복 작업은 예약으로 등록하며, 운영 체크리스트는 HEARTBEAT.md로 주기적으로 점검할 수 있습니다. 무엇을 할 수 있나요? - 채팅 기반 자연어 명령: Telegram 채팅으로 요청하면 결과를 다시 채팅으로 수신 - 디바이스 제어: 조명/스위치 ON/OFF, 상태 조회 - 디바이스 정보 조회: capability 확인, 현재 값 읽기 - 예약 작업 자동화: 지연 실행/반복 실행, 일정 조회/삭제 - HEARTBEAT 점검: HEARTBEAT.md 체크리스트 기반 주기 점검 - 스킬 관리: 설정에서 사용자 스킬 생성/수정/삭제 - 웹 검색(옵션): 날씨/뉴스 질의 시 최신 웹 컨텍스트 참고 빠른 시작 1. Homey 앱 설정에서 Telegram 토큰과 허용 chat id를 입력합니다. 2. Planner provider를 선택합니다. - 권장: local llm (LM Studio) - 대안: OpenAI API 3. local llm 사용 시 LLM 서버 주소를 입력합니다. 4. Telegram에서 테스트 명령을 보냅니다. - 예: 조명 켜줘 5. 예약 명령을 테스트합니다. - 예: 1분 뒤에 조명 꺼줘 6. 채팅에서 사용자 스킬을 생성한 뒤, 설정 > User Skills에서 조회 또는 삭제합니다. - 예: "night-brief" 스킬을 만들고 오늘 밤 일정 요약 안내문 작성 프로바이더 설정 1) local llm (권장) - Desktop app: LM Studio - 서버 설정: Serve on Local Network 활성화 - API endpoint: POST /v1/chat/completions - 예시 URL: http://<IP>:<PORT>/v1/chat/completions 2) OpenAI - 개인 API Key 입력 - 사용할 모델 선택 명령 예시 1) 기기 제어/조회 - 조명 켜줘 - 실내 온습도 알려줘 - 라디오 재생해줘 2) 일정 자동화 - 30분 뒤에 제습기 꺼줘 - 매주 화요일 9시에 오늘 날씨 알려줘 - 현재 등록된 일정 알려줘 - 1번 일정 삭제 3) 웹 검색(옵션 활성화 시) - 오늘 서울 날씨 알려줘 - 오늘 주요 IT 뉴스 요약해줘 4) 스킬 관리 - 반복 작업용 사용자 스킬 생성 - 설정에서 생성된 사용자 스킬 조회 - 설정에서 사용하지 않는 사용자 스킬 삭제 - AccuWeather 사용자 스킬 예시(당일 날씨 요약) - 스킬 이름: `accuweather-today-summary` - 권장 Secret 이름: `ACCUWEATHER_TOKEN` - API URL 예시: `https://dataservice.accuweather.com/forecasts/v1/daily/1day/{local_code}?apikey=${SECRET:ACCUWEATHER_TOKEN}&details=true&metric=true&language=ko-kr` - Instructions 작성 예시: "`fetch`로 API를 호출하고 `Headline.Text`, 주/야간 예보 문구, 최저/최고 기온을 읽어 오늘 날씨를 한국어로 짧게 요약해서 반환." HEARTBEAT 사용 방법 HEARTBEAT.md에 점검 항목을 체크리스트로 작성하면 주기적으로 실행됩니다. 예시: - [ ] check cron due job execution status - [ ] check telegram polling status 참고 - 웹 검색 기능은 기본 비활성입니다. - 웹 검색 사용 시 Tavily API Key 설정이 필요합니다. - 사용자 스킬은 설정 > User Skills에서 관리합니다.