@clisbot/channels-feishu

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

垂直回波Feishu/Lark信道(目标分类账切片15)。 由扩展/feishhu/src@5d8067a4483移植:Lark SDK客户端+租户-托肯管道,6个feishu-QQ代理工具家庭,WS长连接/webhook运输,发送+卡分块

中文使用文档
文档目录5 节
  1. 包裹是做什么的
  2. 频道工具
  3. 测试
  4. 现场测试
  5. 接线

@clisbot/channels-feishu (英语)

(目标分类账分片15) extensions/feishu/src 在 OpenClaw 时 5d8067a448369个文件为字节-verbatim; upstream-sync.json 是机器检查的映射图( y)npm run channels:sync:check) (中文(简体) ).

第三方 SDK: @larksuiteoapi/node-sdk 1.73.0 (中文(简体) ) - 同一个包裹和 同一版本的上游针.

包裹是做什么的

层何处
驱动表面src/plugin.ts (单位:千美元)feishuPlugin, (中文(简体) ), src/entry.ts
账户使用周期src/lifecycle/start-account.ts
入地(长相src/fusion/ws-session.ts • 移植 monitor.transport.ts
输入( 网页)src/fusion/webhook-session.ts • 移植 monitor.transport.ts
常态器src/fusion/inbound-adapter.ts
入学src/fusion/admission.ts (在ACK / 200之前可延长)
出境src/outbound.ts • 移植 send.ts
信件动作src/channel-actions.ts
频道工具src/fusion/tools.ts • 移植 docx/chat/wiki/drive/perm/bitable.ts

两种入站模式均被接通. 长相接( :connectionMode: "websocket",默认值)不需要公开的 URL;webhook 模式有,并且是 未在生产中使用 - 单位测试一个真实的 node:http 听者而别.

频道工具

6个家庭,通过上游登记 register*Tools(api) 条目 合并登记员的分数(registerFeishuTools) (中文(简体) ). 工具名称来自 extensions/feishu/openclaw.plugin.json数字 :

feishu_doc, (中文(简体) ), feishu_chat, (中文(简体) ), feishu_wiki, (中文(简体) ), feishu_drive, (中文(简体) ), feishu_perm, (中文(简体) ), feishu_app_scopes,还有 8 feishu_bitable_* 名称. perm 已经关闭 默认( 上游) tools-config.ts)),其他每个家庭都在.

测试

npx vitest run packages/channels/feishu/src/fusion/tools.test.ts --maxWorkers=1 --no-file-parallelism

src/fusion/tools.test.ts 财务报告和审定财务报表 src/channel-actions.test.ts 驱动真正的工具 工厂和真正的发送路径 针对一个假 Lark SDK 客户端(客户端) 缓存是接合,所以没有代码路径被绊倒.

现场测试

尚未运行——没有配置飞舒证书. 活跑的需要,通过 环境变量 名称 (不承诺值;); .env 被给定:

变量这是什么
FEISHU_APP_ID鼠标自定义应用代号( L)cli_…(中文(简体) )
FEISHU_APP_SECRET鼠标自定义应用秘密
FEISHU_VERIFICATION_TOKEN事件订阅验证符 (webhook 模式)
FEISHU_ENCRYPT_KEY事件订阅加密密钥( webhook 模式; 签名请求)
FEISHU_TEST_CHAT_IDoc_… 组聊天 机器人是
FEISHU_TEST_DM_OPEN_IDou_… 开出ID,供德国马克往返
FEISHU_DOMAINfeishu (open.feishu.cn)或 (中文(简体) ) lark (open.larkssuite.com) (中文(简体) )

App 瞄准端口表面所需的机器人 : im:message, (中文(简体) ), im:message.group_at_msg, (中文(简体) ), im:message:send_as_bot, (中文(简体) ), im:chat:readonly, (中文(简体) ), im:resource附加时 docx:document, (中文(简体) ), drive:drive, (中文(简体) ), wiki:wiki 财务报告和审定财务报表 bitable:app 用于相应的工具家族。 漫长的联系也 需要应用程序控制台启用“ Event conference ” .

接线

降落在后续切片. HUB-WIRING.md 是它创建的交接文档 和保持记录 赫德一方拥有的东西,包括它的唯一的东西 错误: 工具通过装入的工具到达代理 plugin.agentTools没有 通过枢纽侧 registerFeishuTools 导入. ../../../docs/features/channels/README.md 描述平台为已建.

版本与发布记录

@clisbot/channels-feishu 共发布 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-feishu 的常见问题

@clisbot/channels-feishu 是什么?

垂直回波Feishu/Lark信道(目标分类账切片15)。 由扩展/feishhu/src@5d8067a4483移植:Lark SDK客户端+租户-托肯管道,6个feishu-QQ代理工具家庭,WS长连接/webhook运输,发送+卡分块

如何安装 @clisbot/channels-feishu?

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

@clisbot/channels-feishu 支持 TypeScript 吗?

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

@clisbot/channels-feishu 支持 ESM 还是 CommonJS?

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

@clisbot/channels-feishu 可以商用吗?

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

@clisbot/channels-feishu 的下载量有多少?

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

@clisbot/channels-feishu 还在维护吗?

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