Bug type

Behavior bug (incorrect output/state without crash)

Summary

在 Feishu（飞书）通道使用 message 工具发送纯媒体消息（图片/文件/音频）时，会触发 schema 验证错误：

Validation failed for tool "message":
  - card: must have required property 'card'

Steps to reproduce

1. 配置好 Feishu 通道，确保 app 有发送消息权限
2. 调用 message 工具发送图片/文件，不提供 card 参数：

{
  "name": "message",
  "parameters": {
    "action": "send",
    "channel": "feishu",
    "media": "/tmp/test.jpg",
    "caption": "测试图片"
  }
}

1. 验证错误在 schema 阶段就被拦截，没有到达 Feishu handler 逻辑

Expected behavior

根据 Feishu 通道 handler 的业务逻辑，send 动作支持三种互斥的消息类型，不需要同时提供：

1. card：交互式卡片消息
2. media：媒体文件消息
3. text：纯文本消息

发送纯媒体消息时不应该要求提供 card 字段。

Actual behavior

schema 验证直接失败，错误信息：

Validation failed for tool "message":
  - card: must have required property 'card'

OpenClaw version

OpenClaw 版本：2026.3.23-1 / 2026.3.23-2

Operating system

Ubuntu 24.04 WSL2 / macOS 均复现Node.js 版本：22.16.0

Install method

npm全局

Model

minimax-2.7

Provider / routing chain

WSL2 localhost (127.0.0.1:7890) → Windows Clash → open.feishu.cn

Additional provider/model setup details

No response

Logs, screenshots, and evidence

错误信息：
Validation failed for tool "message":
  - card: must have required property 'card'
触发调用：
{
  "action": "send",
  "channel": "feishu",
  "media": "/tmp/test.jpg",
  "caption": "test"
}
完整错误堆栈位置：
OpenClaw dist/channel-D60N8mHW.js
  → describeFeishuMessageTool() 返回的 schema
  → mergeToolSchemaProperties() 合并到全局 schema
  → Zod 验证时报错

Impact and severity

影响范围：所有使用 Feishu 通道的用户 功能缺失：无法通过 message 工具发送图片/文件/音频 严重程度：Medium（功能损坏，但有临时绕过方案） 证据：

1. schema 验证层拦截，不到达 handler
2. 临时绕过方案可行（直接调 API），说明飞书 API 本身正常
3. 工具层 schema 和 handler 逻辑不一致

Additional information

根因分析

位于 /usr/local/lib/node_modules/openclaw/dist/channel-D60N8mHW.js 中的 describeFeishuMessageTool() 函数返回的 schema 中，card 字段没有被标记为 Optional，在 schema 合并时被判定为必填字段，和 handler 逻辑冲突：

// 目前错误的 schema
schema: enabled ? { properties: { card: createMessageToolCardSchema() } } : null

// Feishu handler 正确的逻辑
if (card && mediaUrl) throw new Error(`Feishu ${ctx.action} does not support card with media.`);
if (!card && !text && !mediaUrl) throw new Error(`Feishu ${ctx.action} requires text/message, media, or card.`);

临时解决办法

1. 本地补丁：修改 dist 文件，显式标记 card 为 Optional：

// 第 345 行和第 366 行修改为
schema: enabled ? { properties: { card: Type.Optional(createMessageToolCardSchema()) }, required: [] } : null

⚠️ 此补丁在 npm update 后会被覆盖。

1. 绕过方案：不使用 OpenClaw message 工具，直接调用 Feishu 原生 API 发送媒体消息：
   • POST /open-apis/auth/v3/tenant_access_token/internal 获取 access_token
   • POST /open-apis/im/v1/files 上传媒体获取 file_key
   • POST /open-apis/im/v1/messages 发送 msg_type=file/image 消息

建议修复方案

修改 describeFeishuMessageTool() 返回的 schema，显式将 card 字段标记为 Optional，和 handler 逻辑保持一致。