Summary
Local chat path links should self-heal more safely when CHAT_PATH_LINKS.json is missing, and the generated defaults/template should come from one shared source of truth.
In Plain English
This follow-up makes local chat path links more resilient on the machine actually running Nerve.
Right now, if the local CHAT_PATH_LINKS.json file is missing, users can end up in a broken or confusing state until that file is recreated manually. This lane fixes that by regenerating the local config automatically when it is missing, and by making sure both runtime regeneration and manual template creation use the same shared helper.
It also improves the default path prefixes so they make more sense across Linux, macOS, and Windows installs. The result is a local-only hardening pass: fewer broken setups, fewer mismatches between runtime and UI-generated config, and better out-of-the-box defaults.
Scope
- local-host hardening only in
openclaw-nerve
- self-heal missing
CHAT_PATH_LINKS.json on local read
- share one source-of-truth helper/template for generation, parsing, normalization, and serialization
- unify
ConfigTab manual template creation with that shared helper
- improve OS-aware defaults, including Linux/macOS/Windows-aware generation
Explicitly Out of Scope
- remote / gateway parity (to be handled in a separate upstream
openclaw lane)
- settings/editor UX redesign or broader config editing improvements
Provenance
Clean source branch: feature/local-chat-links-self-heal-and-defaults
Commit stack on that branch:
7bc75f2 — feat(chat): self-heal missing local chat path links configa69f7bc — fix(chat): keep chat path links helper in server tree7ed4496 — feat(chat): add windows-aware path link defaults
Downstream dogfood already validated the behavior on a local workhorse branch before packaging upstream, including the Windows-aware defaults follow-up while preserving Linux/Zorin behavior.
Related Prior Art
Summary
Local chat path links should self-heal more safely when
CHAT_PATH_LINKS.jsonis missing, and the generated defaults/template should come from one shared source of truth.In Plain English
This follow-up makes local chat path links more resilient on the machine actually running Nerve.
Right now, if the local
CHAT_PATH_LINKS.jsonfile is missing, users can end up in a broken or confusing state until that file is recreated manually. This lane fixes that by regenerating the local config automatically when it is missing, and by making sure both runtime regeneration and manual template creation use the same shared helper.It also improves the default path prefixes so they make more sense across Linux, macOS, and Windows installs. The result is a local-only hardening pass: fewer broken setups, fewer mismatches between runtime and UI-generated config, and better out-of-the-box defaults.
Scope
openclaw-nerveCHAT_PATH_LINKS.jsonon local readConfigTabmanual template creation with that shared helperExplicitly Out of Scope
openclawlane)Provenance
Clean source branch:
feature/local-chat-links-self-heal-and-defaultsCommit stack on that branch:
7bc75f2—feat(chat): self-heal missing local chat path links configa69f7bc—fix(chat): keep chat path links helper in server tree7ed4496—feat(chat): add windows-aware path link defaultsDownstream dogfood already validated the behavior on a local
workhorsebranch before packaging upstream, including the Windows-aware defaults follow-up while preserving Linux/Zorin behavior.Related Prior Art