openclaw / openclaw/openclaw-windows-node
Browser proxy should be ready-to-use or visibly blocked with a guided repair path
Nobody has claimed this yet.
- Dominant language
- C#
- Stars
- 2.1k
- Forks
- 295
- Avg merge
- 1d 6h
- Merged PRs (30d)
- 99
Description
Problem
Browser control requires a separately running browser-control host on Gateway port + 2. Current diagnostics explain some failure modes, but a normal user can still request a browser action, see no visible result, and watch the agent unsuccessfully troubleshoot or restart the Gateway.
Desired outcome
Browser control is either ready to use or clearly unavailable with a concrete in-app repair path.
Definition of done
- Run a preflight when Browser Control is enabled and before the first browser request.
- Distinguish absent, unreachable, unauthenticated, and incorrectly SSH-forwarded hosts.
- Offer a concrete repair action: start/install/configure the host, or explicitly disable the capability with a clear explanation.
- Supply concise capability-state guidance to chat/agent context so it does not repeatedly restart the Gateway to diagnose the same prerequisite.
- Add local MCP and gateway-mediated proof for success and each blocked state.
Related
- Browser-host installer/launcher is still explicitly unfinished in
docs/WINDOWS_NODE_ARCHITECTURE.md. - #850 is the broader camera/browser containment tracking epic.
- PCMag report (Aug. 6, 2026): https://www.pcmag.com/opinions/microsoft-thinks-openclaw-is-the-future-of-windows-my-testing-says-otherwise
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Read docs/WINDOWS_NODE_ARCHITECTURE.md first, especially the unfinished browser-host installer/launcher notes. Trace the existing Browser Control diagnostics and first-request path, then verify local MCP and gateway-mediated success plus absent, unreachable, unauthenticated, and incorrectly SSH-forwarded states. Done means a concrete repair or explicit disablement is shown and capability guidance prevents repeated Gateway restarts.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- csharp
- Domain
- api, desktop
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100