Skip to content

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

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

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions