Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix Bug: Telegram plugin fails to load after reinstall/rollback because grammY dependencies are missing [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#59279•Fetched 2026-04-08 02:26:29
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Author
fonhalfonhal
Participants
fonhalfonhal
Timeline (top)
subscribed ×1

Telegram cannot start because the plugin fails to load at startup due to missing grammY-related runtime dependencies.

This is not a Telegram token / webhook / network issue. The failure happens during module loading before the Telegram runtime can start.

Error Message

[plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module 'grammy'

Root Cause

Telegram cannot start because the plugin fails to load at startup due to missing grammY-related runtime dependencies.

Code Example

[plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module 'grammy'

---

[plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module '@grammyjs/runner'
RAW_BUFFERClick to expand / collapse

Summary

Telegram cannot start because the plugin fails to load at startup due to missing grammY-related runtime dependencies.

This is not a Telegram token / webhook / network issue. The failure happens during module loading before the Telegram runtime can start.

Version

Observed on OpenClaw 2026.4.1. I also reinstalled and then rolled back, but the problem still persists.

Environment

  • OS: macOS Darwin 25.5.0 (arm64)
  • Node: v24.14.1
  • Package manager: pnpm 10.33.0
  • Install path involved: /Users/vonpeter/Library/pnpm/global/5/.pnpm/[email protected]_@[email protected]/node_modules/openclaw

Symptoms

Running openclaw status fails because the Telegram plugin cannot load.

Initial error:

[plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module 'grammy'

After manually installing grammy, the error changed to:

[plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module '@grammyjs/runner'

Investigation

I checked the bundled Telegram extension metadata and found:

dist/extensions/telegram/package.json declares these dependencies:

  • grammy
  • @grammyjs/runner
  • @grammyjs/transformer-throttler

However, in the installed OpenClaw package, only grammy was present after manual repair; the other grammY-related runtime dependencies were missing from the effective installation.

This suggests the Telegram extension dependency chain is not being installed or bundled correctly.

Expected behavior

Installing/reinstalling OpenClaw should produce a working Telegram plugin installation with all required runtime dependencies present.

Actual behavior

Telegram plugin load fails during startup because required runtime modules are missing.

Impact

  • Telegram inbound messages cannot be received
  • Telegram outbound is likely unavailable as well
  • openclaw status is blocked by plugin load failure

Possible root cause

Either:

  1. Telegram extension dependencies are declared in the extension package but not correctly propagated into the final installation, or
  2. the packaging / publish / install flow leaves the Telegram extension with incomplete runtime dependencies.

Suggested fix

Please verify the packaging/install behavior for the Telegram extension and ensure these runtime dependencies are always available:

  • grammy
  • @grammyjs/runner
  • @grammyjs/transformer-throttler

Reproduction hints

  1. Install OpenClaw globally with pnpm
  2. Enable/use Telegram plugin
  3. Run openclaw status
  4. Observe plugin load failure with missing module errors

extent analysis

TL;DR

Verify the packaging and installation process of the Telegram extension to ensure that all required runtime dependencies, including grammy, @grammyjs/runner, and @grammyjs/transformer-throttler, are correctly included.

Guidance

  • Check the package.json file of the Telegram extension to confirm that the dependencies are declared correctly.
  • Verify that the packaging and installation process of OpenClaw correctly propagates these dependencies into the final installation.
  • Manually install the missing dependencies (@grammyjs/runner and @grammyjs/transformer-throttler) to confirm that this resolves the issue.
  • Review the installation logs and output to ensure that all dependencies are being installed correctly.

Example

No code snippet is provided as the issue is related to the packaging and installation process rather than a specific code error.

Notes

The root cause of the issue appears to be related to the packaging and installation process of the Telegram extension, rather than a code error. Verifying the installation process and ensuring that all required dependencies are included should resolve the issue.

Recommendation

Apply a workaround by manually installing the missing dependencies (@grammyjs/runner and @grammyjs/transformer-throttler) until the packaging and installation process is corrected to include these dependencies. This will allow the Telegram plugin to load correctly and function as expected.

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…

FAQ

Expected behavior

Installing/reinstalling OpenClaw should produce a working Telegram plugin installation with all required runtime dependencies present.

#api#installation#network issue#model compatibility#GPU setup

Still need to ship something?

×6

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

Back to top recommendations

TRENDING