Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix [Bug]: message tool schema: 'card' required param conflicts with media/filePath on Feishu [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#54312•Fetched 2026-04-08 01:29:11
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
MoreYogurtMoreYogurt
Participants
MoreYogurtMoreYogurt

Error Message

When using the message tool with action=send to send an image or file on Feishu, the tool schema requires the card parameter (marked as required). However, Feishu send does not support card combined with media, resulting in the error:

Fix Action

Workaround

Use CLI instead: openclaw message send --channel feishu --target "..." --media /path/to/file

Code Example

Feishu send does not support card with media.

---

openclaw message send --channel feishu --target "user:ou_xxx" --media /path/to/image.png
RAW_BUFFERClick to expand / collapse

Bug Description

When using the message tool with action=send to send an image or file on Feishu, the tool schema requires the card parameter (marked as required). However, Feishu send does not support card combined with media, resulting in the error:

Feishu send does not support card with media.

This makes it impossible to send images/files via the message tool on Feishu. The only workaround is using the CLI:

openclaw message send --channel feishu --target "user:ou_xxx" --media /path/to/image.png

Expected Behavior

The card parameter should be optional (not required) when media or filePath is provided, allowing agents to send media files directly via the message tool without resorting to CLI.

Steps to Reproduce

  1. Use the message tool with action=send, media=/path/to/image.png on a Feishu channel
  2. The card param is required by schema, so you must include it
  3. Including card with media triggers: "Feishu send does not support card with media."

Environment

  • OpenClaw version: latest
  • Channel: Feishu
  • OS: macOS (arm64)

Workaround

Use CLI instead: openclaw message send --channel feishu --target "..." --media /path/to/file

extent analysis

Fix Plan

To fix this issue, we need to make the card parameter optional when media or filePath is provided. Here are the steps:

  • Update the message tool schema to make card optional when media or filePath is present.
  • Modify the Feishu send logic to handle cases where card is not provided with media or filePath.

Example Code

# Updated schema
if 'media' in params or 'filePath' in params:
    schema['card']['required'] = False

# Updated Feishu send logic
if channel == 'feishu' and ('media' in params or 'filePath' in params):
    if 'card' in params:
        # Handle error: Feishu send does not support card with media
        raise ValueError("Feishu send does not support card with media.")
    else:
        # Send media/file without card
        send_media(params)

Verification

To verify the fix, try sending an image/file via the message tool on Feishu without including the card parameter. The tool should successfully send the media/file without throwing an error.

Extra Tips

  • Make sure to update the documentation to reflect the changed schema and behavior.
  • Test the fix thoroughly to ensure it works as expected in different scenarios.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#ssr#installation#API versioning#request timeout

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix [Bug]: message tool schema: 'card' required param conflicts with media/filePath on Feishu [1 participants]