Home Claw

This app is a local-first AI assistant for Homey. If checking device states, creating schedules, and managing routine checks separately feels tedious, this app brings them into one flow. With natural-language commands in Telegram chat, you can control Homey devices, run scheduled jobs (cron), and perform HEARTBEAT checks in a single place. Use chat for everyday device actions, register recurring tasks as schedules, and keep operational checklists running periodically with HEARTBEAT.md. What You Can Do - Chat-based natural-language commands: request in Telegram chat and receive results in the same chat - Device control: turn lights/switches on or off, check status - Device info: inspect capabilities and current values - Scheduling: delayed jobs, recurring jobs, list/remove jobs - HEARTBEAT checks: periodic operational checks from HEARTBEAT.md - Skill management: create user skills in chat, view/delete them in Settings - Web search (optional): use fresh web context for weather/news questions Quick Start 1. In Homey app settings, set your Telegram bot token and allowed chat id. 2. Select planner provider. - Recommended: local llm (LM Studio) - Alternative: OpenAI API 3. If using local llm, set your LLM server URL. 4. Send a test command in Telegram. - Example: Turn on the light. 5. Test a scheduled command. - Example: Turn off the light in 1 minute. 6. Create a custom skill in chat, then open Settings > User Skills to view or delete it. - Example: "Create a skill named night-brief and summarize tonight's schedule." Provider Setup 1) local llm (recommended) - Desktop app: LM Studio - Server option: enable "Serve on Local Network" - API endpoint: POST /v1/chat/completions - Example URL: http://<IP>:<PORT>/v1/chat/completions 2) OpenAI - Enter your personal API key - Select the model Command Examples 1) Device control/status - Turn on the light - Tell me indoor temperature and humidity - Play the radio 2) Scheduling - Turn off dehumidifier in 30 minutes - Tell me today's weather every Tuesday at 9 AM - Show all scheduled jobs - Remove job number 1 3) Web search (when enabled) - Tell me today's weather in Seoul - Summarize today's major IT news 4) Skill management - Create a user skill for repeated tasks - View created user skills in Settings - Delete unused user skills in Settings - AccuWeather custom skill example (today weather summary) - Skill name: `accuweather-today-summary` - Recommended secret name: `ACCUWEATHER_TOKEN` - API URL example: `https://dataservice.accuweather.com/forecasts/v1/daily/1day/{local_code}?apikey=${SECRET:ACCUWEATHER_TOKEN}&details=true&metric=true&language=ko-kr` - Instruction idea: "Call the API with `fetch`, read `Headline.Text`, day/night forecast text and temperature range, then return a short Korean summary for today." HEARTBEAT Usage Write checklist items in HEARTBEAT.md and Home Claw will process them periodically. Example: - [ ] check cron due job execution status - [ ] check telegram polling status Notes - Web search is disabled by default. - Tavily API key is required to use web search. - User skills are created in chat and can be viewed/deleted in Settings > User Skills.