telegram-bot 是 Telegram 机器人与 harness 智能体栈之间的桥梁，负责 Telegram 侧的交互体验：斜杠命令、模型选择键盘、消息实时编辑和审批提示；回合执行、流式输出与持久化交由 harness、session-manager、approval-gate 处理。入站文本会变成一次 harness::send 回合，助手输出再以 Telegram 消息形式返回。它不是通用机器人框架，也不对外提供自行发送消息的接口。
用途：把已有的 harness 智能体呈现给 Telegram 用户，支持流式回复与实时编辑；让聊天用户选择或切换模型，并在聊天中引导或取消运行中的回合；在 Telegram 内联批准或拒绝被挂起的工具调用；按可配置的详细程度把会话记录同步到聊天。
主要能力：入站更新支持长轮询（默认，无需公网地址）或 HTTPS webhook；每个聊天可通过 /start 选择模型，也可用 default_model 固定；智能体只会获得 functions_allow 授权的工具；所有配置字段支持热重载。内部绑定会在消息新增、消息更新、状态变化、回合完成、审批创建与解决时渲染到对应聊天，并提供 telegram-bot::notify 作为会话范围内的主动通知出口。
使用方式：需先安装同栈组件（harness、session-manager、llm-router、context-manager、approval-gate），并在配置中提供包含 bot_token 的 telegram-bot 配置项。首条消息在机器人侧生成会话 id 并保存 chat_id 与 session_id 的映射，后续消息延续该会话，直到再次 /start。
限制：没有向聊天发送任意文本的公开函数；输出仅作为映射到该聊天的会话上的 harness 回合结果出现。没有调度器、cron 或计时器，不会自行发送延迟或主动消息。仅渲染持有 chat_id 与 session_id 映射的会话，其他会话的回合不会产生 Telegram 内容。缺少同栈组件时不受支持。