openclaw / openclaw/openclaw-windows-node

Browser proxy should be ready-to-use or visibly blocked with a guided repair path

Open
#1,154 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

clawsweeper:linked-pr-open clawsweeper:needs-product-decision clawsweeper:no-new-fix-pr clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster P2 stale status: 🚢 actively landing
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

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.