Commit inicial - estructura base del proyecto

2026-05-31 08:24:12 -06:00
commit cd998ce6b0
143 changed files with 18354 additions and 0 deletions
@@ -0,0 +1,47 @@
+# Runbook: Incidentes OpenClaw Browser/CDP
+
+Historial resumido de incidentes previos con OpenClaw y su browser container.
+
+## Sintomas comunes
+
+- Browser container aparece `unhealthy`.
+- OpenClaw no conecta al browser via CDP.
+- Timeouts contra el puerto CDP.
+
+## Diagnostico
+
+```powershell
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}' | grep -E 'openclaw|browser'"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker exec <browser-container> ss -tlnp"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker logs <browser-container> --tail 100"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker logs <openclaw-container> --tail 100"
+```
+
+## Puerto CDP
+
+En un incidente previo, Chromium escuchaba en `127.0.0.1:9222` dentro del
+container y nginx exponia `0.0.0.0:9223` para otros containers. No asumas que
+`9222` o `9223` es correcto sin probar desde la red Docker actual.
+
+Prueba desde el container OpenClaw:
+
+```powershell
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker exec <openclaw-container> curl -sf http://<browser-host>:9223/json/version"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker exec <openclaw-container> curl -sf http://<browser-host>:9222/json/version"
+```
+
+## Acciones que requieren confirmacion
+
+```powershell
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker exec <browser-container> pkill -f chromium"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker restart <browser-container>"
+.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct exec 102 -- docker restart <openclaw-container>"
+```
+
+## Notas de configuracion
+
+- Montar `/dev/shm` o usar `shm_size` suficiente suele mejorar estabilidad de
+  Chromium en Docker.
+- Limpiar locks de perfil en startup puede resolver arranques atascados.
+- Cambios de capacidades como `SYS_ADMIN` o `seccomp:unconfined` son sensibles;
+  revisarlos antes de aplicarlos.