Aplicación de escritorio (Electron) que funciona como centro de mando para Moltbot Gateway: controla el estado del gateway, revisa logs, ajusta configuración y abre el panel web (http://127.0.0.1:18789/).

• Visión general
• Características principales
• Arquitectura rápida
• Requisitos
• Instalación para usuarios finales
• Instalación para desarrolladores
• Comandos útiles
• Actualización del repositorio
• Generar build / instalador
• Configuración
• Solución de problemas
• Seguridad
• Licencia

Clawdbot Gateway Manager es una app de escritorio multiplataforma (Windows, macOS, Linux) que no reemplaza a Clawdbot, sino que lo orquesta y supervisa. La app se encarga de:

1. Ejecutar comandos de Clawdbot (localmente o a través de WSL).
2. Leer/escribir la configuración del Gateway.
3. Mostrar estado, métricas y logs de forma centralizada.

• Control del gateway: iniciar, detener y reiniciar.
• Logs en vivo con filtros/exportación.
• Editor de configuración JSON con validación.
• Monitor de CPU/memoria (con fallback si ps no existe).
• Apertura del dashboard del gateway en ventana integrada o navegador.
• Terminal integrada (WSL en Windows).

• Clawdbot Gateway corre en tu sistema (o en WSL si estás en Windows).
• Dashboard Clawdbot (esta app) se conecta al gateway y lo administra.
• Interfaz web del gateway disponible en http://127.0.0.1:18789/.

• Windows 10/11.
• WSL instalado (opcional, recomendado si Clawdbot corre en Linux/WSL).

• Node.js v18+ (v22 recomendado).
• pnpm (o npm, aunque pnpm es recomendado).
• Git.
• Clawdbot CLI instalado (en WSL o local, según tu entorno).

1. Ve a Releases.
2. Descarga el instalador correcto para tu arquitectura:
   • 64 bits (x64): Clawdbot Dashboard Setup X.Y.Z-x64.exe
   • 32 bits (ia32): Clawdbot Dashboard Setup X.Y.Z-ia32.exe
3. Ejecuta el instalador.

Si descargas el instalador equivocado, Windows mostrará el mensaje
“No se puede ejecutar esta aplicación en el equipo”.

En releases recientes también verás archivos como latest.yml y .blockmap.
Como usuario final, normalmente solo necesitas el Setup .exe.

1. Descarga el ZIP portable.
2. Descomprime.
3. Ejecuta la app.

git clone https://github.com/Ojete-Blog/dashboard-clawdbot.git
cd dashboard-clawdbot

pnpm install

También puedes usar npm install, pero el repo está optimizado para pnpm.

pnpm start

pnpm run dev

Ejecuta estos comandos desde la raíz del repositorio.

git status
git pull
pnpm install

Si tienes cambios locales que bloquean el pull:

git stash -u
git pull
pnpm install

Para recuperar cambios:

git stash pop

• No puedes hacer git pull.
• Recomendación: clonar nuevamente el repo con Git.

pnpm build

• Windows: dist/setup/ (instalador .exe)
• Linux: .deb y AppImage
• macOS: .dmg

Ruta típica en Linux/WSL:

~/.clawdbot/clawdbot.json

En Windows puedes acceder a WSL con:
\\wsl$\<TuDistro>\home\<TuUsuario>\...

Archivo principal:

config.json

Valores destacados (ejemplo):

{
  "gatewayPort": 18789,
  "gatewayHost": "127.0.0.1",
  "useWslConfig": true,
  "wslDistro": "Ubuntu-24.04",
  "selectedProfile": "default"
}

CLAWDBOT_GATEWAY_PORT=18789
CLAWDBOT_GATEWAY_HOST=127.0.0.1
CLAWDBOT_CONFIG_PATH=/ruta/a/clawdbot.json
CLAWDBOT_APP_ICON=C:\ruta\a\icono.ico

En WSL:

clawdbot gateway status

Si no está corriendo:

clawdbot gateway restart

• Si Clawdbot está en WSL, asegúrate de que la app esté configurada en modo WSL/bridge.
• Verifica en WSL:

which clawdbot
clawdbot status

En PowerShell (Windows):

rd /s /q node_modules
del pnpm-lock.yaml
pnpm store prune
pnpm install
pnpm build

• Mantén el gateway en localhost siempre que sea posible.
• Si necesitas acceso remoto, usa un túnel privado (por ejemplo Tailscale) en lugar de abrir puertos públicos.

MIT

https://github.com/Ojete-Blog/dashboard-clawdbot