openclaw/varios/guia_de_uso.md
Alexis Galvan 75258118df 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
2026-01-28 19:42:14 -03:00

2.0 KiB

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:

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.

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):

pnpm moltbot channels login

4. Iniciar el Gateway

El Gateway es el proceso principal que debe estar corriendo para que el bot responda.

# 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:

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

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.