@hotwvpyym/openclaw-lark 2026.10.3 → 2026.10.4

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 +9 -7
  2. package/README.zh.md +9 -7
  3. package/openclaw.plugin.json +872 -897
  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 对齐验证）
27
+ ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3/10.4 对齐验证）
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 2026.10.3 **0 Breakages / 0 Warnings**。
44
+ - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.4 规范化消除）。
45
45
 
46
46
  ### 保留的官方全部功能
47
47
 
@@ -78,7 +78,8 @@
78
78
  | 2026.9.6 | 官方 tarball | typecheck 0 错误 ✅ |
79
79
  | 2026.9.7 | 官方 tarball + 生产服务器 | typecheck 0 错误 + 生产实测（footer 六项/消息收发/插件加载全过）✅ |
80
80
  | 2026.9.8 | 官方 tarball | typecheck 0 错误 ✅ |
81
- | **2026.10.3** | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
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** ✅ |
82
83
 
83
84
  **架构适配说明**：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite —— 插件对两种架构均做了兼容（SQLite 直读不可用时自动回退 SDK 读取），因此 2026.8.1 至最新版均可用。
84
85
 
@@ -96,12 +97,12 @@
96
97
  **方式 A：本地 tgz 安装（推荐，最可控）**
97
98
 
98
99
  ```bash
99
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.3.tgz --force --accept-capabilities
100
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.4.tgz --force --accept-capabilities
100
101
  ```
101
102
 
102
103
  **方式 B：从 GitHub Release 下载**
103
104
 
104
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.3.tgz`，然后按方式 A 安装。
105
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.4.tgz`，然后按方式 A 安装。
105
106
 
106
107
  **方式 C：ClawHub（发布后可用）**
107
108
 
@@ -112,7 +113,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
112
113
  安装完成后确认：
113
114
 
114
115
  ```bash
115
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.3
116
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.4
116
117
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
117
118
  ```
118
119
 
@@ -179,7 +180,8 @@ openclaw config set channels.feishu.footer.model true # 模型
179
180
 
180
181
  | 版本 | 内容 |
181
182
  |---|---|
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` 字段，clawhub validate 2026.10.3 达 0 Breakages / 0 Warnings；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
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 |
183
185
  | 2026.9.7 | 发布就绪版本：包名改为 `@hotwvpyym/openclaw-lark`（匹配 ClawHub 发布者 scope），补 `openclaw.build.openclawVersion`/`license` 字段；内容与 9.6.11 一致（日历 page_size 全量修复 + footer 指标 + 性能优化） |
184
186
  | 2026.9.6.11 | 日历等 13 文件 20 处 `page_size` 上下限全量补齐（按飞书文档），calendar 系列运行时钳制双保险；修复上一版注入产生的语法问题 |
185
187
  | 2026.9.6.10 | AbortController 生命周期管理；`not available` 日志降级 debug |
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 对齐验证）
25
+ ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3/10.4 对齐验证）
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 2026.10.3 **0 Breakages / 0 Warnings**。
42
+ - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.4 规范化消除）。
43
43
 
44
44
  ### 保留的官方全部功能
45
45
 
@@ -76,7 +76,8 @@
76
76
  | 2026.9.6 | 官方 tarball | typecheck 0 错误 ✅ |
77
77
  | 2026.9.7 | 官方 tarball + 生产服务器 | typecheck 0 错误 + 生产实测（footer 六项/消息收发/插件加载全过）✅ |
78
78
  | 2026.9.8 | 官方 tarball | typecheck 0 错误 ✅ |
79
- | **2026.10.3** | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
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** ✅ |
80
81
 
81
82
  **架构适配说明**：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite —— 插件对两种架构均做了兼容（SQLite 直读不可用时自动回退 SDK 读取），因此 2026.8.1 至最新版均可用。
82
83
 
@@ -94,12 +95,12 @@
94
95
  **方式 A：本地 tgz 安装（推荐，最可控）**
95
96
 
96
97
  ```bash
97
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.3.tgz --force --accept-capabilities
98
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.4.tgz --force --accept-capabilities
98
99
  ```
99
100
 
100
101
  **方式 B：从 GitHub Release 下载**
101
102
 
102
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.3.tgz`，然后按方式 A 安装。
103
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.4.tgz`，然后按方式 A 安装。
103
104
 
104
105
  **方式 C：ClawHub（发布后可用）**
105
106
 
@@ -110,7 +111,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
110
111
  安装完成后确认：
111
112
 
112
113
  ```bash
113
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.3
114
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.4
114
115
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
115
116
  ```
116
117
 
@@ -177,7 +178,8 @@ openclaw config set channels.feishu.footer.model true # 模型
177
178
 
178
179
  | 版本 | 内容 |
179
180
  |---|---|
180
- | **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` 字段，clawhub validate 2026.10.3 达 0 Breakages / 0 Warnings；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
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 |
181
183
  | 2026.9.7 | 发布就绪版本：包名改为 `@hotwvpyym/openclaw-lark`（匹配 ClawHub 发布者 scope），补 `openclaw.build.openclawVersion`/`license` 字段；内容与 9.6.11 一致（日历 page_size 全量修复 + footer 指标 + 性能优化） |
182
184
  | 2026.9.6.11 | 日历等 13 文件 20 处 `page_size` 上下限全量补齐（按飞书文档），calendar 系列运行时钳制双保险；修复上一版注入产生的语法问题 |
183
185
  | 2026.9.6.10 | AbortController 生命周期管理；`not available` 日志降级 debug |