feat: Add Gemini API configuration and comprehensive documentation
- 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
This commit is contained in:
Alexis Galvan
parent
a7534dc223
commit
75258118df
61
varios/acceso_ui_web.md
Normal file
61
varios/acceso_ui_web.md
Normal file
@ -0,0 +1,61 @@
|
||||
# ✅ Interfaz Web Habilitada (Modo Desarrollo)
|
||||
|
||||
## URLs de Acceso
|
||||
|
||||
### Interfaz Web (Control UI)
|
||||
|
||||
🌐 **http://localhost:5173/**
|
||||
|
||||
### Gateway (Backend)
|
||||
|
||||
🔌 **ws://127.0.0.1:18789**
|
||||
|
||||
## Estado Actual
|
||||
|
||||
✅ **Vite Dev Server**: Corriendo en puerto 5173
|
||||
✅ **Gateway**: Corriendo en puerto 18789
|
||||
✅ **Modelo IA**: Google Gemini 2.5 Flash
|
||||
|
||||
## Cómo Usar la Interfaz Web
|
||||
|
||||
1. **Abrir el navegador** en: http://localhost:5173/
|
||||
|
||||
2. **Configurar la conexión** (si es necesario):
|
||||
- Gateway URL: `ws://127.0.0.1:18789`
|
||||
- Token: `local-dev-token` (si lo solicita)
|
||||
|
||||
3. **Empezar a chatear** con el agente directamente desde el navegador
|
||||
|
||||
## Servicios Corriendo
|
||||
|
||||
```
|
||||
Terminal 1: Gateway
|
||||
Comando: node scripts/run-node.mjs gateway
|
||||
Puerto: 18789
|
||||
Estado: ✅ Activo
|
||||
|
||||
Terminal 2: UI Dev Server
|
||||
Comando: pnpm --filter moltbot-control-ui run dev
|
||||
Puerto: 5173
|
||||
Estado: ✅ Activo
|
||||
```
|
||||
|
||||
## Notas Importantes
|
||||
|
||||
- **Modo Desarrollo**: La UI está en modo desarrollo (no compilada)
|
||||
- **Hot Reload**: Los cambios en la UI se actualizan automáticamente
|
||||
- **Recursos**: Consume más recursos que la versión compilada, pero funciona sin WSL2
|
||||
- **Seguridad**: Ambos servicios solo escuchan en localhost (127.0.0.1)
|
||||
|
||||
## Detener los Servicios
|
||||
|
||||
Para detener cualquiera de los servicios, presiona `Ctrl+C` en la terminal correspondiente.
|
||||
|
||||
## Ventajas de Este Método
|
||||
|
||||
✅ No requiere WSL2
|
||||
✅ No requiere compilación (bash)
|
||||
✅ Funciona en Windows nativo
|
||||
✅ Interfaz gráfica completa
|
||||
✅ Configuración visual
|
||||
✅ Chat interactivo
|
||||
58
varios/configuracion_gemini.md
Normal file
58
varios/configuracion_gemini.md
Normal file
@ -0,0 +1,58 @@
|
||||
# Configuración de Gemini para Moltbot
|
||||
|
||||
## Paso 1: Obtener API Key de Google Gemini
|
||||
|
||||
1. Ve a [Google AI Studio](https://aistudio.google.com/)
|
||||
2. Inicia sesión con tu cuenta de Google
|
||||
3. Haz clic en "Get API Key" o "Crear clave de API"
|
||||
4. Copia la clave generada
|
||||
|
||||
## Paso 2: Configurar la API Key en Moltbot
|
||||
|
||||
Tienes dos opciones:
|
||||
|
||||
### Opción A: Variable de Entorno (Recomendado)
|
||||
|
||||
Crea un archivo `.env` en la raíz del proyecto:
|
||||
|
||||
```bash
|
||||
# En la carpeta moltbot/
|
||||
GEMINI_API_KEY=tu_clave_api_aqui
|
||||
```
|
||||
|
||||
### Opción B: Configuración JSON
|
||||
|
||||
Edita o crea `~/.clawdbot/moltbot.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"agent": {
|
||||
"model": "google/gemini-2.5-flash"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Paso 3: Iniciar el Gateway
|
||||
|
||||
```bash
|
||||
# Desde la carpeta del proyecto
|
||||
pnpm moltbot gateway
|
||||
```
|
||||
|
||||
## Paso 4: Acceder a la Interfaz Web
|
||||
|
||||
Abre tu navegador en: http://localhost:18789
|
||||
|
||||
## Modelos Gemini Disponibles (Gratis)
|
||||
|
||||
- `google/gemini-2.5-pro` - Más potente
|
||||
- `google/gemini-2.5-flash` - Más rápido (recomendado)
|
||||
- `google/gemini-flash-lite` - Más ligero
|
||||
|
||||
## Verificar Configuración
|
||||
|
||||
```bash
|
||||
pnpm moltbot doctor
|
||||
```
|
||||
|
||||
Este comando verificará que todo esté correctamente configurado.
|
||||
69
varios/guia_cli.md
Normal file
69
varios/guia_cli.md
Normal file
@ -0,0 +1,69 @@
|
||||
# Guía de Uso del CLI de Moltbot
|
||||
|
||||
## Gateway Activo
|
||||
|
||||
✅ El gateway está corriendo en `ws://127.0.0.1:18789`
|
||||
✅ Modelo configurado: `google/gemini-2.5-flash`
|
||||
|
||||
## Comandos CLI Disponibles
|
||||
|
||||
### 1. Chatear con el Agente
|
||||
|
||||
```bash
|
||||
# Crear una sesión de chat
|
||||
pnpm moltbot agent --session-id mi-sesion --message "Tu mensaje aquí"
|
||||
|
||||
# Ejemplo
|
||||
pnpm moltbot agent --session-id cli-test --message "Hola, ¿cómo estás?"
|
||||
```
|
||||
|
||||
### 2. Ver Estado del Sistema
|
||||
|
||||
```bash
|
||||
# Ver estado general
|
||||
pnpm moltbot status
|
||||
|
||||
# Ver salud del gateway
|
||||
pnpm moltbot health
|
||||
|
||||
# Listar agentes configurados
|
||||
pnpm moltbot agents list
|
||||
```
|
||||
|
||||
### 3. Gestionar Canales (Opcional)
|
||||
|
||||
```bash
|
||||
# Conectar WhatsApp
|
||||
pnpm moltbot channels login
|
||||
|
||||
# Ver estado de canales
|
||||
pnpm moltbot channels status
|
||||
```
|
||||
|
||||
## Notas Importantes
|
||||
|
||||
- **Sesión ID**: Usa `--session-id` para mantener el contexto de conversación
|
||||
- **Seguridad**: El gateway solo escucha en localhost (127.0.0.1), completamente seguro
|
||||
- **Sin UI Web**: No necesitas la interfaz web para usar el agente
|
||||
- **Recursos**: El CLI consume muy pocos recursos comparado con WSL2
|
||||
|
||||
## Ejemplo de Uso Completo
|
||||
|
||||
```bash
|
||||
# Primera interacción
|
||||
pnpm moltbot agent --session-id alexis --message "Hola, preséntate"
|
||||
|
||||
# Continuar la conversación (misma sesión)
|
||||
pnpm moltbot agent --session-id alexis --message "¿Qué puedes hacer?"
|
||||
|
||||
# Nueva sesión
|
||||
pnpm moltbot agent --session-id trabajo --message "Ayúdame con código Python"
|
||||
```
|
||||
|
||||
## Solución de Problemas
|
||||
|
||||
Si el comando falla:
|
||||
|
||||
1. Verifica que el gateway esté corriendo: `pnpm moltbot status`
|
||||
2. Revisa la configuración: `cat ~/.clawdbot/moltbot.json`
|
||||
3. Verifica la API key: `cat .env`
|
||||
74
varios/guia_de_uso.md
Normal file
74
varios/guia_de_uso.md
Normal file
@ -0,0 +1,74 @@
|
||||
# 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._
|
||||
74
varios/inicio_rapido.md
Normal file
74
varios/inicio_rapido.md
Normal file
@ -0,0 +1,74 @@
|
||||
# ✅ Moltbot Configurado con Gemini
|
||||
|
||||
## Estado Actual
|
||||
|
||||
🟢 **Gateway corriendo exitosamente**
|
||||
|
||||
- **URL Web**: http://localhost:18789
|
||||
- **WebSocket**: ws://127.0.0.1:18789
|
||||
- **Modelo IA**: Google Gemini 2.5 Flash
|
||||
- **PID**: 15732
|
||||
|
||||
## Archivos de Configuración
|
||||
|
||||
### `.env` (raíz del proyecto)
|
||||
|
||||
```
|
||||
GEMINI_API_KEY=AIzaSyCOJSJ-b78CFSOcXy0lCdtKi4m2P_jHpS0
|
||||
```
|
||||
|
||||
### `~/.clawdbot/moltbot.json`
|
||||
|
||||
```json
|
||||
{
|
||||
"gateway": {
|
||||
"mode": "local",
|
||||
"auth": {
|
||||
"token": "local-dev-token"
|
||||
}
|
||||
},
|
||||
"agents": {
|
||||
"defaults": {
|
||||
"model": {
|
||||
"primary": "google/gemini-2.5-flash"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Cómo Usar
|
||||
|
||||
### 1. Acceder a la Interfaz Web
|
||||
|
||||
Abre tu navegador en: **http://localhost:18789**
|
||||
|
||||
### 2. Iniciar el Gateway (si no está corriendo)
|
||||
|
||||
```bash
|
||||
cd c:\Users\PC Blado\Desktop\AIDO\moltbot
|
||||
node scripts/run-node.mjs gateway
|
||||
```
|
||||
|
||||
### 3. Detener el Gateway
|
||||
|
||||
Presiona `Ctrl+C` en la terminal donde está corriendo.
|
||||
|
||||
## Próximos Pasos
|
||||
|
||||
1. **Conectar WhatsApp** (opcional):
|
||||
|
||||
```bash
|
||||
pnpm moltbot channels login
|
||||
```
|
||||
|
||||
2. **Explorar la interfaz web** en http://localhost:18789
|
||||
|
||||
3. **Chatear con el agente** directamente desde la interfaz
|
||||
|
||||
## Notas Importantes
|
||||
|
||||
- El gateway debe estar corriendo para usar la interfaz web
|
||||
- La API key de Gemini está en el archivo `.env` (no compartir)
|
||||
- El modelo configurado es `google/gemini-2.5-flash` (gratuito)
|
||||
- El token de autenticación local es `local-dev-token`
|
||||
87
varios/opciones_api_gratuitas.md
Normal file
87
varios/opciones_api_gratuitas.md
Normal file
@ -0,0 +1,87 @@
|
||||
# Opciones de APIs de IA Gratuitas (2026)
|
||||
|
||||
## ✅ Opciones Recomendadas (Verdaderamente Gratuitas)
|
||||
|
||||
### 1. Google Gemini (Google AI Studio)
|
||||
|
||||
**Estado**: ✅ Tier gratuito sin tarjeta de crédito
|
||||
|
||||
**Modelos disponibles**:
|
||||
|
||||
- Gemini 2.5 Pro
|
||||
- Gemini 2.5 Flash
|
||||
- Gemini Flash-Lite
|
||||
|
||||
**Límites del tier gratuito**:
|
||||
|
||||
- 5-15 solicitudes por minuto (RPM)
|
||||
- 100-1,000 solicitudes por día (RPD)
|
||||
- 250,000 tokens por minuto (TPM)
|
||||
- Context window: 1 millón de tokens
|
||||
|
||||
**Ventajas**:
|
||||
|
||||
- No requiere tarjeta de crédito
|
||||
- Excelente para desarrollo y pruebas
|
||||
- Modelos potentes y confiables
|
||||
- Integración con Google AI Studio
|
||||
|
||||
**Cómo obtener API key**:
|
||||
|
||||
1. Ir a [Google AI Studio](https://aistudio.google.com/)
|
||||
2. Crear cuenta con Google
|
||||
3. Generar API key gratuita
|
||||
|
||||
---
|
||||
|
||||
### 2. Groq (GroqCloud)
|
||||
|
||||
**Estado**: ✅ Tier gratuito sin tarjeta de crédito
|
||||
|
||||
**Modelos disponibles**:
|
||||
|
||||
- Llama 3.1 8B: 14,400 req/día, 6,000 tokens/min
|
||||
- Llama 3.3 70B: 1,000 req/día, 12,000 tokens/min
|
||||
|
||||
**Límites del tier gratuito**:
|
||||
|
||||
- Miles de solicitudes diarias
|
||||
- Créditos promocionales: $25 iniciales + $150/mes (programa de datos)
|
||||
|
||||
**Ventajas**:
|
||||
|
||||
- Extremadamente rápido
|
||||
- No requiere tarjeta de crédito
|
||||
- Modelos open-source (Llama)
|
||||
- Generoso tier gratuito
|
||||
|
||||
**Cómo obtener API key**:
|
||||
|
||||
1. Ir a [GroqCloud](https://console.groq.com/)
|
||||
2. Crear cuenta
|
||||
3. Generar API key gratuita
|
||||
|
||||
---
|
||||
|
||||
## ❌ NO Recomendado (No es realmente gratuito)
|
||||
|
||||
### Grok (xAI)
|
||||
|
||||
**Estado**: ❌ NO tiene tier gratuito tradicional
|
||||
|
||||
**Limitaciones**:
|
||||
|
||||
- Requiere suscripción a X (Twitter) Premium
|
||||
- O créditos promocionales ($25 + $150/mes con programa)
|
||||
- No es una opción verdaderamente gratuita
|
||||
|
||||
---
|
||||
|
||||
## Recomendación Final
|
||||
|
||||
Para recursos limitados y uso gratuito, las mejores opciones son:
|
||||
|
||||
1. **Gemini** - Si buscas calidad y confiabilidad
|
||||
2. **Groq** - Si buscas velocidad y modelos open-source
|
||||
|
||||
Ambas son completamente gratuitas y no requieren tarjeta de crédito.
|
||||
28
varios/resumen_tecnico.md
Normal file
28
varios/resumen_tecnico.md
Normal file
@ -0,0 +1,28 @@
|
||||
# Resumen Técnico: Moltbot
|
||||
|
||||
**Moltbot** es una plataforma de gateway para asistentes de IA personales y multi-canal. Permite centralizar la interacción con modelos de IA (como Claude o GPT) a través de canales de mensajería comunes.
|
||||
|
||||
## Arquitectura
|
||||
|
||||
- **Gateway**: El plano de control central que gestiona sesiones, canales y ejecución de herramientas.
|
||||
- **Agent Runtime**: Basado en el framework Pi, orquestra la lógica del agente y la integración con LLMs.
|
||||
- **Canales**: Adaptadores para WhatsApp, Telegram, Slack, Discord, Signal, iMessage, etc.
|
||||
- **Skills**: Sistema de herramientas modulares (búsqueda web, resúmenes, control de navegador, capturas de pantalla).
|
||||
|
||||
## Tecnologías Clave
|
||||
|
||||
- **Lenguaje**: TypeScript (ESM) sobre Node.js 22+.
|
||||
- **Gestión de Paquetes**: PNPM.
|
||||
- **Mensajería**:
|
||||
- WhatsApp: `baileys`
|
||||
- Telegram: `grammY`
|
||||
- Slack/Discord: SDKs oficiales.
|
||||
- **Infraestructura**: Docker para sandboxing de sesiones no principales.
|
||||
- **Apps Companion**: Soporte nativo para macOS, iOS y Android (nodos remotos).
|
||||
|
||||
## Flujo de Trabajo
|
||||
|
||||
1. Entrada de mensaje por canal.
|
||||
2. Enrutamiento al agente/sesión correspondiente.
|
||||
3. El agente razona y ejecuta herramientas (skills) si es necesario.
|
||||
4. Respuesta final entregada al canal de origen.
|
||||
63
varios/solucion_ui_windows.md
Normal file
63
varios/solucion_ui_windows.md
Normal file
@ -0,0 +1,63 @@
|
||||
# Problema: Control UI Assets No Disponibles
|
||||
|
||||
## Situación Actual
|
||||
|
||||
✅ **Gateway corriendo exitosamente**
|
||||
|
||||
- WebSocket: `ws://127.0.0.1:18789`
|
||||
- Modelo: `google/gemini-2.5-flash`
|
||||
- Estado: Funcionando correctamente
|
||||
|
||||
❌ **Interfaz Web no disponible**
|
||||
|
||||
- Error: "Control UI assets not found"
|
||||
- Causa: `pnpm ui:build` requiere bash/WSL
|
||||
|
||||
## Soluciones
|
||||
|
||||
### Opción 1: Usar WSL2 (Recomendado por el proyecto)
|
||||
|
||||
Según la documentación oficial, Moltbot en Windows **requiere WSL2**:
|
||||
|
||||
> "Windows: use **WSL2** (Ubuntu recommended). WSL2 is strongly recommended; native Windows is untested, more problematic, and has poorer tool compatibility."
|
||||
|
||||
**Pasos:**
|
||||
|
||||
1. Instalar WSL2 (Ubuntu)
|
||||
2. Clonar el proyecto dentro de WSL2
|
||||
3. Ejecutar `pnpm install && pnpm ui:build && pnpm build`
|
||||
4. Iniciar el gateway desde WSL2
|
||||
|
||||
### Opción 2: Usar CLI en lugar de Web UI
|
||||
|
||||
Puedes interactuar con el agente directamente desde la terminal:
|
||||
|
||||
```bash
|
||||
# Chatear con el agente
|
||||
node scripts/run-node.mjs agent "Hola, ¿cómo estás?"
|
||||
|
||||
# O usando pnpm
|
||||
pnpm moltbot agent "Tu mensaje aquí"
|
||||
```
|
||||
|
||||
### Opción 3: Conectar un Canal (WhatsApp/Telegram)
|
||||
|
||||
El gateway está funcionando, puedes conectar WhatsApp o Telegram:
|
||||
|
||||
```bash
|
||||
# WhatsApp (requiere escanear QR)
|
||||
pnpm moltbot channels login
|
||||
|
||||
# Telegram (requiere bot token)
|
||||
# Configurar en ~/.clawdbot/moltbot.json
|
||||
```
|
||||
|
||||
## Recomendación
|
||||
|
||||
Para una experiencia completa con interfaz web, **usa WSL2**. Es la configuración oficialmente soportada y probada.
|
||||
|
||||
Si solo necesitas probar el agente rápidamente, usa la **Opción 2 (CLI)**.
|
||||
|
||||
## Estado del Gateway
|
||||
|
||||
El gateway está completamente funcional y configurado con Gemini. Solo falta la interfaz web, que requiere WSL2 para compilarse en Windows.
|
||||
Loading…
Reference in New Issue
Block a user