75258118df
- Add varios/ directory with project documentation - Technical summary (resumen_tecnico.md) - Usage guide (guia_de_uso.md) - Free API options comparison (opciones_api_gratuitas.md) - Gemini configuration guide (configuracion_gemini.md) - Quick start guide (inicio_rapido.md) - CLI usage guide (guia_cli.md) - Windows UI solution guide (solucion_ui_windows.md) - Web UI access guide (acceso_ui_web.md) Gateway configured with Google Gemini 2.5 Flash (free tier) CLI and Web UI (dev mode) fully functional on Windows without WSL2
75 lines
2.0 KiB
Markdown
75 lines
2.0 KiB
Markdown
# Guía de Uso: Moltbot 🦞
|
|
|
|
Moltbot funciona como un "puente" (gateway) entre tus aplicaciones de mensajería (WhatsApp, Telegram, etc.) y un asistente de IA. Aquí tienes los pasos para ponerlo en marcha.
|
|
|
|
## 1. Preparación (Entorno)
|
|
|
|
Moltbot requiere **Node.js 22+**. En Windows, se recomienda usar **WSL2** para una mejor experiencia, aunque puede funcionar de forma nativa.
|
|
|
|
Desde la carpeta raíz del proyecto, instala las dependencias y compila:
|
|
|
|
```bash
|
|
pnpm install
|
|
pnpm ui:build
|
|
pnpm build
|
|
```
|
|
|
|
## 2. Configuración Inicial (Onboarding)
|
|
|
|
El comando `onboard` te guiará para configurar tus API keys (Claude, OpenAI), tu espacio de trabajo y las habilidades (skills) del bot.
|
|
|
|
```bash
|
|
pnpm moltbot onboard
|
|
```
|
|
|
|
## 3. Conectar Canales (Ejemplo: WhatsApp)
|
|
|
|
Para conectar tu WhatsApp, necesitas vincular la sesión mediante un código QR (similar a WhatsApp Web):
|
|
|
|
```bash
|
|
pnpm moltbot channels login
|
|
```
|
|
|
|
## 4. Iniciar el Gateway
|
|
|
|
El Gateway es el proceso principal que debe estar corriendo para que el bot responda.
|
|
|
|
```bash
|
|
# Para desarrollo (recarga automática al cambiar código)
|
|
pnpm gateway:watch
|
|
|
|
# Para uso normal
|
|
pnpm moltbot gateway
|
|
```
|
|
|
|
## 5. Formas de Interactuar
|
|
|
|
### A través de Mensajería
|
|
|
|
Una vez configurado y con el Gateway corriendo, simplemente escribe a tu propio número de WhatsApp (o al bot de Telegram configurado).
|
|
|
|
### A través de la CLI (Terminal)
|
|
|
|
Puedes hablar con el agente directamente desde la terminal:
|
|
|
|
```bash
|
|
pnpm moltbot agent "Hola, ¿quién eres?"
|
|
```
|
|
|
|
### A través de la Interfaz Web (Dashboard)
|
|
|
|
Si el Gateway está corriendo localmente, abre tu navegador en:
|
|
[http://localhost:18789](http://localhost:18789)
|
|
|
|
Ahí podrás ver los chats, estados de los canales y la configuración.
|
|
|
|
## Comandos Útiles
|
|
|
|
- `pnpm moltbot doctor`: Verifica que todo esté bien configurado.
|
|
- `pnpm moltbot channels status`: Muestra el estado de conexión de tus canales.
|
|
- `pnpm moltbot config list`: Muestra tu configuración actual.
|
|
|
|
---
|
|
|
|
_Nota: Si estás en Windows nativo y tienes problemas, intenta usar WSL2._
|