Releases: ha-china/ha_claw
硬控!你控我,我控你
新增
- 可配置 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
我要验牌!仪表盘
新增:仪表盘卡片工具(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_CONFIG、API_DATA_BINDING、API_JS_REFERENCE、API_PITFALLS- 各阶段按需注入,减少 AI 误判
- 彻底移除 Jinja2 相关引用,统一使用
do_not_parse: true纯 HTML+JS 模式 - 新增正确/错误模式对照,强化 AI 输出质量
中文支持增强
- 仪表盘工具支持中文关键词调用(仪表盘、卡片、视图、面板等)
- 新增中文进度提示消息
- 自动化工具与脚本工具同步优化中文调用体验
修复
- manifest.json 新增
lovelace依赖声明,修复 HACS 校验报错
自动化!彻底控制
新功能
- 自动化与脚本工具 — 完整生命周期管理(创建/更新/删除/列表/触发/启用/禁用),支持分页列表和创建时的重复检测
- SSH 操作 —
HAControl(ssh)通过纯 Pythonasyncssh实现,无需系统包即可在 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
硬了,这次确立自己的品牌
已经安装的用户,建议删除干净后,或觉得真鸡儿麻烦,可直接卸载集成后
重新搜索安装集成 Claw assistant
新功能
- 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就是龙虾
至此,我TMD就是龙虾
【观心】别装
以前AI心里想什么,现在直接扒光,思维弹幕全屏滚动,前二十字截断,怕你看了道心破碎
【显化】别演
打字机效果逐字蹦,十二国语言无缝切。以前对着加载圈血压飙升,现在看着它干活,至少知道这货没在后台挂机摸鱼
【破障】别瞎
Shell进不去,日志看不见,AI像个瞎子指挥交通,还觉得自己挺忙。加个 ha_token,内网穿透
【不坏】别忘
以前更新等于失忆,三个月调教喂了狗,比分手还干净。现在数据住进 .storage/,版本随便更
【守一】别贱
以前是个海王,谁的请求都拦,查个天气都要插嘴。现在修了闭口禅,只理自家消息。别人的因果别沾,尊重祝福
【随缘】别嚎
断网就断网,以前还要用英文报错嚎得满屏都是,生怕别人不知道你是个残废。现在悄悄重试,不行就换人
成年人的崩溃是静音的,AI也是,体面点
升级:HACS更新,重启,完事
凌晨四点,灯泡比我睡得晚。这就是福报
Full Changelog: v6.1.2...v6.1.3
再赢一次!大获全胜
赢麻了!这次全胜!
Full Changelog: v5.1.1...v6.1.1
绝了!
最少 Token 办最大事情 - 极致优化的 Home Assistant AI 对话系统
核心更新
1. 内部 LLM 优先调用
- 智能分流:简单设备控制命令(开灯、关灯等)优先由 Home Assistant 内部 LLM 处理
- 原生 Intent 支持:内部 LLM 使用原生 IntentTool,响应速度更快
- 无缝切换:内部 LLM 无法处理时,自动切换到外部 AI
2. 大模型完美交付
- 工具调用追踪:精确追踪每次工具调用的成功/失败状态
- 上下文传递:失败的工具调用结果自动传递给下一个 AI,避免重复调用
- 智能 Fallback:支持多级 AI 回退,确保请求最终被处理
3. 极简工具模式
- 3 个核心工具:
ThinkContinue、GetToolIndex、ExecuteTool - 动态工具发现:通过
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 模型
进化!神经突触全面重构
"当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外挂让智能家居进化到下一个维度。"
抓取!联网搜索!首发版
🎉 火天大有 聚合AI 发布 新功能!
亲爱的 Home Assistant 爱好者
这是一个革命性的 Home Assistant 集成,旨在将多个顶尖 AI 模型无缝整合到您的智能家居系统中
🌟 主要更新:
增加 超级联网搜索功能 | 支持Bing、Baidu、Google,支持发送链接直接抓取,可以用来自动化,比如监控网页变化等等,关注的博主等,建议提前在haos提前访问一些需要登陆的网页,更好抓取完网页,支持指定:百度一下今日新闻摘要,谷歌今日天气,也支持直接输入各种语境,联网 维基百科调用
增加 新闻API接口 | 更好的提取,支持今日、昨日、本月、前20分钟新闻等各种中文时间表达
建议: 首AI实体可以本地ollama, qwen2.5-coder:3b或7b,效果更好可以规避敏感、隐私
注意: Google需要科学环境
注意: haos主机尽量要好一些,如N1 J1900小主机等性能低不推荐使用!
重构引导页介绍词 | 更好更快理解、理解使用方法,让更多新人理解
增加 上下文控制 | 功能没有完善,可以导向提取,如下一页、上一页,跳转等
🛠️ 优化升级:
- 配置选项界面 | 完美修复次要实体意外消失问题,确保用户配置时界面稳定,实体状态实时更新。
- 翻译修正 | 完成多项翻译错误的修复,提升多语言用户的使用体验,确保准确性与一致性。
- 个性化体验优化 | 增强系统根据用户需求的个性化设置,提供更灵活的选项,提升整体操作便捷度和舒适度。
- 逻辑错误修复 | 修复多个逻辑错误,确保系统运行流畅,减少卡顿和不必要的异常。
- 集成稳定性提升 | 通过内部架构优化和漏洞修复,大幅提升系统集成稳定性,减少外部环境影响。
