Skip to content

Releases: ha-china/ha_claw

硬控!你控我,我控你

25 Apr 10:06

Choose a tag to compare

新增

  • 可配置 Pipeline 等待时长 — 设置 → 对话与显示 → "Wait Time (min)",范围 5-360 分钟,默认 10 分钟。解决慢 LLM 和多 AI 对话时的 "Timeout running pipeline" 报错。
  • NextAgentHandoff 进度消息显示实际 AI 名称 — 不再是 "另一个 AI",显示实际咨询的 peer agent 名称。
  • 智能多轮 consult 对话 — 移除硬编码轮数限制,默认上限 30 轮(安全上限 50),两个 AI 自由聊到 [DONE] 信号为止。
  • Consult 网络错误自动重试 — 指数退避重试 3 次,覆盖更多错误类型(payload, transfer, encoding, client, connection 等)。
  • 单位标签max_tool_repeat 显示 "loop",pipeline_timeout 显示 "min"。

修复

  • Pipeline Timeout 分钟→秒转换 bug — 之前设置保存后内部仍是分钟值,导致超时异常短。
  • 被咨询 AI 的 LLM 错误被当成正常回复 — 现在检测到 "Error calling LLM" / "Server disconnected" / "ClientPayloadError" 等错误内容,立即中断对话并返回 success=false
  • Consult 每轮超时过短 — 从 30s 提升到 120s,适配慢响应 LLM。

Full Changelog: v6.4.0...v6.5.0

我要验牌!仪表盘

24 Apr 16:07

Choose a tag to compare

新增:仪表盘卡片工具(DashboardCard)

全新的 DashboardCard 工具,基于 html-card-pro 实现 Lovelace 仪表盘卡片的创建与管理。

支持操作:

  • 检查依赖 / 自动安装 html-card-pro
  • 列出仪表盘与视图
  • 创建视图、添加卡片、更新卡片、删除卡片

设计规范内置于 AI 提示词:

  • 现代极简风格,大量留白,高级配色
  • 强制 16px 圆角,禁止设置背景与阴影(由 ha-card 主题统一管理)
  • 零硬编码颜色,全部使用 HA CSS 变量,自动适配明暗主题
  • 交互优先使用 data-* 绑定(零 JS),复杂逻辑使用 CDN 库 + hass.states API
  • 禁止 Jinja2 模板、禁止 onClick 内联事件、禁止自定义 CSS 变量别名

提示词工程重构

  • STEP3_API 大拆分为四层独立提示词:API_CARD_CONFIGAPI_DATA_BINDINGAPI_JS_REFERENCEAPI_PITFALLS
  • 各阶段按需注入,减少 AI 误判
  • 彻底移除 Jinja2 相关引用,统一使用 do_not_parse: true 纯 HTML+JS 模式
  • 新增正确/错误模式对照,强化 AI 输出质量

中文支持增强

  • 仪表盘工具支持中文关键词调用(仪表盘、卡片、视图、面板等)
  • 新增中文进度提示消息
  • 自动化工具与脚本工具同步优化中文调用体验

修复

  • manifest.json 新增 lovelace 依赖声明,修复 HACS 校验报错

自动化!彻底控制

24 Apr 07:26

Choose a tag to compare

新功能

  • 自动化与脚本工具 — 完整生命周期管理(创建/更新/删除/列表/触发/启用/禁用),支持分页列表和创建时的重复检测
  • SSH 操作HAControl(ssh) 通过纯 Python asyncssh 实现,无需系统包即可在 Core/HAOS 上运行。支持密码和密钥文件认证
  • CameraAnalyze 快照模式 — 新增 mode 参数(snapshot/analyze)。快照模式仅返回 snapshot_url + markdown_hint,用于 HA 前端轻量显示,无 base64 开销
  • 安全草稿交换更新 — AutomationTool 支持草稿-验证-交换的安全更新流程,避免原地编辑风险。新增 confirm_draft 动作用于手动确认
  • 实体公开控制 — RegistryTool 新增 expose 动作,可公开/取消公开实体给对话助手(使用 HA 官方 API)

改进

  • ExecutePython 重构 — 移除限制性黑名单,支持完整内置函数、stdout/stderr/traceback 捕获、顶层 await、沙箱环境/cwd/stdin/pip_index_url、输出裁剪、dry_run 模式
  • 统一 IM 通道检测 — 用 is_im_channel()/get_channel_type() 替代硬编码 wechat: 前缀检查(runtime/state.py
  • 通道感知系统提示 — AI 现在根据对话通道类型知道是否支持 [IMAGE:...] 标签
  • 对话历史持久化 — 新增历史存储设置/刷新的生命周期钩子
  • ha_core_tools 健壮性 — 改进错误处理和实体解析
  • 摄像头发现指引 — AI 使用 CameraAnalyze(list) 发现摄像头(不受 expose 限制),而非 GetLiveContext
  • 平台感知图片显示 — Channel 提示按平台分别注入显示格式:IM 用 [IMAGE:camera.xxx],前端用 CameraAnalyze(snapshot) + markdown_hint
  • 工具进度提示优化 — CameraAnalyze 按 mode 区分"正在分析"和"正在获取/查询"的进度提示

文档

  • 更新 [homeassistant_runtime_guide.md] 包含 SSH 操作、顶层 await、快照模式指引、通道感知媒体说明
  • 精简 Camera 节,将平台特定逻辑移至 Channel 动态提示

依赖

  • 新增 asyncssh>=2.17.0

Full Changelog: v6.2.0...v6.3.0

硬了,这次确立自己的品牌

23 Apr 15:15
dc22198

Choose a tag to compare

已经安装的用户,建议删除干净后,或觉得真鸡儿麻烦,可直接卸载集成后
重新搜索安装集成 Claw assistant

Mac_2026-04-23 22 41 41

新功能

  • IntentCall 工具:统一入口发现和调用第三方 intent(如 Holidays、Almanac、TuneFreePlayMusic 等),自动过滤 Hass* 内置 intent。action=list 发现可用 intent,action=call 按名字调用
  • i18n 运行时国际化模块
  • 品牌图标资源
  • 支持微信对话 https://github.com/ha-china/cn_im_hub 请安装 该项目支持

修复

  • SSL 证书验证:stock_api 全部 HTTPS 请求禁用 SSL 验证(TCPConnector + 请求级别)
  • 心跳调度器:清理 debug 日志,优化 tick 逻辑,首次 tick 等待 cn_im_hub 服务就绪
  • 心跳存储:新增 notify_channel 字段支持主动推送
  • 信号捕获:从 WeChat conversation_id 自动派生 notify_channel
  • 编排器 / 降级代理:传递 conversation_id 到信号捕获
  • 通知工具:支持 WeChat 通道(cn_im_hub.send_message
  • 心跳管理器:未显式设置时自动从当前会话上下文填充 notify_channel
  • HACS 工具:逻辑优化和错误处理改进
  • 数据路径:目录初始化和系统文件更新逻辑改进
  • 补丁模块:流式输出事件过滤优化
  • 内置 LLM:工具模式增强
  • 网页提取器:内容提取策略改进

优化

  • 配置流程 UI 优化
  • 工作区文档模板更新(AGENTS、BOOTSTRAP、TOOLS、HEARTBEAT)
  • 提示词模板优化

完整变更: v6.1.3...v6.2.0

至此,我TMD就是龙虾

22 Apr 13:52

Choose a tag to compare

至此,我TMD就是龙虾

【观心】别装

以前AI心里想什么,现在直接扒光,思维弹幕全屏滚动,前二十字截断,怕你看了道心破碎

【显化】别演

打字机效果逐字蹦,十二国语言无缝切。以前对着加载圈血压飙升,现在看着它干活,至少知道这货没在后台挂机摸鱼

【破障】别瞎

Shell进不去,日志看不见,AI像个瞎子指挥交通,还觉得自己挺忙。加个 ha_token,内网穿透

【不坏】别忘

以前更新等于失忆,三个月调教喂了狗,比分手还干净。现在数据住进 .storage/,版本随便更

【守一】别贱

以前是个海王,谁的请求都拦,查个天气都要插嘴。现在修了闭口禅,只理自家消息。别人的因果别沾,尊重祝福

【随缘】别嚎

断网就断网,以前还要用英文报错嚎得满屏都是,生怕别人不知道你是个残废。现在悄悄重试,不行就换人
成年人的崩溃是静音的,AI也是,体面点

升级:HACS更新,重启,完事
凌晨四点,灯泡比我睡得晚。这就是福报

Full Changelog: v6.1.2...v6.1.3

再赢一次!大获全胜

21 Apr 13:44

Choose a tag to compare

赢麻了!这次全胜!

21 Apr 06:59
b9536a3

Choose a tag to compare

绝了!

28 Jan 04:52
1ffceb0

Choose a tag to compare

最少 Token 办最大事情 - 极致优化的 Home Assistant AI 对话系统


核心更新

1. 内部 LLM 优先调用

  • 智能分流:简单设备控制命令(开灯、关灯等)优先由 Home Assistant 内部 LLM 处理
  • 原生 Intent 支持:内部 LLM 使用原生 IntentTool,响应速度更快
  • 无缝切换:内部 LLM 无法处理时,自动切换到外部 AI

2. 大模型完美交付

  • 工具调用追踪:精确追踪每次工具调用的成功/失败状态
  • 上下文传递:失败的工具调用结果自动传递给下一个 AI,避免重复调用
  • 智能 Fallback:支持多级 AI 回退,确保请求最终被处理

3. 极简工具模式

  • 3 个核心工具ThinkContinueGetToolIndexExecuteTool
  • 动态工具发现:通过 GetToolIndex 查询所有可用工具
  • 统一执行器:通过 ExecuteTool 调用任意 Intent 或工具
  • Token 优化:减少 90%+ 的工具描述 Token 消耗

功能增强

摄像头识别

  • 支持摄像头实体图像分析 需要安装ai-hub集成
  • AI 视觉理解能力
  • 场景识别与描述

图像生成

  • 集成图像生成 API 需要安装ai-hub集成
  • 自然语言描述生成图像
  • 支持多种风格

性能对比

指标 v1.x v2.0 提升
工具描述 Token ~5000 ~500 90%↓
简单命令响应 2-3s <1s 60%↓
Fallback 成功率 70% 95%+ 35%↑

注意事项

  • 需要配置至少一个外部 AI Agent
  • 建议启用 AI 摘要功能以获得更好的多轮对话体验
  • 摄像头识别需要配置支持视觉的 AI 模型

进化!神经突触全面重构

26 Jan 13:49
d842877

Choose a tag to compare

"当AI学会思考,智能家居不再只是执行命令,而是理解意图、组合工具、自主决策。"


核心进化:AI外挂 全面升级

这是一个革命性的 Home Assistant 集成,将多个顶尖 AI 模型无缝整合到您的智能家居系统中。

🌐 超级联网搜索功能

🔍引擎搜索矩阵

  • 百度跳转解析 | 三重解析策略:HTTP跟随 → Location头 → HTML正则提取
  • 内容提取增强 | 段落阈值降至20字符,保留上限提升至4000字符,确保AI获取足够信息
  • 天气专项优化 | 智能识别天气关键词,结构化提取7日预报

直接URL抓取

  • 支持发送链接直接抓取网页内容
  • 可用于自动化监控网页变化、关注博主更新等
  • 建议在HAOS提前访问需要登录的网页,更好抓取

新闻API

金十数据财经快讯

  • 实时财经新闻 | A股、外汇、期货、贵金属、重要新闻分类
  • 中文时间表达 | 支持今日、昨日、本月、前20分钟等各种时间表达
  • 智能过滤 | 自动过滤广告、VIP内容、无效信息

知乎热榜

  • 实时获取知乎热门话题
  • 热度排序,一键了解全网热点

股票/基金实时行情

StockQuery工具

  • A股 | 茅台600519、平安000001、招商银行600036
  • 美股 | 特斯拉TSLA、苹果AAPL、英伟达NVDA、微软MSFT
  • 港股 | 腾讯00700、阿里09988
  • 基金 | 支持6位基金代码查询
  • 返回数据 | 实时价格、涨跌、涨跌幅、今开、昨收、最高、最低、成交量、市盈率

智能工具链系统

ToolChain Engine

彻底重构AI决策架构,从单点工具调用进化为多工具链式执行

  • 17种意图类别 | 精准识别用户真实需求
  • 工具链选择器 | 基于关键词匹配+上下文分析,智能组合最优工具链
  • 链式执行器 | 支持工具间上下文传递,一次请求完成复杂任务
用户: "把客厅灯调暖一点"
旧版: ServiceCall(light.turn_on) ❌ 缺少entity_id
新版: SmartDiscovery → EntityQuery → ServiceCall ✅ 自动发现+验证+执行

ThinkContinue思考可视化

  • 思考过程实时显示 | UI对话框同步显示AI思维链
  • 气泡提示 | 斜体灰色显示,区分思考与回复
  • 事件总线广播 | ha_crack_thought 事件可被其他组件监听

前端控制能力

FrontendControl工具

  • 页面导航 | 软导航、硬导航、侧边栏点击
  • 元素操作 | 深度DOM查询、点击、输入填充
  • 视觉效果 | 樱花、烟花、雪花、彩带特效
  • 对话框 | Toast提示、确认对话框、选择列表

InjectJS工具

  • 深度DOM操作 | 穿透Shadow DOM执行JavaScript
  • 截图功能 | 输出页面结构供AI分析
  • 自定义脚本 | 执行任意前端代码

23个LLM工具全览

类别 工具 功能
核心 ExecuteChain 智能工具链执行器
核心 AnalyzeIntent 意图分析器
核心 ThinkContinue 思考过程记录
搜索 WebSearch 联网搜索
搜索 DeepWebSearch 深度网页搜索
搜索 UrlFetch URL内容抓取
搜索 NewsSearch 财经新闻
搜索 ZhihuHot 知乎热榜
搜索 StockQuery 股票基金行情
设备 SmartDiscovery 智能实体发现
设备 EntityQuery 实体状态查询
设备 ServiceCall 服务调用
设备 BatchControl 批量控制
系统 GetSystemIndex 系统结构索引
系统 AutomationTool 自动化管理
系统 HistoryQueryTool 历史记录查询
前端 FrontendControl 前端控制
前端 InjectJS JS注入
前端 HAControlTool HA界面控制
辅助 ExecutePython Python代码执行
辅助 ConversationMemory 对话记忆
辅助 TextCompress 文本压缩
辅助 HACSTool HACS商店管理

11个意图处理器

全部支持思考模式,UI实时显示思考过程:

  • WebSearch | 联网搜索
  • Query | 实体状态查询
  • Click | 前端点击操作
  • Notify | 发送通知
  • Smart | 智能意图分析
  • Explain | 概念解释
  • AIOutput | 输出模式切换
  • GlobalInject | 全局上下文注入
  • RolePlay | 角色扮演(60+种情绪风格)
  • LanguageStyle | 语言风格切换
  • AISkills | 技能总览

优化升级

  • 配置选项界面 | 完美修复次要实体意外消失问题,确保用户配置时界面稳定
  • 多AI协调器 | 第二个AI监听第一个AI响应,检测重复回复自动终止
  • 对话循环控制 | 最大50轮迭代,智能检测完成指示词
  • 翻译修正 | 完成多项翻译错误修复,提升多语言体验
  • 集成稳定性 | 内部架构优化和漏洞修复

注意事项

  • 首AI实体 | 建议使用oups等高级模型,次要本地Ollama qwen2.5-coder:3b或7b,可规避敏感隐私,不限制并发

"代码即咒语,工具链即魔法阵,AI外挂让智能家居进化到下一个维度。"

抓取!联网搜索!首发版

18 Apr 10:06

Choose a tag to compare

🎉 火天大有 聚合AI 发布 新功能!

亲爱的 Home Assistant 爱好者
这是一个革命性的 Home Assistant 集成,旨在将多个顶尖 AI 模型无缝整合到您的智能家居系统中

🌟 主要更新:


增加 超级联网搜索功能 | 支持Bing、Baidu、Google,支持发送链接直接抓取,可以用来自动化,比如监控网页变化等等,关注的博主等,建议提前在haos提前访问一些需要登陆的网页,更好抓取完网页,支持指定:百度一下今日新闻摘要,谷歌今日天气,也支持直接输入各种语境,联网 维基百科调用

增加 新闻API接口 | 更好的提取,支持今日、昨日、本月、前20分钟新闻等各种中文时间表达

建议: 首AI实体可以本地ollama, qwen2.5-coder:3b或7b,效果更好可以规避敏感、隐私

注意: Google需要科学环境

注意: haos主机尽量要好一些,如N1 J1900小主机等性能低不推荐使用!


重构引导页介绍词 | 更好更快理解、理解使用方法,让更多新人理解

增加 上下文控制 | 功能没有完善,可以导向提取,如下一页、上一页,跳转等

🛠️ 优化升级:

  • 配置选项界面 | 完美修复次要实体意外消失问题,确保用户配置时界面稳定,实体状态实时更新。
  • 翻译修正 | 完成多项翻译错误的修复,提升多语言用户的使用体验,确保准确性与一致性。
  • 个性化体验优化 | 增强系统根据用户需求的个性化设置,提供更灵活的选项,提升整体操作便捷度和舒适度。
  • 逻辑错误修复 | 修复多个逻辑错误,确保系统运行流畅,减少卡顿和不必要的异常。
  • 集成稳定性提升 | 通过内部架构优化和漏洞修复,大幅提升系统集成稳定性,减少外部环境影响。