[Docs]: Native setup log path is %APPDATA%\OpenClawTray\Logs\Setup, while SETUP.md points to %LOCALAPPDATA%

Abierto Apto para principiantes
#2,287 2 comentarios 1 reacción 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
csharp

Línea de trabajo

Lee la sección “Local setup fails” junto con la nota “View setup log” en docs/SETUP.md y docs/ONBOARDING_WIZARD.md. Confirma la ruta del registro nativo con SetupWindow.xaml.cs y el directorio de datos itinerante que pasa WindowManager. Actualiza la documentación para distinguir los registros de configuración del botón fácil y los nativos, y explicar que la desinstalación elimina el directorio del registro nativo; el botón opcional es un cambio aparte y más amplio.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P2

Summary

The Windows troubleshooting docs point users to:

%LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt

for setup failures, but native Gateway setup writes a different file under the roaming profile:

%APPDATA%\OpenClawTray\Logs\Setup\native-setup-<utc>.jsonl

easy-setup-latest.txt is only produced by the easy-button setup path. A native setup failure therefore sends users to a directory that may not exist.

Evidence

  • docs/SETUP.md:
    • “For easy-button setup, repair, or remove failures, start with %LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt.”
    • “If the easy-button setup flow generated the code, check …”
  • docs/ONBOARDING_WIZARD.md: “View setup log reveals Logs\Setup\native-setup-<utc>.jsonl under the Companion” (root not stated).
  • Source SetupWindow.xaml.cs builds the native setup log as:
Path.Combine(_dataDir, "Logs", "Setup", $"native-setup-{DateTime.UtcNow:yyyyMMdd-HHmmss}.jsonl")
  • WindowManager passes dataDir: AppIdentity.ResolveRoamingDataDirectory(), i.e. %APPDATA%\OpenClawTray.
  • On the test machine, %LOCALAPPDATA%\OpenClawTray\Logs contained only diagnostics.jsonl; %APPDATA%\OpenClawTray\Logs existed before uninstall and was removed by the uninstaller.

Proposed docs change

In the “Local setup fails” section, split the paths explicitly:

  • Easy-button setup: %LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt / .jsonl
  • Native Gateway setup: %APPDATA%\OpenClawTray\Logs\Setup\native-setup-<utc>.jsonl
  • Mention that the native log directory is under the roaming profile and is removed on uninstall.

Also consider adding a “Open setup log” button that resolves the correct path for the current setup route.

Environment

  • Windows 11 Home 10.0.26200 x64
  • Companion 2026.11.3, native Gateway MSIX 2026.11.100.0
  • Observed during the native local Gateway setup on 2026-11-17

Tag: fw5

Lenguaje dominante
C#
Estrellas
2.2k
Forks
346
Merge medio
1 d 15 h
PR fusionados (30 d)
272

Preparar el entorno

  • Sin Dockerfile ni archivo de Docker Compose
  • Tiene una plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de openclaw/openclaw-windows-node

Todos los issues de openclaw/openclaw-windows-node

Issues similares

Más issues de C#

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.