Moltbot Gateway Manager (Dashboard Moltbot)

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/).

📚 Tabla de contenidos

Visión general
Características principales
Arquitectura rápida
Estructura del repositorio
Requisitos y descargas
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
Repositorios relacionados
Licencia

🧭 Visión general

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

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

✅ Características principales

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).
Instalación guiada de Moltbot desde la app (incluye bootstrap en WSL o local).
Apertura del dashboard del gateway en ventana integrada o navegador.
Autenticación automática del dashboard (detecta/genera token en WSL).
Terminal integrada (WSL en Windows).

🧩 Arquitectura rápida

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

🗂️ Estructura del repositorio

Ruta	Descripción
`main.js`	Proceso principal de Electron: arranque, IPC, sistema, logs y tareas del gateway.
`renderer.js`	Lógica del panel UI (estado, acciones, consola, sincronización).
`preload.js`	API segura entre UI y proceso principal.
`index.html`	Plantilla principal del panel.
`styles.css`	Estilos de la interfaz.
`config.json`	Configuración por defecto del dashboard.
`scripts/`	Scripts de build/postinstall.

📦 Requisitos y descargas

Usuario final (Windows recomendado)

Windows 10/11.
WSL instalado (requerido si Moltbot corre en Linux/WSL).

Desarrollador

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

✅ Programas y enlaces de descarga

Programa / App	Para qué se usa	Descarga oficial
Node.js (LTS)	Runtime para Electron y herramientas de build	https://nodejs.org/en/download
pnpm	Gestor de paquetes recomendado	https://pnpm.io/installation
Git	Control de versiones	https://git-scm.com/downloads
WSL (Windows)	Ejecutar Moltbot en Linux sobre Windows	https://learn.microsoft.com/windows/wsl/install
Moltbot CLI	Motor / gateway del bot	https://github.com/moltbot/moltbot
Dashboard Clawdbot	Interfaz de control (este repo)	https://github.com/Ojete-Blog/dashboard-clawdbot

🧑‍💻 Instalación para usuarios finales

✅ Opción 1 — Instalador (Setup .exe)

Ve a Releases.
Descarga el instalador correcto para tu arquitectura:
- 64 bits (x64): Moltbot Dashboard Setup X.Y.Z-x64.exe
- 32 bits (ia32): Moltbot Dashboard Setup X.Y.Z-ia32.exe
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.

✅ Opción 2 — Portable/ZIP (si existe)

Descarga el ZIP portable.
Descomprime.
Ejecuta la app.

🛠️ Instalación para desarrolladores

1) Clonar el repositorio

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

2) Instalar dependencias

pnpm install

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

3) Ejecutar en modo desarrollo

pnpm start

4) Depurar (modo dev)

pnpm run dev

⚡ Comandos útiles

Ejecuta estos comandos desde la raíz del repositorio.

Tarea	Comando
Instalar dependencias	`pnpm install`
Modo desarrollo	`pnpm start`
Modo dev (Electron)	`pnpm run dev`
Build (instalador)	`pnpm build`
Ver scripts disponibles	`pnpm run`

🔄 Actualización del repositorio

✅ Si clonaste con Git (recomendado)

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

⚠️ Si descargaste como ZIP (sin `.git`)

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

🏗️ Generar build / instalador

pnpm build

Salidas generadas

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

⚙️ Configuración

1) Configuración del Gateway (Moltbot)

Ruta típica en Linux/WSL:

~/.moltbot/moltbot.json (legacy: ~/.clawdbot/clawdbot.json)

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

2) Configuración de la app

Archivo principal:

config.json

Valores destacados (ejemplo):

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

En Windows, asegúrate de configurar useWslConfig, wslDistro y wslUser para apuntar a tu distro/usuario WSL.

3) Variables de entorno soportadas

MOLTBOT_GATEWAY_PORT=18789
MOLTBOT_GATEWAY_HOST=127.0.0.1
MOLTBOT_GATEWAY_TOKEN=tu_token_local
MOLTBOT_CONFIG_PATH=/ruta/a/moltbot.json
MOLTBOT_MANAGER_CONFIG=/ruta/a/config.json
MOLTBOT_APP_ICON=C:\ruta\a\icono.ico
CLAWDBOT_MANAGER_CONFIG=/ruta/a/config.json
CLAWDBOT_APP_ICON=C:\ruta\a\icono.ico

🧯 Solución de problemas

✅ Auto-setup desde la app (WSL)

Si Moltbot no arranca, usa el botón “Auto configurar (WSL)” para abrir la consola integrada y ejecutar los comandos de creación de usuario, instalación del CLI y generación de la configuración. Esta opción imprime los comandos en la consola y puede pedir tu contraseña de sudo en WSL.

❌ No abre `http://127.0.0.1:18789/`

En WSL:

moltbot gateway status

Si no está corriendo:

moltbot gateway restart

❌ "Gateway start blocked: set gateway.mode=local..."

El gateway ahora exige un modo explícito. Soluciones rápidas:

En la app, usa “Sincronizar config” para actualizar la configuración.
Verifica que ~/.moltbot/moltbot.json incluya:

{
  "gateway": {
    "mode": "local"
  }
}

❌ “moltbot no se reconoce…”

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

which moltbot
moltbot status

Si no está instalado, usa el instalador oficial:

curl -fsSL https://molt.bot/install.sh | bash

❌ Rebuild roto después de actualizar Node o dependencias

En PowerShell (Windows):

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

🔐 Seguridad

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.

📄 Licencia

MIT

🔗 Repositorios relacionados

Dashboard Moltbot (este repositorio): https://github.com/Ojete-Blog/dashboard-clawdbot
Moltbot (core/gateway): https://github.com/moltbot/moltbot

Name		Name	Last commit message	Last commit date
Latest commit History 162 Commits
build		build
scripts		scripts
.gitignore		.gitignore
.npmrc		.npmrc
LICENSE		LICENSE
README.md		README.md
config.json		config.json
index.html		index.html
main.js		main.js
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
preload.js		preload.js
renderer.js		renderer.js
security.js		security.js
styles.css		styles.css

License

smouj/dashboard-moltbot

Folders and files

Latest commit

History

Repository files navigation