HomeClaw

Apple HomeKit 以其安全性和隐私保护著称，但其封闭性也带来了巨大局限：没有公共 API、没有命令行界面、难以与第三方自动化工具或 AI 助手集成。HomeClaw 是一款基于 macOS 的轻量级菜单栏应用，通过暴露干净的 API 接口，填补了 HomeKit 与外部世界之间的鸿沟。

借助 Model Context Protocol (MCP) 和命令行工具，HomeClaw 让你能够使用 Claude Code、OpenClaw 甚至简单的 Shell 脚本来控制灯光、恒温器及传感器。无论是让 AI 助手“关掉客厅所有灯”，还是编写复杂的条件自动化脚本，HomeClaw 都将 HomeKit 从“手机 App 专属”解放为“可编程基础设施”。

核心亮点：AI 原生集成、CLI 控制、单进程架构

1. AI 助手无缝集成 (MCP)

• Claude Code / OpenClaw 插件：通过标准的 stdio MCP 服务器，HomeClaw 将 HomeKit 配件暴露为 AI 可调用的工具。
• 自然语言控制：
  • “Claude，把卧室温度调到 72 度。”
  • “OpenClaw，当我离开家时关闭所有非安全类设备。”
• 智能上下文理解：AI 可识别设备名称、房间、类别及语义类型，执行精准操作。

2. 终端脚本与自动化

• CLI 工具 (homeclaw-cli)：提供完整的命令行接口，支持查询状态、开关设备、调整亮度等。
• 脚本化自动化：结合 cron、LaunchAgents 或其他调度工具，构建超越“家庭”App 限制的高级自动化流程。
  • 示例：根据日出时间自动调整窗帘，或在特定网络活动发生时触发警报灯光。

3. 优雅的 Mac Catalyst 单进程架构

• 直接访问 HomeKit：利用 Apple 的 HMHomeManager，HomeClaw 以 Mac Catalyst 应用形式运行，无需复杂的进程间通信 (IPC) 或权限桥接。
• 统一签名与安全：单进程设计确保应用签名统一，符合 App Store 提交规范，同时保障 HomeKit 权限的安全隔离。
• 原生菜单栏体验：通过 macOSBridge.bundle 提供原生 NSStatusItem 菜单栏入口，方便快速查看状态或手动干预。

4. 多维度设备搜索与控制

• 灵活筛选：支持按设备名称、房间、类别（如灯光、传感器）或语义类型进行搜索。
• 批量操作：一键控制整个房间或特定类别的所有设备，提升管理效率。

适用场景

架构详解

HomeClaw 采用高效的单进程设计，确保低延迟与高稳定性：

graph TD
    A[Claude Code / OpenClaw] -->|Plugin| B[stdio MCP Server (Node.js)]
    C[Claude Desktop] -->|Direct| B
    D[Terminal / Scripts] -->|CLI| E[homeclaw-cli]
    
    B -->|Unix Socket (JSON ND)| F[HomeClaw App]
    E -->|Unix Socket (JSON ND)| F
    
    subgraph "HomeClaw (Mac Catalyst)"
        F --> G[SocketServer]
        G --> H[HomeKitManager]
        H -->|Direct Access| I[(HomeKit Framework)]
        F --> J[macOSBridge.bundle]
        J -->|NSStatusItem| K[MenuBar UI]
    end

• HomeKitManager：进程内直接调用 HMHomeManager，避免 IPC 开销，确保实时性。
• SocketServer：监听 Unix Socket，处理来自 CLI 和 MCP 服务器的 JSON 换行符分隔请求。
• macOSBridge：提供原生 macOS 菜单栏界面，作为图形化补充。