基于 rust 的 telegrame LLM 一个消息意图分类器 ( rust openclaw )

一个 Rust 编写的 Telegram Bot 常驻进程，监听 Telegram 频道/群组/私聊消息，通过 LLM（大语言模型）智能判断用户意图：对于提问直接回答，对于操作指令自动转化为 shell 命令并执行，支持返回图片。

架构

Telegram 频道/群组消息
       │
       ▼
  ┌──────────┐
  │ rust-bot │  (常驻进程，Long Polling)
  └──────────┘
       │
       ▼
  ┌──────────────────┐
  │ LLM API 意图分类  │  (OpenAI 兼容接口)
  └──────────────────┘
       │
       ├── 问题 → 直接回答，编辑消息返回
       │
       └── 操作 → 解析命令列表
                    │
                    ▼
              ┌──────────┐
              │ Shell 执行 │
              └──────────┘
                    │
                    ▼
              结果回传 Telegram（文本 + 图片）

功能特性

智能意图识别 — LLM 自动判断消息是提问还是操作指令
问答模式 — 提问类消息直接由 LLM 回答
命令执行 — 操作类消息自动生成 shell 命令并执行
图片支持 — 命令输出中包含图片路径时自动发送图片（如截图）
消息编辑 — 「正在分析...」状态消息会被结果直接覆盖，不刷屏
并发处理 — 多条消息同时处理，不排队阻塞
频道支持 — 同时支持私聊、群组和频道消息
详细日志 — 每步操作带时间戳和耗时统计，方便排查问题

工作流程

启动 — 读取 config.toml，清理 Webhook，启动 Long Polling
监听 — 通过 Telegram Bot API 长轮询接收消息（支持频道/群组/私聊）
分析 — 发送「🔄 正在分析...」，调用 LLM 判断意图
处理
- 提问 → LLM 直接回答，编辑覆盖状态消息
- 操作 → 解析命令列表 → 显示执行计划 → 逐条执行 → 回传结果
图片 — 如果命令输出中包含图片文件路径，自动发送到频道

快速开始

前置条件

Rust 1.70+
一个 Telegram Bot Token（从 @BotFather 获取）
一个 OpenAI 兼容的 LLM API（如 OpenRouter）

构建

cargo build --release

配置

cp config.example.toml config.toml
# 编辑 config.toml，填入你的 Bot Token 和 LLM API 配置

运行

# 使用默认配置文件 config.toml
./target/release/rust-bot

# 指定配置文件路径
./target/release/rust-bot /path/to/config.toml

# 开启 debug 日志
RUST_LOG=debug ./target/release/rust-bot

Telegram Bot 设置

在 @BotFather 创建 Bot，获取 Token
如果用于频道：将 Bot 添加为频道管理员
如果用于群组：将 Bot 加入群组
启动程序，发送一条消息，从日志中获取 chat_id
将 chat_id 填入 config.toml 的 allowed_chat_ids

配置说明

配置项	说明	默认值
`telegram.bot_token`	Telegram Bot API Token	必填
`telegram.allowed_chat_ids`	允许的聊天 ID 白名单，空数组表示不限制	`[]`
`llm.base_url`	OpenAI 兼容 API 的 Base URL	必填
`llm.api_key`	LLM API Key	必填
`llm.model`	模型名称	必填
`llm.max_tokens`	最大生成 Token 数	`2048`
`llm.system_prompt`	自定义系统提示词（覆盖内置默认值）	内置
`executor.working_dir`	命令执行的工作目录	当前目录
`executor.timeout_secs`	单条命令超时时间（秒）	`120`
`executor.echo_result`	是否回传执行结果到 Telegram	`true`

LLM 接口

本程序通过 OpenAI 兼容的 Chat Completions API（/v1/chat/completions）与 LLM 交互，不使用 MCP 协议。

支持的 LLM 服务：

OpenRouter — 聚合多家模型
OpenAI
任何兼容 OpenAI API 格式的服务（如 Ollama、vLLM、LocalAI 等）

LLM 负责将用户消息分类为两种意图：

问题 — 返回回答内容
命令 — 返回要执行的 shell 命令列表

项目结构

src/
├── main.rs        # 入口，配置加载
├── bot.rs         # Telegram Bot 消息处理、并发调度
├── llm_client.rs  # LLM API 调用、意图分类
├── executor.rs    # Shell 命令执行
├── config.rs      # 配置文件解析
└── log.rs         # 带时间戳的日志宏

安全注意事项

务必配置 allowed_chat_ids，限制只有授权的频道/用户才能触发命令执行
该程序会在服务器上执行任意 shell 命令，请确保运行环境安全
建议使用受限用户运行，避免使用 root
config.toml 包含敏感信息（Token、API Key），请勿提交到公开仓库