@hotwvpyym/openclaw-lark 2026.10.5 → 2026.10.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +11 -30
  2. package/README.zh.md +11 -30
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -24,7 +24,7 @@
24
24
  | 与新版 OpenClaw 不兼容 | 官方 2026.7.16 版无法安装/正常运行在 OpenClaw **2026.9.x 及以上**（插件 SDK API 已变化）；**2026.10.x 起官方移除了 `openclaw/plugin-sdk/command-auth` 子路径**，官方 7.16 的静态 import 会在插件注册前加载失败 |
25
25
  | 官方新线门槛更高 | 官方替代插件 `@openclaw/feishu` 要求 OpenClaw **≥2026.9.8**，无法用于 9.7 及以下版本，且该插件**不提供卡片用量页脚（footer metrics）** |
26
26
 
27
- ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3/10.4 对齐验证）
27
+ ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3 对齐验证）
28
28
 
29
29
  1. **卡片页脚指标缺失**：官方版升级到 9.7 后，卡片页脚只剩「状态 + 耗时」，`tokens / cache / context / model` 四项全部丢失。
30
30
  - 根因：OpenClaw 2026.9.7 起会话存储从 `sessions.json` 改为 **per-agent SQLite**（`<stateDir>/agents/<agentId>/agent/openclaw-agent.sqlite`），footer 渲染时的 agent 归属解析抛出 `AgentSelectionRequiredError`，被外层 `catch` 静默吞掉，导致页脚渲染中止。
@@ -41,7 +41,7 @@
41
41
  - **授权一致性回归**：3840 组参数对比 legacy vs ingress，3560 组一致（92.7%），280 组差异全部为官方 10.x 有意收紧（更严格、更安全，无反向风险）；同时修复空 sender + 通配 allowlist 的越权缺口（详见 `reports/auth-consistency/REPORT.md`）。
42
42
  5. **manifest configSchema 修复（OpenClaw 10.x 配置校验收严）**：OpenClaw 10.x 起基于插件 manifest 的 `configSchema` **严格校验**渠道配置；旧版 manifest 该字段为空，导致 `channels.feishu.footer`（页脚六项开关）等全部合法配置被拒绝（报 `must not have additional properties`），openclaw 升级后插件配置直接 invalid。
43
43
  - 修复：将源码 `FEISHU_CONFIG_JSON_SCHEMA`（zod 自动生成）完整同步进 manifest `configSchema`，共 **41 个字段**（footer 六项 / dmPolicy / replyMode / heartbeat / dedup / accounts 等）；
44
- - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.4 规范化消除）。
44
+ - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.5 规范化消除）。
45
45
 
46
46
  ### 保留的官方全部功能
47
47
 
@@ -67,22 +67,11 @@
67
67
 
68
68
  ## 二、兼容版本（Compatibility）
69
69
 
70
- **声明：兼容 OpenClaw 2026.8.1 及以上所有版本。**
70
+ 兼容 OpenClaw **2026.8.1 及以上所有稳定版**（当前最新验证版本：2026.10.3；仅维护稳定版，beta 不在支持范围）。
71
71
 
72
- 以下版本已实测验证（替换 node_modules/openclaw 软链逐一跑 typecheck，全部 0 错误；9.7 为生产环境实测）：
72
+ 已实测：`2026.8.1 / 2026.8.35 / 2026.9.6 / 2026.9.7（生产实测）/ 2026.9.8 / 2026.10.3`——typecheck 全 0 错误，9.7 另经生产服务器全功能实测（footer 六项/消息收发/插件加载全过）。
73
73
 
74
- | OpenClaw 版本 | 类型 | 验证结果 |
75
- |---|---|---|
76
- | 2026.8.1 | 官方 tarball | typecheck 0 错误 ✅ |
77
- | 2026.8.35 | 官方 tarball（extended-stable） | typecheck 0 错误 ✅ |
78
- | 2026.9.6 | 官方 tarball | typecheck 0 错误 ✅ |
79
- | 2026.9.7 | 官方 tarball + 生产服务器 | typecheck 0 错误 + 生产实测（footer 六项/消息收发/插件加载全过）✅ |
80
- | 2026.9.8 | 官方 tarball | typecheck 0 错误 ✅ |
81
- | **2026.10.5** | 官方 npm（latest 稳定版） | 移除 manifest `contracts` 字段（平台契约白名单不含 feishu 工具名，按平台指引删除），ClawHub 平台扫描 warning 归零；运行时与 10.3/10.4 完全一致 ✅ |
82
- | **2026.10.4** | 官方 npm（latest 稳定版） | 与 10.3 运行时完全一致；manifest `contracts` 对齐平台契约白名单（14 key，官方内置命名），ClawHub 平台扫描 warning 归零 ✅ |
83
- | 2026.10.3 | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
84
-
85
- **架构适配说明**：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite —— 插件对两种架构均做了兼容（SQLite 直读不可用时自动回退 SDK 读取），因此 2026.8.1 至最新版均可用。
74
+ 架构说明：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite——插件对两种架构均兼容（SQLite 直读不可用时自动回退 SDK 读取）。
86
75
 
87
76
  ---
88
77
 
@@ -98,12 +87,12 @@
98
87
  **方式 A：本地 tgz 安装（推荐，最可控）**
99
88
 
100
89
  ```bash
101
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.5.tgz --force --accept-capabilities
90
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.6.tgz --force --accept-capabilities
102
91
  ```
103
92
 
104
93
  **方式 B：从 GitHub Release 下载**
105
94
 
106
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.5.tgz`，然后按方式 A 安装。
95
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.6.tgz`，然后按方式 A 安装。
107
96
 
108
97
  **方式 C：ClawHub（发布后可用）**
109
98
 
@@ -114,7 +103,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
114
103
  安装完成后确认：
115
104
 
116
105
  ```bash
117
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.5
106
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.6
118
107
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
119
108
  ```
120
109
 
@@ -179,17 +168,9 @@ openclaw config set channels.feishu.footer.model true # 模型
179
168
 
180
169
  ## 六、版本历史（Changelog）
181
170
 
182
- | 版本 | 内容 |
183
- |---|---|
184
- | **2026.10.5**（当前，正式发布版） | **元数据规范化（移除 contracts 字段，ClawHub 扫描归零）**。为什么 10.3→10.4→10.5 间隔这么短：10.3 发布后 ClawHub **提交后安全扫描**检出 `manifest-unknown-contracts`（P1）。10.4 将 `contracts.tools` 的 39 个官方 7.16 遗留 key 对齐为官方内置 @openclaw/feishu 的 14 个能力域级 key，**但平台扫描仍报同一告警**——实证表明官方内置插件的工具名（feishu_*）不在 ClawHub 平台契约白名单（内置插件不经过 ClawHub 扫描注册）。本版按平台指引（"Remove unsupported contract keys or move them to a documented OpenClaw contract field"）**直接移除 `contracts` 字段**。**影响说明**：`contracts` 是静态能力所有权元数据，仅用于 tool discovery 优化；移除后插件运行时功能、39 个飞书工具、OpenClaw 8.1–10.3 兼容性、footer/configSchema/授权一致性**全部不变**（官方文档：无 toolMetadata 时工具按 tool contract 与 policy 正常加载）。三渠道同源重新发布（npm / GitHub Release v2026.10.5 / ClawHub 2026.10.5） |
185
- | 2026.10.4（正式发布版） | 元数据规范化第一步：`contracts.tools` 39 个官方 7.16 遗留 key → 官方内置 @openclaw/feishu 14 个能力域级 key；发布后平台扫描仍报 `manifest-unknown-contracts`（官方内置 key 不在 ClawHub 白名单），故由 10.5 彻底移除 |
186
- | 2026.10.3（正式发布版） | 对齐 OpenClaw 2026.10.3 稳定版（npm latest）：新增 `command-auth-compat` 双路径兼容层（9.x legacy / 10.x channel-ingress-runtime），修复官方 10.x 移除 command-auth 子路径后的加载失败；manifest 补 `name` 字段；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
187
- | 2026.9.7 | 发布就绪版本：包名改为 `@hotwvpyym/openclaw-lark`（匹配 ClawHub 发布者 scope），补 `openclaw.build.openclawVersion`/`license` 字段；内容与 9.6.11 一致（日历 page_size 全量修复 + footer 指标 + 性能优化） |
188
- | 2026.9.6.11 | 日历等 13 文件 20 处 `page_size` 上下限全量补齐（按飞书文档），calendar 系列运行时钳制双保险；修复上一版注入产生的语法问题 |
189
- | 2026.9.6.10 | AbortController 生命周期管理；`not available` 日志降级 debug |
190
- | 2026.9.6.9 | 会话快照探测削峰（720→≤60 次/轮）；4 处高频日志降噪 |
191
- | 2026.9.6.8 | **核心修复**：卡片页脚 tokens/cache/context/model 恢复（agent 归属解析兜底） |
192
- | 2026.9.6.x 前序 | 加载/收发/流式适配（对齐官方 9.6 基线） |
171
+ 每个版本的详细更新说明（修复内容、发布原因、权威包 sha256）请查看 [GitHub Releases](https://github.com/hotwvpyym/openclaw-lark-compat/releases)。
172
+
173
+ 当前版本：**2026.10.6**（兼容 OpenClaw 2026.8.1 – 10.3 stable；三渠道同源发布：npm / GitHub Release / ClawHub，包内容逐字节一致）。
193
174
 
194
175
  ---
195
176
 
package/README.zh.md CHANGED
@@ -22,7 +22,7 @@
22
22
  | 与新版 OpenClaw 不兼容 | 官方 2026.7.16 版无法安装/正常运行在 OpenClaw **2026.9.x 及以上**（插件 SDK API 已变化）；**2026.10.x 起官方移除了 `openclaw/plugin-sdk/command-auth` 子路径**，官方 7.16 的静态 import 会在插件注册前加载失败 |
23
23
  | 官方新线门槛更高 | 官方替代插件 `@openclaw/feishu` 要求 OpenClaw **≥2026.9.8**，无法用于 9.7 及以下版本，且该插件**不提供卡片用量页脚（footer metrics）** |
24
24
 
25
- ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3/10.4 对齐验证）
25
+ ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3 对齐验证）
26
26
 
27
27
  1. **卡片页脚指标缺失**：官方版升级到 9.7 后，卡片页脚只剩「状态 + 耗时」，`tokens / cache / context / model` 四项全部丢失。
28
28
  - 根因：OpenClaw 2026.9.7 起会话存储从 `sessions.json` 改为 **per-agent SQLite**（`<stateDir>/agents/<agentId>/agent/openclaw-agent.sqlite`），footer 渲染时的 agent 归属解析抛出 `AgentSelectionRequiredError`，被外层 `catch` 静默吞掉，导致页脚渲染中止。
@@ -39,7 +39,7 @@
39
39
  - **授权一致性回归**：3840 组参数对比 legacy vs ingress，3560 组一致（92.7%），280 组差异全部为官方 10.x 有意收紧（更严格、更安全，无反向风险）；同时修复空 sender + 通配 allowlist 的越权缺口（详见 `reports/auth-consistency/REPORT.md`）。
40
40
  5. **manifest configSchema 修复（OpenClaw 10.x 配置校验收严）**：OpenClaw 10.x 起基于插件 manifest 的 `configSchema` **严格校验**渠道配置；旧版 manifest 该字段为空，导致 `channels.feishu.footer`（页脚六项开关）等全部合法配置被拒绝（报 `must not have additional properties`），openclaw 升级后插件配置直接 invalid。
41
41
  - 修复：将源码 `FEISHU_CONFIG_JSON_SCHEMA`（zod 自动生成）完整同步进 manifest `configSchema`，共 **41 个字段**（footer 六项 / dmPolicy / replyMode / heartbeat / dedup / accounts 等）；
42
- - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.4 规范化消除）。
42
+ - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.5 规范化消除）。
43
43
 
44
44
  ### 保留的官方全部功能
45
45
 
@@ -65,22 +65,11 @@
65
65
 
66
66
  ## 二、兼容版本（Compatibility）
67
67
 
68
- **声明：兼容 OpenClaw 2026.8.1 及以上所有版本。**
68
+ 兼容 OpenClaw **2026.8.1 及以上所有稳定版**（当前最新验证版本：2026.10.3；仅维护稳定版，beta 不在支持范围）。
69
69
 
70
- 以下版本已实测验证（替换 node_modules/openclaw 软链逐一跑 typecheck，全部 0 错误；9.7 为生产环境实测）：
70
+ 已实测：`2026.8.1 / 2026.8.35 / 2026.9.6 / 2026.9.7（生产实测）/ 2026.9.8 / 2026.10.3`——typecheck 全 0 错误，9.7 另经生产服务器全功能实测（footer 六项/消息收发/插件加载全过）。
71
71
 
72
- | OpenClaw 版本 | 类型 | 验证结果 |
73
- |---|---|---|
74
- | 2026.8.1 | 官方 tarball | typecheck 0 错误 ✅ |
75
- | 2026.8.35 | 官方 tarball（extended-stable） | typecheck 0 错误 ✅ |
76
- | 2026.9.6 | 官方 tarball | typecheck 0 错误 ✅ |
77
- | 2026.9.7 | 官方 tarball + 生产服务器 | typecheck 0 错误 + 生产实测（footer 六项/消息收发/插件加载全过）✅ |
78
- | 2026.9.8 | 官方 tarball | typecheck 0 错误 ✅ |
79
- | **2026.10.5** | 官方 npm（latest 稳定版） | 移除 manifest `contracts` 字段（平台契约白名单不含 feishu 工具名，按平台指引删除），ClawHub 平台扫描 warning 归零；运行时与 10.3/10.4 完全一致 ✅ |
80
- | **2026.10.4** | 官方 npm（latest 稳定版） | 与 10.3 运行时完全一致；manifest `contracts` 对齐平台契约白名单（14 key，官方内置命名），ClawHub 平台扫描 warning 归零 ✅ |
81
- | 2026.10.3 | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
82
-
83
- **架构适配说明**：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite —— 插件对两种架构均做了兼容（SQLite 直读不可用时自动回退 SDK 读取），因此 2026.8.1 至最新版均可用。
72
+ 架构说明：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite——插件对两种架构均兼容（SQLite 直读不可用时自动回退 SDK 读取）。
84
73
 
85
74
  ---
86
75
 
@@ -96,12 +85,12 @@
96
85
  **方式 A：本地 tgz 安装（推荐，最可控）**
97
86
 
98
87
  ```bash
99
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.5.tgz --force --accept-capabilities
88
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.6.tgz --force --accept-capabilities
100
89
  ```
101
90
 
102
91
  **方式 B：从 GitHub Release 下载**
103
92
 
104
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.5.tgz`，然后按方式 A 安装。
93
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.6.tgz`，然后按方式 A 安装。
105
94
 
106
95
  **方式 C：ClawHub（发布后可用）**
107
96
 
@@ -112,7 +101,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
112
101
  安装完成后确认：
113
102
 
114
103
  ```bash
115
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.5
104
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.6
116
105
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
117
106
  ```
118
107
 
@@ -177,17 +166,9 @@ openclaw config set channels.feishu.footer.model true # 模型
177
166
 
178
167
  ## 六、版本历史（Changelog）
179
168
 
180
- | 版本 | 内容 |
181
- |---|---|
182
- | **2026.10.5**（当前，正式发布版） | **元数据规范化（移除 contracts 字段，ClawHub 扫描归零）**。为什么 10.3→10.4→10.5 间隔这么短：10.3 发布后 ClawHub **提交后安全扫描**检出 `manifest-unknown-contracts`（P1）。10.4 将 `contracts.tools` 的 39 个官方 7.16 遗留 key 对齐为官方内置 @openclaw/feishu 的 14 个能力域级 key，**但平台扫描仍报同一告警**——实证表明官方内置插件的工具名（feishu_*）不在 ClawHub 平台契约白名单（内置插件不经过 ClawHub 扫描注册）。本版按平台指引（"Remove unsupported contract keys or move them to a documented OpenClaw contract field"）**直接移除 `contracts` 字段**。**影响说明**：`contracts` 是静态能力所有权元数据，仅用于 tool discovery 优化；移除后插件运行时功能、39 个飞书工具、OpenClaw 8.1–10.3 兼容性、footer/configSchema/授权一致性**全部不变**（官方文档：无 toolMetadata 时工具按 tool contract 与 policy 正常加载）。三渠道同源重新发布（npm / GitHub Release v2026.10.5 / ClawHub 2026.10.5） |
183
- | 2026.10.4（正式发布版） | 元数据规范化第一步：`contracts.tools` 39 个官方 7.16 遗留 key → 官方内置 @openclaw/feishu 14 个能力域级 key；发布后平台扫描仍报 `manifest-unknown-contracts`（官方内置 key 不在 ClawHub 白名单），故由 10.5 彻底移除 |
184
- | 2026.10.3（正式发布版） | 对齐 OpenClaw 2026.10.3 稳定版（npm latest）：新增 `command-auth-compat` 双路径兼容层（9.x legacy / 10.x channel-ingress-runtime），修复官方 10.x 移除 command-auth 子路径后的加载失败；manifest 补 `name` 字段；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
185
- | 2026.9.7 | 发布就绪版本：包名改为 `@hotwvpyym/openclaw-lark`（匹配 ClawHub 发布者 scope），补 `openclaw.build.openclawVersion`/`license` 字段；内容与 9.6.11 一致（日历 page_size 全量修复 + footer 指标 + 性能优化） |
186
- | 2026.9.6.11 | 日历等 13 文件 20 处 `page_size` 上下限全量补齐（按飞书文档），calendar 系列运行时钳制双保险；修复上一版注入产生的语法问题 |
187
- | 2026.9.6.10 | AbortController 生命周期管理；`not available` 日志降级 debug |
188
- | 2026.9.6.9 | 会话快照探测削峰（720→≤60 次/轮）；4 处高频日志降噪 |
189
- | 2026.9.6.8 | **核心修复**：卡片页脚 tokens/cache/context/model 恢复（agent 归属解析兜底） |
190
- | 2026.9.6.x 前序 | 加载/收发/流式适配（对齐官方 9.6 基线） |
169
+ 每个版本的详细更新说明（修复内容、发布原因、权威包 sha256）请查看 [GitHub Releases](https://github.com/hotwvpyym/openclaw-lark-compat/releases)。
170
+
171
+ 当前版本：**2026.10.6**（兼容 OpenClaw 2026.8.1 – 10.3 stable；三渠道同源发布：npm / GitHub Release / ClawHub，包内容逐字节一致）。
191
172
 
192
173
  ---
193
174
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hotwvpyym/openclaw-lark",
3
- "version": "2026.10.5",
3
+ "version": "2026.10.6",
4
4
  "description": "OpenClaw Lark/Feishu channel plugin",
5
5
  "type": "module",
6
6
  "exports": {
@@ -100,7 +100,7 @@
100
100
  "pluginApi": ">=2026.8.1"
101
101
  },
102
102
  "build": {
103
- "openclawVersion": "2026.10.5"
103
+ "openclawVersion": "2026.10.6"
104
104
  }
105
105
  },
106
106
  "license": "MIT"