Skip to content

message tool: filePath media upload fails with 'Channel is unavailable: telegram' in 2026.3.23-2 #53879

@cypressone-cypresstech

Description

@cypressone-cypresstech

Bug Report

Version: OpenClaw 2026.3.23-2 (7ffe7e4)
Channel: Telegram
OS: Linux (Fedora 43, x64)

Description

The message tool with filePath parameter fails to send media (PDFs, images) via Telegram. Text-only messages work fine. This is a regression — media sending worked in 2026.3.22.

Steps to Reproduce

  1. Use the message tool with action: send, target: <chat_id>, filePath: /path/to/file.pdf
  2. Error: Channel is unavailable: telegram

Expected Behavior

File should be uploaded and sent as a Telegram document.

Actual Behavior

Error: Channel is unavailable: telegram

Workaround

Direct Telegram Bot API calls via curl work perfectly:

curl -X POST 'https://api.telegram.org/bot<token>/sendDocument' \
  -F chat_id=<id> \
  -F document=@/path/to/file.pdf

This confirms the Telegram API and bot token are fine — the bug is in OpenClaw's message tool pipeline.

Additional Context

  • Text-only messages via message tool work (with buttons: [[]])
  • The buttons parameter appears to be newly required in 2026.3.23-2
  • Tested with multiple file sizes (87KB logo, 4.3MB PDF) — all fail
  • openclaw status shows Telegram channel as OK/enabled

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions