Case study

Narwal Robot Vacuum: local WebSocket control and protocol probing

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 2
Last commit: 2026-09-23
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code, documentation and a demo observed; no download method found.
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: Home Assistant and a Narwal model exposing the local WebSocket service on port 9002.
Limits: Narwal Flow is the actively maintained model; other listed compatible models have not been retested for this fork.
License: MIT license.

Cite

BibTeX

@misc{narwal-integration-case,
  title = {{Narwal Robot Vacuum: local WebSocket control and protocol probing}},
  howpublished = {\url{https://github.com/sytchi/NarwalIntegration}},
  url = {https://github.com/sytchi/NarwalIntegration},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/narwal-integration-case/}}
}

Plain text

Narwal Robot Vacuum: local WebSocket control and protocol probing. https://github.com/sytchi/NarwalIntegration (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/narwal-integration-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

CONTRIBUTING.md GitHub · sytchi/NarwalIntegration · Revision f527b72
README.md GitHub · sytchi/NarwalIntegration · Revision f527b72