# @clisbot/channels-feishu 中文文档

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

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

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

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

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

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

## 中文简介

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

## 安装

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

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

## README

# @clisbot/channels-feishu (英语)

(目标分类账分片15) `extensions/feishu/src` 在 OpenClaw 时 `5d8067a4483`69个文件为字节-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`)),其他每个家庭都在.

## 测试

```bash
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_ID` | `oc_…` 组聊天 机器人是 |
| `FEISHU_TEST_DM_OPEN_ID` | `ou_…` 开出ID,供德国马克往返 |
| `FEISHU_DOMAIN` | `feishu` (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 是什么？

垂直回波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 和提交记录判断。