冬瓜HAOS (wghaos) 知识库

来源：wiki.wghaos.com + bbs.hassbian.com/thread-24065-1-1.html
学习时间：2026-07-25

概述

冬瓜HAOS 是冬瓜HA维护的 Home Assistant 伴侣系统，不是替代 HAOS，而是增强层。

• 英文名：wghaos，仅在瀚思彼岸论坛发布
• 定位：core/supervisor 保持官方原版镜像，OS 层用动态加载技术增强（网络优化/国内适配/机型扩展），不修改 HA 本体
• 特点：多机型扩展(月增1-2款)、网络优化(10-20分进系统)、haos指令增强、全系列OTA升级
• 端口：HA=8123、冬瓜伴侣(管理面板)=8124、ttyd(Web命令行)=7681

教程分类

优先级：⭐必看 → 📕应急 → 📗常用 → 📘普通

系统

• ⭐首次使用HomeAssistant — 同一局域网、冬瓜伴侣查看状态、初始化(用户名/密码/定位)
• ⭐公制计量单位变更 — 修改单位制为公制
• ⭐系统备份、还原 — 自动+手动备份、加密密钥(丢失无法恢复!)、网络存储备份、老系统恢复、系统内恢复
• ⭐HACS — 社区商店安装使用
• ⭐MQTT集成
• ⭐HA设置静态IP
• ⭐智能设备网络设置 — 设备必须在同一网段
• 📗HA自动化基础教程、HA App使用教程
• 📕密码重置、冬瓜伴侣教程、清理浏览器缓存
• 📘实用系统集成、蓝牙、SSL证书、地点定位、网络存储、长期访问令牌

集成

• 📗xiaomi Home / Xiaomi Miot (小米双方案)
• 📗HomeKit Bridge / 📕Apple家居中枢
• 📗美的/海尔/涂鸦/智能音箱/摄像头/石头扫地机
• 📘萤石云/易微联/公牛/博联/索尼电视/ZHA

应用

• ⭐Filebrowser — 文件管理
• 📗Zigbee2MQTT / 节点小宝 / Frigate-rknpu / DDNSTO / Samba Easy NAS
• 📘Mosquitto broker / Zigbee分身 / Advanced SSH / 主机SSH / 小雅AList / FRP / WGHAOS SSH配置器 / SSL证书 / 小智服务器 / XiaoMusic / AstrBot

进阶

• 📗自定义仪表盘 / 查询实体标识符 / OpenClaw
• 📘概览显示时间 / Studio Code Server

硬件

• 📘智能红外遥控器 / zigbee协调器烧录 / 碧拓电表 / Voice接入

OpenClaw (冬瓜HAOS addon版)

安装：设置 > 应用 > 应用商店 > 搜索安装 openclaw → 启动 → http://[ip]:8099

模型配置：云API商 → API地址+密钥 → 刷新模型列表 → ⭐加白名单 → 保存
推荐模型顺序(性价比)：qwen3.5-plus → deepseek-v3.2 → gpt-5.4 → claude-sonnet-4-6

使用核心：Skill！从腾讯SkillHub (https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md) 复制粘贴安装
警告：必须先备份再操作！免费token质量差、注意API费用

冬瓜伴侣 (http://homeassistant.local:8124)

查看 HA 运行状态、启动阶段、下载进度、IP地址、系统时间。
HA 无法访问时第一时间访问此页面排查。
轮询显示：日期/时间/CPU占用率/CPU温度/IP地址/网关地址(90秒周期)