HomeClaw — плагин
Плагин для Claude Code и MCP-сервер: агент включает свет, запирает замки и запускает сценарии Apple HomeKit на Mac
- 191 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент управляет физическими устройствами: замками, термостатами, освещением и автоматизациями
- Инструменты переименовывают, создают и удаляют комнаты, зоны, сценарии и автоматизации в вашем доме HomeKit
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/homeclawОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент управляет физическими устройствами: замками, термостатами, освещением и автоматизациями
- Инструменты переименовывают, создают и удаляют комнаты, зоны, сценарии и автоматизации в вашем доме HomeKit
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
У Apple HomeKit нет публичного API для macOS, поэтому HomeClaw работает как приложение в строке меню на Mac Catalyst: оно обращается к HomeKit напрямую и открывает локальный сокет. Поверх сокета сделаны три слоя: консольная утилита `homeclaw-cli`, stdio MCP-сервер на Node.js и плагин для Claude Code со скиллом `homeclaw`. Агент получает команды вроде «выключи весь свет», «поставь термостат на 22» или «запусти сценарий вечер». MCP-сервер открывает десять инструментов. `homekit_accessories` ищет и переключает устройства, `homekit_rooms` и `homekit_scenes` работают с комнатами и сценариями, `homekit_device_map` отдает карту устройств с типами и алиасами для модели. `homekit_manage` переименовывает устройства и комнаты, `homekit_automations` создает автоматизации по кнопкам, датчикам и времени, `homekit_events` читает недавние события, `homekit_webhook` и `homekit_config` настраивают вебхук и дом по умолчанию. Дополнительно в настройках приложения включается Streamable HTTP MCP на `127.0.0.1:9090`.
Для кого. Владельцам умного дома на HomeKit и Mac, которые хотят управлять светом, замками и сценариями голосом через чат с агентом.
Подходит, если
- Нужно одной фразой выключить свет по комнатам или категории устройств, не открывая приложение «Дом»
- В доме десятки устройств с неудобными названиями, и агент должен навести порядок: переименовать, раскидать по комнатам и зонам
- Нужны автоматизации по кнопкам и датчикам, которые приложение «Дом» создает неудобно
- Состояние дома надо разобрать: какие лампы включены, какая температура, что сработало за последние часы
- Сценарии и серии команд скриптуются из терминала через `homeclaw-cli`
Не подходит, если
- Дом на Home Assistant: у плагина нет интеграции с ним, нужен другой MCP-сервер
- Нет Mac: приложение работает только на macOS, а HomeKit без него недоступен
- Замки и сигнализация без отдельного подтверждения: агент может выполнить команду по неверно понятой фразе
Пример запроса к агенту
Выключи весь свет на кухне, поставь термостат на 22 градуса и запусти сценарий "Спокойной ночи"Ограничения
- Приложение HomeClaw должно быть запущено и иметь доступ к HomeKit. Без него MCP-сервер и CLI не подключатся.
- Сборка из исходников требует macOS 26, Xcode 26 и аккаунта Apple Developer с правом HomeKit, потому что Apple ограничивает это право. Проще взять версию из Mac App Store.
- Streamable HTTP MCP по умолчанию выключен и слушает только петлевой адрес.
- Инструменты могут менять реальные устройства: замки, термостаты, автоматизации.
Как отключить. Выполните `/plugin uninstall homeclaw@homeclaw`. Приложение HomeClaw удаляется как обычное приложение macOS, а доступ HomeKit можно отозвать в системных настройках.
Частые вопросы
Как поставить HomeClaw в Claude Code?
Установите приложение из Mac App Store и выдайте доступ к HomeKit. Затем выполните `/plugin marketplace add https://github.com/omarshahine/HomeClaw` и `/plugin install homeclaw@homeclaw`.
Почему нужен запущенный Mac?
Apple отдает HomeKit только приложениям с особым правом, поэтому HomeClaw работает как приложение в строке меню. MCP-сервер и CLI обращаются к нему через локальный сокет.
Как подключить HomeClaw к Claude Desktop?
В настройках приложения откройте Integrations и поставьте сервер в один клик либо добавьте в конфиг команду `node` с файлом `/Applications/HomeClaw.app/Contents/Resources/mcp-server.js`.
Что даст Streamable HTTP MCP?
Подключение клиентов без stdio, например Hermes, по адресу `http://127.0.0.1:9090/mcp`. Режим выключен по умолчанию и закрыт для сети.
Можно ли управлять домом без агента?
Да. Утилита `homeclaw-cli` принимает команды `list`, `set`, `trigger`, `scenes`, `automations` и другие, а вывод читается с флагом `--json`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныMCP-сервер на Node.js, через который агент управляет устройствами Home Assistant и правит его автоматизации
CLI для умного дома SwitchBot: устройства и сцены из терминала, MCP-сервер для Claude Code, Codex и Gemini CLI.
MCP-сервер для Home Assistant: агент читает состояние умного дома и управляет устройствами через ваш экземпляр
MCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
MCP сервер для Home Assistant: агент читает состояние устройств, управляет ими и правит дашборды умного дома
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
Коротко о README
Файл показывает три способа управлять домом: консоль, MCP-сервер и плагины. Затем идут устройство приложения на Mac Catalyst, схема связей, установка из Mac App Store, TestFlight или из исходников и таблица инструментов MCP. Отдельные разделы посвящены Claude Code, OpenClaw, CLI и политике подписи, которую требует Apple.