Configuración de la CLI de Telegram
Configura perfiles, rutas locales, variables de entorno y el servicio en segundo plano de la CLI de Telegram.
Guarda ajustes que repetirías en cada comando. Esta guía explica su ubicación y prioridad para cambiar un valor y comprobar cuál se aplica.
Utilice esta página cuando escriba la misma opción una y otra vez, o cuando desee que tg se comporte de manera diferente para una cuenta. Al final sabrá dónde está el archivo de configuración, qué hacen las configuraciones comunes, cómo cambiar una y cómo verificar qué valor está vigente. No necesita un archivo de configuración para comenzar: sin uno, cada configuración tiene un valor incorporado.
Algunas palabras que utiliza esta página:
- Archivo de configuración (
config.json): un archivo de texto dondetgguarda sus opciones guardadas. - Perfil: un conjunto de configuraciones con nombre para una cuenta de Telegram o un bot, como
work. Pones su nombre antes del comando:tg work chats list. Consulte perfiles y bots. - Opción (o bandera): una palabra agregada a un comando, como
--limit 5. Sólo cambia esa ejecución. - Variable de entorno: un valor con nombre que su terminal o el proceso de su agente le da a
tg, como por ejemploTG_PROFILE=work. - Predeterminado: el valor que utiliza
tgcuando nada más establece uno.
Lo que puedes configurar
Éstas son las configuraciones que la mayoría de la gente cambia. Cada uno tiene una entrada exacta, con su tipo y todas las formas de anularlo, en la referencia de configuración.
| Configuración | Qué hace | Valor incorporado |
|---|---|---|
limit | cuántas filas muestra una lista cuando no agrega --limit | 20 |
sends_per_hour | la mayor cantidad de mensajes que este perfil puede enviar en una hora; detiene un bucle de envío | 30; un bot no tiene límite hasta que se establezca uno en la sección bot |
requests_per_minute | qué tan rápido tg le pide cosas a Telegram después de una breve ráfaga; 0 apaga el ritmo (límites y esperas) | sin definir, lo que equivale a 60 |
permissions | qué puede hacer este perfil: solo lectura, preguntar primero o seguir adelante (permisos) | todo está permitido, excepto: eliminar y algunos otros cambios que no se pueden deshacer, pregunte primero; las reglas de respuesta pueden no enviarse |
record | mantenga un registro de cada ejecución para verlo más tarde (diagnóstico) | false |
keep_runs_for_days | Días de conservación de los registros | 30 |
color | color en tablas | lo decide tu terminal |
sender_colors | un color diferente para cada remitente en una lista de mensajes | false |
timeout_ms | cuánto tiempo puede esperar una solicitud a Telegram, en milisegundos. Para limitar un comando completo, use --timeout en su lugar | la propia espera de la conexión |
proxy | un servidor proxy para acceder a Telegram, donde está bloqueado (configuración de proxy) | ninguno |
transcribe_with | quién convierte mensajes de voz en texto: auto, messenger o local | auto |
update_check | una vez al día, avise cuando exista un tg más nuevo | true |
El archivo no guarda secretos. No tiene lugar para su sesión, el hash de la aplicación, un número de teléfono o una contraseña de proxy. La sesión es un archivo propio y el hash de la aplicación y una contraseña de proxy van al llavero de su sistema o, cuando no hay ninguno, a un archivo que solo usted puede leer (donde reside el inicio de sesión).
Un archivo de configuración de ejemplo
El primer comando que lee la configuración crea un archivo de inicio. Se ve así, con un perfil agregado:
{
"defaults": { "limit": 20, "keep_runs_for_days": 30, "sends_per_hour": 30, "update_check": true, "skill_hint": true },
"profiles": {
"work": { "limit": 50 }
}
}defaultsse aplica a todos los perfiles.profiles.workse aplica sólo al perfilworky gana adefaults.
Entonces, tg work chats list muestra 50 filas y tg personal chats list muestra 20. Agregue --limit 5 para obtener cinco para un comando. Elimine el limit del perfil y el valor de defaults se aplicará nuevamente.
Un ejemplo completo con cada sección
{
"defaults": {
"limit": 20,
"keep_runs_for_days": 14,
"sends_per_hour": 30,
"requests_per_minute": 60,
"update_check": true,
"skill_hint": true
},
"profiles": {
"personal": {
"limit": 50,
"color": true,
"sender_colors": true,
"record": true
},
"work": {
"permissions": { "messages": "readonly", "messages.send": "allow" },
"sends_per_hour": 10,
"proxy": "socks5://proxy.example:1080",
"transcribe_with": "local"
}
},
"personal": {
"defaults": { "search_catch_up": true }
},
"bot": {
"defaults": { "permissions": { "bot": "readonly", "bot.messages.send": "allow" } },
"profiles": {
"shop": { "sends_per_hour": 200, "read_other_bots": false }
}
}
}Qué hace cada parte:
defaults: cada perfil obtiene estos valores a menos que establezca los suyos propios.update_checkyskill_hintsolo se permiten aquí, porque hay una copia detgpara todos los perfiles.profiles.personal: más filas, colores y un registro de cada ejecución, sólo parapersonal.profiles.work: se permite la lectura de mensajes, se permite el envío, se rechaza cualquier otro cambio en los mensajes. Como máximo 10 envíos por hora. Se accede a Telegram a través de un proxy SOCKS5. Los mensajes de voz se convierten en texto en esta computadora.personal.defaults: aplica sólo a comandos para cuentas personales, nunca atg … bot. Aquí,messages synctambién prepara chats recuperados para la búsqueda.bot.defaults: aplica solo a comandos de bot (tg shop bot …). Los bots pueden leer y enviar, y nada más.bot.profiles.shop: el botshoppuede enviar 200 mensajes por hora y no puede leer lo que guardaron otros bots en este ordenador.read_other_botsestá permitido sólo en la secciónbot.
Dónde está el archivo
| Sistema | Camino |
|---|---|
| Linux y macOS | ~/.config/tg-cli/config.json |
| Windows | %APPDATA%\tg-cli\Config\config.json |
tg config show imprime la ruta que realmente usa esta computadora y cada configuración con su valor. En PowerShell, escriba tg.cmd en lugar de tg. Un archivo existente nunca es reemplazado por el archivo inicial.
Tres formas de establecer un valor
- En el archivo: el valor permanece para comandos posteriores.
tg personal config set limit 50lo guarda. - Con una variable de entorno: el valor es válido para un terminal o un proceso de agente. Por ejemplo,
TG_PROFILEelige un perfil yTG_TIMEOUTlimita cuánto tiempo se puede ejecutar un comando. Sólo algunas configuraciones tienen una variable. - Con una opción:
--limit 5cambia solo este comando.
¿Qué valor tiene prioridad?
Una opción gana a una variable de entorno. Luego viene el valor propio del perfil en el archivo, luego defaults en el archivo y luego el valor integrado. Un ajuste participa sólo en las formas en que lo apoya; la referencia de configuración los enumera para cada configuración.
Cambiar un valor
Puede editar el archivo en cualquier editor de texto o dejar que tg lo haga. config set comprueba el valor antes de escribirlo, por lo que nunca guarda un archivo que un comando posterior rechace.
tg personal config set limit 50 # the profile "personal"
tg work config set limit 50 # the profile "work"
tg config set sends_per_hour 10 --defaults # every profile
tg personal config unset limit # back to the default
tg personal config show # check what is in force, and where each value came fromUna configuración mal escrita en el archivo es un error, no un valor predeterminado silencioso: cada comando se detiene y nombra la clave incorrecta (errores tipográficos en el archivo).
Perfiles y bots
Un perfil mantiene la configuración para una cuenta o un bot. Coloque su nombre antes del comando, como tg work config show. Agregue bot después del nombre para que funcione como un bot en lugar de como su cuenta personal. Perfiles y bots explica cómo crearlos y cambiarlos.
Próximo
- Permisos: elige lo que puede hacer un perfil y el agente que lo utiliza.
- Referencia de configuración: cada configuración, su tipo, dónde puede aparecer y cada variable de entorno.