openclaw / openclaw/openclaw-windows-node
Keep Windows Companion aligned with current OpenClaw stable and beta releases
Nobody has claimed this yet.
- Dominant language
- C#
- Stars
- 2.1k
- Forks
- 295
- Avg merge
- 1d 6h
- Merged PRs (30d)
- 99
Description
Problem
The Windows Companion and OpenClaw core are separate products, but the Companion owns the supported Windows installation path for the core.
The current Companion Setup Engine still defaults to OpenClaw 2026.6.11, while the current official releases are:
- stable:
2026.7.1 - beta:
2026.7.2-beta.1
This leaves Windows users on an older core when they install through the Companion-owned flow. Avoiding a current stable release because it has a core regression is not a sustainable synchronization strategy: compatibility work and core defects should be tracked and fixed in the repository that owns each behavior.
Goal
Keep the Windows Companion's supported install and upgrade path aligned with current OpenClaw releases:
- update the Companion's default stable OpenClaw version;
- validate the Companion against the current stable core;
- identify compatibility changes needed for the active beta before it becomes stable;
- keep Companion/Windows Node fixes in this repository;
- report and fix OpenClaw core regressions in
openclaw/openclaw, rather than carrying Companion workarounds.
Proposed Sequence
- Land the bounded stable-alignment change in #999:
- invariant compact-number formatting for
pt-PTand other decimal-comma locales; - update the Setup Engine LKG from
2026.6.11to stable2026.7.1; - no unrelated session or
/newbehavior changes.
- invariant compact-number formatting for
- Prove the current-head Companion installer against stable
2026.7.1through the real Companion-owned setup path. - Classify every reproduced failure by product ownership:
- Companion/Windows Node defects stay here;
- OpenClaw core defects move to
openclaw/openclawwith independent reproduction.
- Validate the active
2026.7.2-beta.1line early enough to prepare compatible Companion changes before the next stable release. - Keep version pins, tests, setup documentation, and release evidence synchronized.
Acceptance Criteria
- The Companion no longer defaults to the stale
2026.6.11core. - The stable version selected by the Setup Engine is covered by exact tests.
- A real Windows Companion install/upgrade proof exists for the selected stable version.
- Beta compatibility findings are recorded before beta promotion, with fixes made in the owning product.
- No custom OpenClaw fork or silent core workaround is bundled into the Companion.
- Known regressions remain explicit and do not get misrepresented as Companion compatibility fixes.
First PR
- #999 updates invariant
pt-PTformatting and the Setup Engine LKG to OpenClaw2026.7.1. - The PR remains draft while its current-head installer/runtime proof is completed.
- Known OpenClaw
2026.7.1startup regression: https://github.com/openclaw/openclaw/issues/108435
Current Status
The first PR has now exercised the real GitHub Actions setup path:
- the main build/test job passed, including Shared, Tray, Connection, Setup Engine, UI, accessibility, and related suites;
- all three setup E2E shards installed OpenClaw
2026.7.1and then failed before their scenario logic because the Gateway repeatedly reported an active startup-migration lock for the fresh state directory; - this confirms the version alignment itself and exposes a current OpenClaw core/runtime compatibility blocker;
- #999 remains draft and should not work around that core failure inside the Companion.
Agent Transcript
Sanitized operator/agent decision record
- The operator identified that the Windows Companion had fallen behind the OpenClaw release it is expected to install.
- We confirmed from the official upstream sources that Windows Companion
mainis currentlybf0fa8a9bde433db9f6758cc89723bf9bfdd06c0, OpenClaw stable is2026.7.1, and beta is2026.7.2-beta.1. - We separated product ownership: the Companion should track current stable; known core regressions should be fixed in the OpenClaw repository rather than used to keep the Companion indefinitely pinned.
- We reduced the first PR to the bounded
pt-PTformatting and stable LKG update. An earlier unrelated/newexperiment was explicitly removed. - This issue records an extended operator/agent compatibility and recovery effort, with isolated branches, full test gates, scoped Auto-review, and explicit proof gaps rather than a quick unverified version bump.
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
Start with PR #999 and the Companion Setup Engine's LKG version pin, then run the real GitHub Actions setup path and its setup E2E shards against stable 2026.7.1. Review the reported startup-migration lock and separate Companion/Windows Node failures from the OpenClaw core regression. Done means stable alignment is tested, Windows install/upgrade evidence exists, beta findings are recorded, and no core workaround is added here.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- csharp, github-actions, node.js
- Domain
- desktop, devops, release, testing
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100