Configura el Gateway y comunícate con tu agente via Telegram

Clase 5 de 13 • Curso de OpenClaw

Contenido del curso

Instalación y conceptos básicos

Aplicación en Flujos de Trabajo

Automatización, Sesiones y Seguridad

Tomar examen

Comentarios

Leonel Gasparrini

student•

Hola Eli, estoy haciendo pruebas pero los tokens se me consumen muy rapido, cual modelo podemos usar que ofrezca mejor tokens/precio?

Hola Leonel, entiendo perfectamente tu frustración; optimizar el consumo de tokens es clave cuando estamos haciendo pruebas constantes.

Para mejorar la relación costo-beneficio, te recomiendo explorar modelos más ligeros como GPT-4o-mini o Claude 3 Haiku. Estos modelos están diseñados específicamente para ser rápidos y económicos, manteniendo una capacidad de razonamiento excelente para tareas de agentes.

Si buscas profundizar en cómo gestionar mejor estas interacciones y el uso de memoria, te sugiero revisar:

Estos recursos te ayudarán a entender cómo el agente procesa la información, permitiéndote ajustar tus prompts para que sean más directos y consuman menos tokens en cada llamada. ¡Mucho éxito con tus pruebas!

Elí Cuéllar

Team Platzi•

Hola, Leonel, qué proveedor estás usando? Anthropic, gemini, openai? Si me cuentas te puedo sugerir algún modelo que tenga buen balance.

Elí Cuéllar

Team Platzi•

Igual revisa en la clase dos el comentario de Joan Pedro Zambrano Castañeda, ahí explica cómo usar modelos de Ollama. No los he probado en Openclaw pero es una opción más económica y te puede dar buen resultado.

https://platzi.com/cursos/curso-openclaw/instalacion-de-openclaw-en-mac-y-windows/

Jose Eduardo Tirado Verbel

student•

podemos tener varios agentes con diferentes focos o personalidades?

¡Hola, Jose Eduardo! Es una excelente pregunta. Entiendo que quieras explorar la versatilidad de tus agentes.

En OpenClaw, la identidad y personalidad de tu agente se definen principalmente a través de su configuración inicial (como vimos en la creación de su "Soul" e "Identity"). Si bien puedes tener múltiples bots configurados en Telegram, cada uno requeriría su propia instancia o configuración específica dentro del sistema para mantener personalidades distintas.

Piensa en esto como si tuvieras diferentes "perfiles" de usuario en una computadora: cada uno tiene sus propios archivos y preferencias. Para lograr esto, podrías gestionar diferentes configuraciones de identidad para que cada agente actúe bajo un enfoque distinto.

Para profundizar en cómo estructurar estas identidades y capacidades, te recomiendo revisar:

Elí Cuéllar

Team Platzi•

Hola José! Si puedes tener varios agentes distintos con su propio workspace, identidad, soul e incluso usar modelos diferentes para cada uno.

Para agregar un agente usa el comando

openclaw agents add mi-agente

Esto activa el proceso de configuración de un nuevo agente.

Te recomiendo crear un bot de telegram para cada agente. Recuerda que son “personas” separadas, no comparten memoria, soul ni identity por defecto.

Alcides Castillo

student•

Como dice Eli Cuellar. si se puede tener multiples agentes en la misma pc con su propio workspace y personalidad.

Pero cada uno tiene que tener sus propio bot de telegram. no deben reusar el mismo o habra problemas.

Otra cosa que debes saber es que un agent puede ver los archivos de workspace de otro agent si se da el caso necesario o innecesario.

Juan Pablo García Chávez

student•

🦞 OpenClaw + Telegram — GUÍA COMPLETA RÁPIDA

⚡ INICIO RÁPIDO (LO QUE SIEMPRE FUNCIONA)

🚀 1.LevantarOpenClaw

openclaw gateway restartopenclaw gateway status

🔌 2. Activar Telegram

openclaw plugins enable telegram

⚙️ 3. Config mínima (OBLIGATORIA)

📁 Archivo:

~/.openclaw/openclaw.json

{  "channels": {    "telegram": {      "enabled": true,      "botToken": "TOKEN_DE_BOTFATHER"    }  },  "plugins": {    "entries": {      "telegram": {        "enabled": true      }    }  }}

🧪 4. Verificar

openclaw doctor

✔ Debe salir:

Telegram: ok

📦 PARTE 2 — DETALLES IMPORTANTES

📁 RUTAS CLAVE

🧠 Config principal

~/.openclaw/openclaw.json

📜 Logs

/tmp/openclaw/openclaw-*.log

⚙️ Servicio systemd

~/.config/systemd/user/openclaw-gateway.service

📦 Plugins

~/.openclaw/plugins/

🤖 BOT (BotFather)

Abrir Telegram
Buscar:

@BotFather

Crear bot:

/newbot

Copiar token:

123456:ABC...

Pegar en:

channels.telegram.botToken

🔌 ACTIVACIÓN REAL

openclaw plugins enable telegramopenclaw gateway restart

🚨 PARTE 3 — ERRORES COMUNES (DEBUG RÁPIDO)

❌ Bot no responde

✔ Solución:

usar /start en Telegram
revisar token

❌ Config mal puesta

❌ ERROR:

botToken dentro de plugins

✔ CORRECTO:

SOLO en channels.telegram

❌ Plugin no carga

openclaw plugins enable telegramopenclaw gateway restart

❌ Gateway roto / no responde

openclaw gateway restartsystemctl --user restart openclaw-gateway

❌ Puerto ocupado

pkill -f openclawopenclaw gateway restart

🧠 REGLA DE ORO

channels → configuración real (Telegram aquí vive)plugins → activación del módulogateway → servidor principal

🧭 RESUMEN FINAL (ULTRA CORTO)

👉 Telegram funciona SOLO si:

Gateway ON + Plugin ON + Token correcto + Bot iniciado (/start)

Ronald Miguel Serrano Hernández

student•

Eh creado mi bot, (/start)pero no me permíte extraer esta configuración para pegar en el openclaw

Carlos Enrique Ruiz Medina

student•

Tienes que arrancar openclaw primero openclaw gateway run

Luis Daniel Gordo Navas

student•

cuando pasa esto debes ejecutar

openclaw doctor

con esto crear un oauth dir para las credenciales y ahora si te dara el mensaje en telegram

Jorge Centeno

student•

Excelente. Saludos desde PANAMÁ.

Brayan Andrés Gutiérrez Yela

student•

Para algunos la capa gratuita de Google no es suficiente entonces una opción es en openrouter el cual te da acceso a todos los modelos puede recargar de 5 dolares como unos 22.000 COP, ellos se quedan con un porcentaje pequeño de la transacción pero los tokens salen a lo mismo que el proveedor directo entonces puede probar con varios modelos de claude, google, openIA, pero mi recomendación seria MINIMAX M 2.7 que lo han optimizado para openclaw y pues tiene mejor precio.

Alejandra Monges

student•

Gracias, Brayan, por la recomendación. Lo voy a probar.

Andres Rafael Tito

student•

Al hablar con mi nuevo bot y apretar /start solo me sale el mensaje "You are not authorized to use this command."

Ya intenté crear nuevos bots pero ninguno me reconoce :,9

Jess Harris

Team Platzi•

Intenta reiniciar el gateway de OpenClaw. Me había pasado la primera vez también.

Andres Rafael Tito

student•

Jess puse en mi terminal openclaw gateway --force y luego run, esta correcto?

Rollffin Guiroa

student•

Hola, realicé todos los pasos y no tuve ningún problema en la configuración, sin embargo cuando le escribo al bot desde telegram me responde "API rate limit reached. Please try again later." ¿se debe a que estoy usando el api gratuita de gemini?

Hola, Rollffin. Es muy probable que tu sospecha sea correcta.

El error "API rate limit reached" ocurre cuando superas la cantidad de peticiones permitidas por minuto o día en tu plan actual de Gemini. Al usar la versión gratuita, los límites son más estrictos y se agotan rápidamente si el agente realiza muchas consultas seguidas.

Para verificar si esto es el problema, intenta lo siguiente:

Espera unos minutos: Si el error desaparece después de un tiempo, confirma que es un límite de tasa.
Revisa tus logs: Ejecuta open claw doctor en tu terminal para descartar errores de configuración en el gateway.

Si el problema persiste, te recomiendo revisar Protege tus llaves API y contraseñas en OpenClaw para asegurar que tu conexión esté bien gestionada y no esté haciendo llamadas innecesarias al modelo.

Juan Carlos Gutiérrez Ayala

student•

No uses API, emplea Codex con tu cuenta de ChatGPT y listo, tendrás todas las capacidades del sistema, sin consumir un solo gramo de API, y sin incrementar costos.

Usuario anónimo

user•

Alguno le ha enviado audios y fotos por telegram usando gemma 4 con ollama y le ha funcionado? si es asi, me pueden indicar cual es la configuracion, gracias

Yeison Iván Serna López

student•

Interesante!... en mi caso tengo openclaw en una ec2-ubuntu en aws, llama3.1:8b, todo localmente en la maquina

Peter Cordova

student••

La solución que encontré para abaratar costos por el consumo de tokens es conectarlo vía OAUTH a OpenAI, los demás proveedores de IAs se conectan vía API y el consumo de token se vuelve bastante costoso.

Solo debes pagar los $20 del plan y con eso tienes para alimentar al agente.

Matias Ezequiel Rivero

student•

Hola, gracias por la info, con que plan de openIA se puede hacer? también con la capa gratuita? muchas gracias.

Daniel Humberto Ortiz Vargas

student•

no funcionaba por un error de instalacion, le pedi a claude code que lo corrigiera. sin embargo, no se que hizo pero lo hizo.

Daniel Humberto Ortiz Vargas

student•

el gateway hace de mi computadora como un servidor

Exactamente, Daniel Humberto. Al activar el Gateway, tu computadora deja de ser solo una herramienta de trabajo y empieza a actuar como un nodo de comunicación.

Funciona como un servidor porque está "escuchando" constantemente en la red. Cuando le envías un mensaje desde Telegram, el Gateway intercepta esa señal, la procesa y le da una respuesta.

Eso sí, hay una condición clave: para que ese "servidor" esté activo, tu computadora debe estar encendida y el proceso del Gateway corriendo. Si apagas la PC o cierras la terminal, el servidor se apaga y el bot queda desconectado.

¿Te das cuenta de por qué es vital mantener esa terminal abierta si quieres que tu agente esté disponible en cualquier momento?

Wilzon Mariño Bueno

student•

mi bot fhater esta en ruso, no entiendo ni una letra XD

Cristhian Camilo Delgado Pazos

student•

cuando ingreso el token de acceso de telegram a openclaw y luego voy a abrir el bot, no me aparece el mensaj donde me da el user id, tampoco el open claw paring aprove

Cristhian Camilo, si no recibes el mensaje con el ID al iniciar el bot, es probable que el Gateway no esté detectando correctamente la conexión o que el token no se haya guardado bien.

Intenta lo siguiente:

Verifica el Gateway: Asegúrate de que esté corriendo con openclaw gateway run. Si ya estaba abierto, deténlo con openclaw gateway stop y vuelve a iniciarlo.
Reconfigura: Ejecuta openclaw configure nuevamente, ve a channels y asegúrate de pegar el token correctamente.
Reinicia el proceso: Ve a tu bot en Telegram, presiona /start nuevamente. Si no aparece el código, intenta enviar cualquier mensaje al bot; a veces el Gateway necesita ese "impulso" para reconocer la interacción y generar el comando de emparejamiento.

Si el problema persiste, revisa Instalación de OpenClaw en Mac y Windows para asegurar que no haya conflictos de red.

Alejandro José Hugo Escalante Santos

student•

Muy importante herramienta.

Ruben Galindo

student•

que son proveedores de embeddings?

Hola, Ruben. Los proveedores de embeddings son servicios externos (como OpenAI o Gemini) que actúan como el "traductor" de tu agente para entender y organizar información.

Imagina que tu agente tiene una biblioteca gigante. Los embeddings convierten palabras y conceptos en listas de números (vectores) que representan su significado. El proveedor es la empresa que realiza ese cálculo matemático complejo.

Cuando habilitas esta función, el agente puede buscar en su memoria no solo por palabras exactas, sino por conceptos relacionados. Sin un proveedor configurado, el agente no puede "entender" el contexto de sus recuerdos o documentos almacenados.

Si quieres profundizar en cómo el agente gestiona esta información, te recomiendo revisar: Sesiones y memoria en OpenClaw.

Ruben Galindo

student•

Breve Post-Mortem: Falso Positivo de Seguridad en Diagnósticos Locales (OpenClaw v2026.3.13)

Durante el despliegue de una arquitectura de contenedores bajo un modelo Zero-Trust, nos enfrentamos a un error persistente de denegación de acceso: la consola local arrojaba el error missing scope: operator.read al intentar hacer un escaneo de salud del Gateway (status --all).

A pesar de que los canales externos (como la API de Telegram) funcionaban al 100% y las políticas de red estaban blindadas, la herramienta de diagnóstico interna seguía bloqueada. Tras iterar sobre permisos de volúmenes persistentes y reglas de proxy inverso sin éxito, el diagnóstico final reveló que la falla no estaba en la infraestructura, sino en el código fuente.

Se identificó como un bug documentado de la versión 2026.3.13 de la aplicación, donde el sistema falla al validar sus propios tokens de permisos en conexiones loopback.

Lección aprendida para la clase: Cuando el servicio principal responde correctamente en producción, pero las herramientas de diagnóstico locales marcan fallas críticas de autenticación, el siguiente paso antes de desarmar y reconstruir la infraestructura (o purgar cachés) debe ser revisar los issues del repositorio oficial. En entornos fuertemente aislados, a veces el firewall interno funciona tan bien que el software se bloquea a sí mismo por error de diseño.

Charles Castillo Rosas

student•

Mis notas 💚

Jose Florez

student••

Me estaba salinendo el error que le estaba saliendo a todos al poner /start, pero hablando con gemini, descubrimos que era que el operador de internet tenia bloqueados los servidores de telegram por alguna razon, y descargando warp se soluciono

Ana

student•

cómo lo resolviste?

Carlo Wesley Martinez Ortiz

student•

Creí que seria muchísimo más complejo pero no, además me gusta que el profesor ha explicado que significan los mensajes que salen durante un comando openclaw doctor.

Como aporte me gustaria mencionar que también podemos ajustar algunas cosas como el soul, identity y el user directamente hablando con el chat o el bot. En lenguaje totalmente natural.

Configura el Gateway y comunícate con tu agente via Telegram

Instalación y conceptos básicos

Crea tu propio agente autónomo con OpenClaw

Instalación de OpenClaw en Mac y Windows

NUEVA CLASE: Despliega OpenClaw en un Servidor Virtual

Crea la identidad de tu agente: Soul, Identity y User