# @dreb/telegram 中文文档

规范地址：https://npmcn.com/package/%40dreb/telegram/

版本：2\.83\.0
npm 元数据更新时间：2026-11-12T20:59:07.983Z
中文译文更新时间：2026-11-12T22:39:41.680Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dreb/telegram
原文对照：https://npmcn.com/package/%40dreb/telegram/?lang=original
项目主页：https://github.com/aebrer/dreb#readme
源码仓库：https://github.com/aebrer/dreb

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：509 kB，86 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^26\.13\.0
- 运行依赖：3 个
- 首次发布：2026-04-09T13:38:09.701Z
- 最新版本发布：2026-11-12T20:59:07.588Z
- 近 30 天下载量：3693（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：160（近 12 个月 160 个）

## 中文简介

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

## 安装

```sh
npm install @dreb/telegram
```

也可以使用：`pnpm add @dreb/telegram`、`yarn add @dreb/telegram`、`bun add @dreb/telegram`

## README

# @dreb/电话

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

## 设置

### 1\. 创建一个Telegram机器人

说话 [@ 父爱 @ info](https://t.me/BotFather) 并创建新机器人 `/newbot`. 复制标志.

### 2\. 获取您的电报用户ID

消息 [@ userinfobot](https://t.me/userinfobot) 要获取数字用户身份.

### 3\. 配置环境变量

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

### 4\. 创建机密文件

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

```bash
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\. 安装和运行

```bash
npm install -g @dreb/telegram
```

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

```bash
dreb-telegram
```

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

从源头建楼

```bash
# From the monorepo root
npm run build
node packages/telegram/dist/index.js
```

### 6\. 系统化服务(建议)

```bash
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 是什么？

用于 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 和提交记录判断。