openclaw - 💡(How to fix) Fix [Feishu] message --action send --filePath fails to send file attachments, returns link instead of actual file [4 comments, 4 participants]

name: 🐛 Bug Report about: Create a report to help us improve title: "[Feishu] message --action send --filePath fails to send file attachments, returns link instead of actual file" labels: bug, channel:feishu

📋 Description

When using the message tool to send file attachments via Feishu (Lark) channel, the recipient receives a link like http://filename.md/ instead of an actual file attachment, making it impossible to view the file content.

🔍 Reproduction Steps

1. Configure Feishu channel and start Gateway
2. Send a file using message tool in a Feishu chat:

   message --action send --channel feishu --filePath /absolute/path/to/file.md --message "Test file"

3. Recipient receives: 📎 [filename.md](http://filename.md/) - Test file
4. Clicking the link fails (invalid URL)

✅ Expected Behavior

Recipient should receive an actual file attachment (.md file) that can be downloaded and opened, not an invalid link.

🔍 Root Cause Analysis

Location: extensions/feishu/src/channel.ts - handleAction function, send branch (around line 431)

Current Code:

if (ctx.action === "send" || ctx.action === "thread-reply") {
  const card = ctx.params.card && typeof ctx.params.card === "object" ? ... : undefined;
  const text = readFirstString(ctx.params, ["text", "message"]);
  if (!card && !text) {
    throw new Error(`Feishu ${ctx.action} requires text/message or card.`);
  }
  // ❌ Does not check media/filePath parameters
  const result = card
    ? await runtime.sendCardFeishu({...})
    : await runtime.sendMessageFeishu({...}); // Only sends text
}

Problem: The handleAction function only handles text/message and card parameters, but ignores media/filePath/path parameters.

Suggested Fix:

// Add mediaUrl detection
const mediaUrl = readFirstString(ctx.params, ["media", "filePath", "path"]) ?? undefined;

if (mediaUrl) {
  // Call sendMediaFeishu to handle file upload and send
  const result = await runtime.sendMediaFeishu({
    cfg: ctx.cfg,
    to,
    mediaUrl,
    accountId: ctx.accountId ?? undefined,
    replyToMessageId,
  });
  return jsonActionResult({...});
}

📊 Environment

• OpenClaw Version: 2026.3.14
• Node Version: v24.14.0
• OS: macOS 25.3.0 (arm64)
• Channel: Feishu (Lark)
• Config: Single account, default configuration

🔄 Workaround

Currently unable to send file attachments via message tool to Feishu. Workarounds:

1. Manually copy and paste file content
2. Use Feishu desktop client to send files manually

📝 Additional Context

This issue affects all scenarios requiring file attachments via Feishu channel:

• Sending documents (.md, .txt, .pdf, etc.)
• Sending code files
• Sending any type of attachment

Would appreciate an official fix. Thanks! 🙏