diff --git a/varios/acceso_ui_web.md b/varios/acceso_ui_web.md new file mode 100644 index 000000000..b7d1f69bd --- /dev/null +++ b/varios/acceso_ui_web.md @@ -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 diff --git a/varios/configuracion_gemini.md b/varios/configuracion_gemini.md new file mode 100644 index 000000000..2a7b95b13 --- /dev/null +++ b/varios/configuracion_gemini.md @@ -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. diff --git a/varios/guia_cli.md b/varios/guia_cli.md new file mode 100644 index 000000000..a25e5f76d --- /dev/null +++ b/varios/guia_cli.md @@ -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` diff --git a/varios/guia_de_uso.md b/varios/guia_de_uso.md new file mode 100644 index 000000000..7a28b6332 --- /dev/null +++ b/varios/guia_de_uso.md @@ -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._ diff --git a/varios/inicio_rapido.md b/varios/inicio_rapido.md new file mode 100644 index 000000000..3de310228 --- /dev/null +++ b/varios/inicio_rapido.md @@ -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` diff --git a/varios/opciones_api_gratuitas.md b/varios/opciones_api_gratuitas.md new file mode 100644 index 000000000..e47bd586d --- /dev/null +++ b/varios/opciones_api_gratuitas.md @@ -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. diff --git a/varios/resumen_tecnico.md b/varios/resumen_tecnico.md new file mode 100644 index 000000000..12feffd99 --- /dev/null +++ b/varios/resumen_tecnico.md @@ -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. diff --git a/varios/solucion_ui_windows.md b/varios/solucion_ui_windows.md new file mode 100644 index 000000000..831ce8420 --- /dev/null +++ b/varios/solucion_ui_windows.md @@ -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.