Telegram CLI – 命令行终端版完整教程

更新时间: 2026-03-28

适用平台: Linux / macOS

开发者: 独立开发者

GitHub: telegram-cli

📌 教程简介

Telegram CLI 是 Telegram 的命令行界面客户端，适合服务器管理员、开发者、自动化脚本使用。可以在无图形界面的服务器上运行 Telegram，支持脚本自动化和机器人开发。

✨ 核心特性

1. 命令行界面 ⭐⭐⭐⭐⭐

• 纯文本界面
• 键盘操作
• 脚本友好
• 服务器运行

2. 自动化支持 ⭐⭐⭐⭐⭐

• 脚本编程
• 定时任务
• 自动回复
• 消息监控

3. 轻量级 ⭐⭐⭐⭐⭐

• 极低资源占用
• 无需图形界面
• 后台运行
• 适合服务器

4. 开发者友好 ⭐⭐⭐⭐⭐

• API 接口
• Lua 脚本
• Python 绑定
• 灵活扩展

📥 安装方法

Ubuntu/Debian

sudo apt install telegram-cli

Arch Linux

sudo pacman -S telegram-cli

macOS

brew install telegram-cli

从源码编译

git clone https://github.com/vysheng/tg.git















cd tg















./configure















make















sudo make install

🚀 快速开始

第一步: 启动并登录

telegram-cli

首次运行会要求输入手机号和验证码。

第二步: 基本命令

contact_list          # 查看联系人列表















dialog_list           # 查看对话列表















msg <peer> <text>     # 发送消息















view_history <peer>   # 查看历史消息 

第三步: 发送消息

msg user#123456 Hello!

💡 常用命令

联系人管理

contact_list          # 联系人列表















add_contact <phone> <first> <last>   # 添加联系人















del_contact <user>    # 删除联系人 

消息操作

msg <peer> <text>     # 发送消息















fwd <peer> <msg>      # 转发消息















reply <msg> <text>    # 回复消息 

群组操作

create_group <name> <user>...    # 创建群组















chat_info <chat>      # 群组信息















chat_add_user <chat> <user>      # 添加成员 

文件操作

send_photo <peer> <file>         # 发送图片















send_document <peer> <file>      # 发送文件















load_photo <msg>      # 下载图片 

🔧 自动化脚本

Lua 脚本示例

function on_msg_receive (msg)















  if msg.text == "ping" then















    send_msg(msg.from.print_name, "pong", ok_cb, false)















  end















end

运行脚本

telegram-cli -s script.lua

⚙️ 高级配置

配置文件

~/.telegram-cli/config

后台运行

telegram-cli -d

自定义端口

telegram-cli -P 1234

❓ 常见问题

Q1: 如何退出？

输入 quit 或 safe_quit

Q2: 如何查看帮助？

输入 help 查看所有命令

Q3: 如何静默运行？

使用 -d 参数后台运行

Q4: 支持语音通话吗？

不支持，CLI 版本仅支持文本和文件传输

🔗 相关资源

• GitHub: https://github.com/vysheng/tg
• 文档: https://github.com/vysheng/tg/wiki
• API: Telegram Bot API

综合评分 : ⭐⭐⭐⭐ (4/5)

服务器管理和自动化利器