itsyhome-control

TotalClaw 作者 totalclaw

通过Itsyhome macOS应用程序（https://itsyhome.app）控制和查询HomeKit和Home Assistant智能家居设备。当用户要求打开/关闭设备、切换灯光、设置亮度/温度/颜色/风扇速度/百叶窗位置、锁定/解锁门、打开/关闭车库门、运行场景、列出房间或设备、检查设备状态或状态时使用。需要 Itsyhome Pro 与 OpenClaw 网关在同一台 Mac 上运行。触发任何智能家居控制意图（灯、恒温器、锁、百叶窗、风扇、摄像头、场景、组）。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~nickustinov-itsyhome-control

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~nickustinov-itsyhome-control/file -o nickustinov-itsyhome-control.md

## 概述（中文）

通过Itsyhome macOS应用程序（https://itsyhome.app）控制和查询HomeKit和Home Assistant智能家居设备。当用户要求打开/关闭设备、切换灯光、设置亮度/温度/颜色/风扇速度/百叶窗位置、锁定/解锁门、打开/关闭车库门、运行场景、列出房间或设备、检查设备状态或状态时使用。需要 Itsyhome Pro 与 OpenClaw 网关在同一台 Mac 上运行。触发任何智能家居控制意图（灯、恒温器、锁、百叶窗、风扇、摄像头、场景、组）。

## 原文

# Itsyhome Control

Itsyhome exposes a local HTTP webhook server (default port `8423`) and a URL scheme (`itsyhome://`).

**Prerequisites:** Itsyhome Pro, webhook server enabled in Settings → Webhooks.

## Core Pattern

All control and query happens via `curl http://localhost:8423/<action>/<target>`.

- Targets use `Room/Device` format or just `DeviceName`
- Spaces → `%20` in URLs
- On success: `{"success": true}` or JSON data
- On failure: `{"error": "..."}` with HTTP 4xx

## Workflow

1. **If target is ambiguous** → `curl http://localhost:8423/list/devices` to find exact names
2. **To check current state** → `curl http://localhost:8423/info/<target>`
3. **To control** → appropriate action endpoint (see references/api.md)
4. **Confirm to user** with what was done; include state if queried

## Quick Reference

```bash
# Status
curl http://localhost:8423/status

# List
curl http://localhost:8423/list/rooms
curl http://localhost:8423/list/devices
curl http://localhost:8423/list/devices/Kitchen

# Query
curl http://localhost:8423/info/Office/Spotlights

# Control
curl http://localhost:8423/toggle/Office/Spotlights
curl http://localhost:8423/on/Kitchen/Light
curl http://localhost:8423/brightness/50/Bedroom/Lamp
curl http://localhost:8423/scene/Goodnight
```

For the full endpoint list, all control actions, and URL scheme reference: see [references/api.md](references/api.md).