@clisbot/channels-discord

中文文档
2.2.3发布于 2026/11/05TypeScriptES Module近 30 天下载 4080

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

中文使用文档
文档目录6 节
  1. 现场测试需要什么
  2. 解析程序
  3. 试验表面
  4. 最小账户配置
  5. 今天获得支持
  6. 尚未支持

@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/应用软件,添加一个 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_TOKENA 类 第二届 bot,仅作为外部发送器使用. 绝不用它配置主机 .

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

最小账户配置

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 共发布 18 个版本,首次发布于 2026/10/10;过去 12 个月发布了 18 个版本。

版本发布日期距今
2.2.3latest2026/11/055 天前
2.2.22026/11/037 天前
2.2.12026/11/019 天前
2.2.02026/10/2714 天前
2.1.82026/10/2218 天前
2.1.72026/10/2219 天前

关于 @clisbot/channels-discord 的常见问题

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