@hotwvpyym/openclaw-lark 2026.10.4 → 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 (4) hide show
  1. package/README.md +11 -28
  2. package/README.zh.md +11 -28
  3. package/openclaw.plugin.json +0 -18
  4. 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,21 +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.4** | 官方 npm（latest 稳定版） | 与 10.3 运行时完全一致；manifest `contracts` 对齐平台契约白名单（14 key，官方内置命名），ClawHub 平台扫描 warning 归零 ✅ |
82
- | 2026.10.3 | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
83
-
84
- **架构适配说明**：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 读取）。
85
75
 
86
76
  ---
87
77
 
@@ -97,12 +87,12 @@
97
87
  **方式 A：本地 tgz 安装（推荐，最可控）**
98
88
 
99
89
  ```bash
100
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.4.tgz --force --accept-capabilities
90
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.6.tgz --force --accept-capabilities
101
91
  ```
102
92
 
103
93
  **方式 B：从 GitHub Release 下载**
104
94
 
105
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.4.tgz`，然后按方式 A 安装。
95
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.6.tgz`，然后按方式 A 安装。
106
96
 
107
97
  **方式 C：ClawHub（发布后可用）**
108
98
 
@@ -113,7 +103,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
113
103
  安装完成后确认：
114
104
 
115
105
  ```bash
116
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.4
106
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.6
117
107
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
118
108
  ```
119
109
 
@@ -178,16 +168,9 @@ openclaw config set channels.feishu.footer.model true # 模型
178
168
 
179
169
  ## 六、版本历史（Changelog）
180
170
 
181
- | 版本 | 内容 |
182
- |---|---|
183
- | **2026.10.4**（当前，正式发布版） | **元数据规范化（contracts 对齐平台契约白名单）**。为什么距 10.3 仅一天就发 10.4：10.3 在 ClawHub **提交后安全扫描**阶段被平台检出 `manifest-unknown-contracts`（P1）——manifest `contracts.tools` 声明的 39 个 key 与平台契约白名单不一致。这些 key 源自官方 @larksuite/openclaw-lark 2026.7.16 的**遗留命名**（官方内置 @openclaw/feishu 早已迁移为 14 个能力域级 key）。本版将 contracts 对齐为官方内置 14 key。**影响说明**：这是**纯元数据规范化**——插件运行时功能、39 个飞书工具、OpenClaw 8.1–10.3 兼容性、footer/configSchema/授权一致性**全部不变**；ClawHub 平台扫描 warning 归零。三渠道同源重新发布（npm / GitHub Release v2026.10.4 / ClawHub 2026.10.4） |
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 基线） |
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，包内容逐字节一致）。
191
174
 
192
175
  ---
193
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,21 +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.4** | 官方 npm（latest 稳定版） | 与 10.3 运行时完全一致；manifest `contracts` 对齐平台契约白名单（14 key，官方内置命名），ClawHub 平台扫描 warning 归零 ✅ |
80
- | 2026.10.3 | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
81
-
82
- **架构适配说明**：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 读取）。
83
73
 
84
74
  ---
85
75
 
@@ -95,12 +85,12 @@
95
85
  **方式 A：本地 tgz 安装（推荐，最可控）**
96
86
 
97
87
  ```bash
98
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.4.tgz --force --accept-capabilities
88
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.6.tgz --force --accept-capabilities
99
89
  ```
100
90
 
101
91
  **方式 B：从 GitHub Release 下载**
102
92
 
103
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.4.tgz`，然后按方式 A 安装。
93
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.6.tgz`，然后按方式 A 安装。
104
94
 
105
95
  **方式 C：ClawHub（发布后可用）**
106
96
 
@@ -111,7 +101,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
111
101
  安装完成后确认：
112
102
 
113
103
  ```bash
114
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.4
104
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.6
115
105
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
116
106
  ```
117
107
 
@@ -176,16 +166,9 @@ openclaw config set channels.feishu.footer.model true # 模型
176
166
 
177
167
  ## 六、版本历史（Changelog）
178
168
 
179
- | 版本 | 内容 |
180
- |---|---|
181
- | **2026.10.4**（当前，正式发布版） | **元数据规范化（contracts 对齐平台契约白名单）**。为什么距 10.3 仅一天就发 10.4：10.3 在 ClawHub **提交后安全扫描**阶段被平台检出 `manifest-unknown-contracts`（P1）——manifest `contracts.tools` 声明的 39 个 key 与平台契约白名单不一致。这些 key 源自官方 @larksuite/openclaw-lark 2026.7.16 的**遗留命名**（官方内置 @openclaw/feishu 早已迁移为 14 个能力域级 key）。本版将 contracts 对齐为官方内置 14 key。**影响说明**：这是**纯元数据规范化**——插件运行时功能、39 个飞书工具、OpenClaw 8.1–10.3 兼容性、footer/configSchema/授权一致性**全部不变**；ClawHub 平台扫描 warning 归零。三渠道同源重新发布（npm / GitHub Release v2026.10.4 / ClawHub 2026.10.4） |
182
- | 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 |
183
- | 2026.9.7 | 发布就绪版本：包名改为 `@hotwvpyym/openclaw-lark`（匹配 ClawHub 发布者 scope），补 `openclaw.build.openclawVersion`/`license` 字段；内容与 9.6.11 一致（日历 page_size 全量修复 + footer 指标 + 性能优化） |
184
- | 2026.9.6.11 | 日历等 13 文件 20 处 `page_size` 上下限全量补齐（按飞书文档），calendar 系列运行时钳制双保险；修复上一版注入产生的语法问题 |
185
- | 2026.9.6.10 | AbortController 生命周期管理；`not available` 日志降级 debug |
186
- | 2026.9.6.9 | 会话快照探测削峰（720→≤60 次/轮）；4 处高频日志降噪 |
187
- | 2026.9.6.8 | **核心修复**：卡片页脚 tokens/cache/context/model 恢复（agent 归属解析兜底） |
188
- | 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，包内容逐字节一致）。
189
172
 
190
173
  ---
191
174
 
package/openclaw.plugin.json CHANGED
@@ -954,24 +954,6 @@
954
954
  }
955
955
  }
956
956
  },
957
- "contracts": {
958
- "tools": [
959
- "feishu_app_scopes",
960
- "feishu_bitable_create_app",
961
- "feishu_bitable_create_field",
962
- "feishu_bitable_create_record",
963
- "feishu_bitable_get_meta",
964
- "feishu_bitable_get_record",
965
- "feishu_bitable_list_fields",
966
- "feishu_bitable_list_records",
967
- "feishu_bitable_update_record",
968
- "feishu_chat",
969
- "feishu_doc",
970
- "feishu_drive",
971
- "feishu_perm",
972
- "feishu_wiki"
973
- ]
974
- },
975
957
  "channelConfigs": {
976
958
  "feishu": {
977
959
  "schema": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hotwvpyym/openclaw-lark",
3
- "version": "2026.10.4",
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.4"
103
+ "openclawVersion": "2026.10.6"
104
104
  }
105
105
  },
106
106
  "license": "MIT"