Saltar a contenido

Ejecutar en la CLI

Esta página le guía desde cero hasta un bot en ejecución. No necesita experiencia previa con el proyecto. Si un término no está claro, consulte las páginas de Conceptos.

Antes de empezar

Necesita dos datos de Telegram:

  1. Un token de bot. Abra un chat con @BotFather, envíe /newbot, siga las indicaciones y copie el token recibido. Se parece a 123456789:AAExampleTokenValue.
  2. Su id numérico de usuario. Es un número, no su @username. Si no lo conoce, el bot se lo indicará la primera vez que le escriba; consulte el paso 5.

Paso 1: descargar

Descargue el archivo de la versión y extráigalo.

Descargar y abrir la carpeta de la versión

Descargar y extraer la versión
wget -O telegram-commander.tar.gz https://github.com/azolfagharj/telegram-commander/releases/latest/download/telegram-commander.tar.gz
tar -xzf telegram-commander.tar.gz
cd telegram-commander

Dentro de la carpeta encontrará:

Paso 2: elegir el binario

¿Qué archivo corresponde a su máquina?

La mayoría de los servidores y PC son amd64, también llamado x86_64. Las placas ARM pequeñas y algunas máquinas virtuales son arm64.

Si no está seguro, ejecute uname -m: x86_64 significa amd64 y aarch64 significa arm64.

Conservar el programa amd64
mv telegram-commander-linux-amd64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-arm64
Conservar el programa arm64
mv telegram-commander-linux-arm64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-amd64

Ahora tiene un único programa llamado telegram-commander.

Paso 3: crear la configuración

Copie el ejemplo mínimo a un archivo de trabajo. Abre la categoría System Status con tres botones de solo lectura: Uptime, Memory y Disk Space. No hay un botón para escribir un comando libre.

Crear una configuración editable

Copiar la configuración de ejemplo
cp config-examples/config.minimal.yaml ./config.yaml

Abra config.yaml y sustituya dos marcadores:

  • YOUR_BOT_TOKEN — el token de BotFather
  • YOUR_USER_ID — su id numérico, o déjelo por ahora y consulte el paso 5

Para conocer todos los ajustes, lea Configuración.

Paso 4: validar

Compruebe siempre la configuración antes de ejecutar el bot. Así detectará errores sin iniciarlo.

Comprobar que la configuración funciona

Validar la configuración
./telegram-commander validate --config config.yaml

Si muestra Valid configuration, todo está listo. En caso contrario, indica exactamente el problema y su ubicación. Consulte la página de la CLI.

Paso 5: encontrar su id de usuario (si es necesario)

Si no conoce su id, escriba solo el token en config.yaml, ponga por ahora cualquier número en allowed_users y ejecute el bot:

Iniciar una vez para ver su id de usuario

Ejecutar el bot para conocer su id
./telegram-commander run --config config.yaml

Abra Telegram, busque su bot y envíele cualquier mensaje. Como aún no está entre los usuarios permitidos, el bot responde con su user_id y username. Copie el id a allowed_users, detenga el bot con Ctrl+C y vuelva a ejecutarlo.

Este comportamiento forma parte del control de acceso; consulte Configuración → telegram.

Paso 6: ejecutar

Iniciar el bot en la terminal

Iniciar el bot
./telegram-commander run --config config.yaml

Abra el bot en Telegram y envíe /start. Debería ver el menú. Toque un botón para ejecutar su comando.

Su bot está activo

El menú descrito en config.yaml ya está en su chat y cada toque ejecuta su comando en esta máquina.

Para mantener el bot en ejecución después de cerrar la sesión del servidor, configúrelo como servicio. Consulte Ejecutar como servicio.

Siguientes pasos