Home Claw - AI agent for Homey

Apps
,
1

HomeClaw 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.

install Home Claw

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://:/v1/chat/completions
  1. 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
  1. 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
  1. Web search (when enabled)
  • Tell me today’s weather in Seoul
  • Summarize today’s major IT news
  1. 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.
2 Likes