更新时间: 2026-03-28

适用平台: Linux / macOS

开发者: 独立开发者

GitHub: telegram-cli

📌 教程简介

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

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

✨ 核心特性

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 版本仅支持文本和文件传输

🔗 相关资源

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

服务器管理和自动化利器