# @clisbot/channels-discord 中文文档

规范地址：https://npmcn.com/package/%40clisbot/channels-discord/

版本：2\.2\.3
npm 元数据更新时间：2026-11-05T01:28:26.034Z
中文译文更新时间：2026-11-10T02:09:00.337Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40clisbot/channels-discord
原文对照：https://npmcn.com/package/%40clisbot/channels-discord/?lang=original

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

- 包体积（解压后）：1 MB，321 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：8 个
- 首次发布：2026-10-10T10:30:04.086Z
- 最新版本发布：2026-11-05T01:28:25.837Z
- 近 30 天下载量：4080（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

在Repo Discord频道垂直(目标分类账切片13). 由扩展/discord/src@5d8067a4483:手卷Discord REST/Gateway客户端(src/内部),发送/动作/组件/markdown关闭,以及Fusion边界适配器. 第三方

## 安装

```sh
npm install @clisbot/channels-discord
```

也可以使用：`pnpm add @clisbot/channels-discord`、`yarn add @clisbot/channels-discord`、`bun add @clisbot/channels-discord`

## README

# @clisbot/ channels-discord (英语)

内部Discord频道垂直(目标分类账切片13). 从 `extensions/discord/src@5d8067a4483` 看到了吗 `upstream-sync.json` 联 合 国 逐个文件映射, 偏差( n)`D-DC-0xx`)和省略的内容.

第三方的SDK是上游的, 在上游的版本: `discord-api-types`, (中文(简体) ), `ws`, (中文(简体) ), `undici`, (中文(简体) ), `typebox`, (中文(简体) ), `mdast-util-from-markdown`上游手卷 Discord REST + 网关客户端在 `src/internal/` 而不是依赖 `discord.js`;该客户端是逐字携带的.

## 现场测试需要什么

自己提供这些,放回原地 `.env`此软件包 从不读 `.env` 而这里没有价值是真正的证明——只有名字.

### 解析程序

1.  在 [https://discord.com/developers/应用软件](https://discord.com/developers/applications),添加一个 Bot 用户,并复制到 `DISCORD_BOT_TOKEN`。应用程序编号为 解码了,所以 `applicationId` 在配置中仅在 REST 时需要 应用程序搜索被屏蔽 .
2.  下 **Bot – 保密的门户意向**,启用 **信件内容 意图**。没有它Discord送出空 `content` 用于表示 机器人在交通工程中没有被提及,仅被提及. **服务器成员** 财务报告和审定财务报表 **出席情况** 停止——垂直不请求 除非他们 `channels.discord.accounts.<id>.intents` 问.
3.  下 **OAuth2 — URL 生成器**,选择范围 `bot` 财务报告和审定财务报表 `applications.commands`,然后bot 权限 :
    -   查看频道、 发送信件、 以线索发送信件
    -   创建公共线索, 管理线索
    -   嵌入链接、 附加文件、 读取信件历史
    -   添加反应, 管理信件( pin/ 撤销和删除需要)
    -   使用外部 Emojis( 只用于 `discord.emoji-list` 横跨荷兰盾)
4.  邀请机器人使用生成的 URL 进行测试 .

### 试验表面

| 新闻 var | 一定是这样 |
| --- | --- |
| `DISCORD_BOT_TOKEN` | 正在测试的机器人。 从来没有司机账户. |
| `DISCORD_TEST_GUILD_ID` | 瓶被邀请了. |
| `DISCORD_TEST_CHANNEL_ID` | 一个盾 **文本** 引导机器人可以读取并发布. |
| `DISCORD_TEST_THREAD_ID` | 该频道下的一个线程(Discord线程本身就是频道id). |
| `DISCORD_TEST_DM_USER_ID` | 用户 id 机器人 打开一个 DM 。 那个用户必须和机器人分享盾牌. |
| `DISCORD_TEST_BOT_USER_ID` | 机器人自己的用户代号 `<@id>` 提及标记和自带信息过滤器. |
| `DISCORD_DRIVER_BOT_TOKEN` | A 类 **第二届** bot,仅作为外部发送器使用. 绝不用它配置主机 . |

驱动程序/ 测试对象的分割是相同的规则 (CLAUDE.md,"需要的Slack和Telegram E2E角色"):一个直接的 `sendText` 是一个 仅限外出抽烟测试. 所需证明是外部发送者 出入口 出入口 代理转 ~ 在同一个对话中回复, 然后一个 REST 回读 (单位:千美元)`GET /channels/{id}/messages`匹配返回的消息 id.

### 最小账户配置

```yaml
channel: discord
accountId: main
connectionId: <hub connection id>
transport: { mode: gateway }
routes:
  - match: { kind: dm }
    agent: <agent>
    environment: <environment>
  - match: { kind: channel, ids: ["<DISCORD_TEST_CHANNEL_ID>"] }
    agent: <agent>
    environment: <environment>
```

机器人的标志 住在Hub连接的证书下 `token`中,没有 这个文件.

## 今天获得支持

入境(`MESSAGE_CREATE` 网关上:DM、荷兰文和线; 提及检测(说明 `<@id>` 提及或回复机器人) 和 bot- author 过滤; 持久录入 Hub 入侵队列 discord 消息 ID, 所以一个网关 RESUME 重递被丢弃而不是 重放过.

出局:带有上层标记下渲染、块和引用的文本 重写; 任何类型的文件( 每个文件一个消息, 大小加起来); 消息编辑 并删除; pin/unpin/list-pins; 反应(添加、去除、列表); 线程创建 和线索回复; 民意测验; 贴纸; emoji上传和 `emoji-list`;webhook发送; 嵌入和信件组件(按钮、选择),包括演示文稿 适配器; 打字指标; 盾/道/成员/角色读取和盾-admin 在一个值得信任的请求者背后的上游门上行动.

## 尚未支持

命名于此, 上面没有比它更多的内容 .

-   **语音信息和语音频道** —— 说 `send.voice.ts`, (中文(简体) ), `voice-message.ts` 财务报告和审定财务报表 全文 `src/voice` 树被省略(ffmpeg/opus 转码, `@discordjs/voice`) (中文(简体) ). 这个 `send` 动作的 `asVoice` 分支抛出(D-DC-004).
-   **活 动** —— 说 `src/activities` 需要公共端点 揭露.
-   **斜线命令和交互调用** 指挥部署和互动 发送已运入 `src/internal`,但没有任何注册或路径 尚未; 按钮和选择点击无法到达 Hub .
-   **输入反应、消息编辑/删除、附件** ——门户 运输只规范化 `MESSAGE_CREATE`。未下载入境媒体.
-   **网关代理** ——一个配置 `proxy` 被大声拒绝,而不是 默默被忽略(D-DC-008).
-   **设置/ 医生表面** — OpenClaw 向导和 `doctor` 省去树木; 枢纽拥有登机.

## 常见问题

### @clisbot/channels-discord 是什么？

在Repo Discord频道垂直\(目标分类账切片13\)\. 由扩展/discord/src@5d8067a4483:手卷Discord REST/Gateway客户端\(src/内部\),发送/动作/组件/markdown关闭,以及Fusion边界适配器\. 第三方

### 如何安装 @clisbot/channels-discord？

在项目目录运行 npm install @clisbot/channels-discord，或使用 pnpm add / yarn add / bun add。

### @clisbot/channels-discord 支持 TypeScript 吗？

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

### @clisbot/channels-discord 支持 ESM 还是 CommonJS？

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

### @clisbot/channels-discord 可以商用吗？

@clisbot/channels-discord 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @clisbot/channels-discord 的下载量有多少？

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

### @clisbot/channels-discord 还在维护吗？

最新版本 2\.2\.3 发布于 2026/11/05（5 天前）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/10/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。