@dreb/telegram

中文文档
2.83.0发布于 2026/11/13MITTypeScriptES Module构建来源已验证近 30 天下载 3693

用于 dreb 编码代理的 Telegram bot 前端

中文使用文档
文档目录12 节
  1. 设置
  2. 1. 创建一个Telegram机器人
  3. 2. 获取您的电报用户ID
  4. 3. 配置环境变量
  5. 4. 创建机密文件
  6. 5. 安装和运行
  7. 6. 系统化服务(建议)
  8. 图标
  9. 会议
  10. 探员
  11. 控制权
  12. 特征

@dreb/电话

Dreb编码代理的Telegram bot前端. 通过其原生的RPC协议(stdin/stout JSONL)与dreb通信.

设置

1. 创建一个Telegram机器人

说话 @ 父爱 @ info 并创建新机器人 /newbot. 复制标志.

2. 获取您的电报用户ID

消息 @ userinfobot 要获取数字用户身份.

3. 配置环境变量

变量需求说明
TELEGRAM_BOT_TOKEN✅Bot API 密码
ALLOWED_USER_IDS✅以逗号分隔的用户ID
DREB_WORKING_DIR会话工作目录( 默认值 : $HOME(中文(简体) )
DREB_PATH二进制路径( 默认 ): dreb(中文(简体) )
DREB_TELEGRAM_SERVICE系统服务名称( 默认 ) : dreb-telegram(中文(简体) )
DREB_PROVIDERLLM 提供者(例如, anthropic(中文(简体) )
DREB_MODEL型号ID(例如, claude-sonnet-4(中文(简体) )

4. 创建机密文件

机器人从中装入秘密 ~/.dreb/secrets/telegram.env 自动——无论是直接运行还是通过系统运行.

mkdir -p ~/.dreb/secrets
cat > ~/.dreb/secrets/telegram.env << 'EOF'
TELEGRAM_BOT_TOKEN=your-token-here
ALLOWED_USER_IDS=your-user-id-here
EOF
chmod 600 ~/.dreb/secrets/telegram.env

这个文件是被指向的。 明确的环境变量优先于文件.

5. 安装和运行

npm install -g @dreb/telegram

设置您的秘密(见第4步),然后运行:

dreb-telegram

机器人自动装入从 ~/.dreb/secrets/telegram.env。 。 。 .

从源头建楼
# From the monorepo root
npm run build
node packages/telegram/dist/index.js
cp packages/telegram/dreb-telegram.service.template ~/.config/systemd/user/dreb-telegram.service
systemctl --user daemon-reload
systemctl --user enable --now dreb-telegram

图标

会议

  • /start – 帮助命令列表( C)
  • /new ——开始新会话(保留当前工作目录)
  • /new <path> ——在指定的目录中开始新会话
  • /new <segment> ... ——家道相通的移动快手等. /new projects dreb 决定: ~/projects/dreb; 引用的包含空格的段段的工作跨度, 例如 . /new "My Projects" dreb
  • /sessions - 列出最近几届会议
  • /resume <id> ——按会话 ID 前缀恢复
  • /recent [N] —— 重新发送最后一个 N 助理消息

探员

  • /status 连接版本信息( V)
  • /stats - 托肯使用率、成本和按型号计算的最新100个中位TPS,具有长期三角形(匹配TUI和仪表板)
  • /compact - 契约背景
  • /model [pattern] - 视图/开关模式
  • /thinking [level] - 视图/设定思维级别
  • /agents - 背景子剂状态

控制权

  • /cwd - 工作目录
  • /stop —— 中断并清除队列( C)
  • /restart - 恢复机器人服务

特征

  • 用户信件队列 ——一次一个提示,收到信件排队
  • 实时工具显示 —— ephemeral status message 显示工具、任务列表、子代理和关键参数
  • 可见工具结果 ——永久消息显示用户从以下工具获得的结果: suggest_next, (中文(简体) ), search,以及 wait
  • 限速状态更新 ——为避免Telegram 429出错而解除
  • 文件上传 3s批发的文件、照片、声音、音频、视频
  • 文件下载 —— 说 [[telegram:send:/path]] 助理文本中的标记
  • 会话管理 ——自动重现最新,前缀匹配,持久性
  • 倒计时 ——先尝试Markdown,倒回纯文本
  • 进程隔离 – 每个用户一个 RPC 子进程, 崩溃时自动重新启动

版本与发布记录

@dreb/telegram 共发布 160 个版本,首次发布于 2026/04/09;过去 12 个月发布了 160 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.83.0latest2026/11/13今天
2.82.02026/11/112 天前
2.81.02026/11/102 天前
2.80.02026/11/103 天前
2.79.12026/11/103 天前
2.79.02026/11/076 天前

关于 @dreb/telegram 的常见问题

@dreb/telegram 是什么?

用于 dreb 编码代理的 Telegram bot 前端

如何安装 @dreb/telegram?

在项目目录运行 npm install @dreb/telegram,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dreb-telegram,可以用 npx dreb-telegram 直接运行。

@dreb/telegram 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dreb/telegram 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dreb/telegram 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^26.13.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dreb/telegram 可以商用吗?

@dreb/telegram 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dreb/telegram 的下载量有多少?

根据 npm 官方下载统计,@dreb/telegram 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,693 次,日均约 123 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dreb/telegram 还在维护吗?

最新版本 2.83.0 发布于 2026/11/13(今天);至今共发布 160 个版本,其中过去 12 个月发布了 160 个;首次发布于 2026/04/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。