{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/sytchi/NarwalIntegration/blob/f527b72c946795d580418022b8337fbf9e20a4b0/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "Narwal Robot Vacuum is a Home Assistant integration built around the vacuums' local WebSocket interface. It includes helpers to capture phone-to-robot traffic, decode protobuf frames from packet captures and probe commands, alongside cleaning, station and map controls.",
  "description_zh": "Narwal Robot Vacuum 是基于吸尘机器人本地 WebSocket 接口的 Home Assistant 集成。项目附带手机与机器人通信抓包、protobuf 帧解码及命令探测工具，并实现清洁、基站和地图控制。",
  "entry_url": "https://awesomerea.org/resources/narwal-integration-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/narwal-integration-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/sytchi/NarwalIntegration/blob/f527b72c946795d580418022b8337fbf9e20a4b0/CONTRIBUTING.md",
  "group": "cases",
  "id": "narwal-integration-case",
  "json_url": "https://awesomerea.org/resources/narwal-integration-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/narwal-integration-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/narwal-integration-case/index.md",
  "name": "Narwal Robot Vacuum: local WebSocket control and protocol probing",
  "name_zh": "Narwal Robot Vacuum：本地 WebSocket 控制与协议探测",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Home Assistant and a Narwal model exposing the local WebSocket service on port 9002.",
    "Narwal Flow is the actively maintained model; other listed compatible models have not been retested for this fork.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Home Assistant，以及在 9002 端口提供本地 WebSocket 服务的 Narwal 机型。",
    "Narwal Flow 是持续维护的机型；列出的其他兼容机型尚未针对该分支重新测试。",
    "MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/sytchi/NarwalIntegration",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}