HaZeroClaw

本仓库承载基于 ZeroClaw 的 Home Assistant add-on 实现，主目录为 zeroclaw/。

ZeroClaw（主入口）

• 架构：aarch64 专用 add-on（见 zeroclaw/config.yaml）。
• 集成：声明 homeassistant_api、hassio_api，启用 Ingress、ingress_stream 与控制面板标题 ZeroClaw Control；host_network: true。
• 状态：已提供元数据、文档、vendored 下载脚本、容器构建定义、运行时脚本与控制面板，具备完整的 ZeroClaw add-on 主链路。
• 持久化目录：统一使用 /data/zeroclaw。

文档与快速开始

• add-on 说明：zeroclaw/README.md
• 安装与排障：zeroclaw/DOCS.md
• 快速开始：zeroclaw/QUICKSTART.zh-Hans.md / zeroclaw/QUICKSTART.en.md
• 版本记录：zeroclaw/CHANGELOG.md

一键开始（添加仓库）

先把官方 Home Assistant MCP 集成加入到你的 HA：

再把本仓库加入 Home Assistant add-on 仓库：

国内网络可使用镜像入口：

手动安装步骤请优先阅读 ZeroClaw 快速开始文档。

MCP 原理（概念仍适用）

1. Home Assistant 官方 mcp_server 暴露 /api/mcp。
2. mcp-proxy 将 Streamable HTTP MCP 桥接为本地 stdio。
3. 网关运行时 ZeroClaw 通过 tools.mcp 消费本地 MCP，工具名形如 mcp_homeassistant_*。

Home Assistant mcp_server (/api/mcp)
        ->
      mcp-proxy
        ->
  Gateway (ZeroClaw) tools.mcp
        ->
  Agent / Gateway

目录结构

• repository.yaml：add-on 仓库元数据（已标注 ZeroClaw 方向）
• zeroclaw/：ZeroClaw add-on（主路线）

当前能力

• ZeroClaw add-on 运行时与 config.toml 映射已完成
• Ingress 控制页、终端与 MCP 工具链已完成集成
• 已提供 CI 校验链路；vendored 下载与镜像构建默认大陆网络优先，失败自动回退官方 upstream。本地构建推荐 zeroclaw/bin/build-addon.sh（先大陆友好 build-arg，失败再官方组合），与 CI（.github/workflows/validate.yml）的双重 docker build 策略一致；高级用户仍可自行传参覆盖。