openclaw - 💡(How to fix) Fix Global install 2026.4.7-1 breaks Telegram plugin loading and leaves gateway in restart loop [1 comments, 2 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#62978Fetched 2026-04-09 07:59:53
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
0
Author
Participants
Timeline (top)
closed ×1commented ×1

After upgrading a working Telegram setup, OpenClaw on Linux ended up with a broken global install on version 2026.4.7-1. The gateway entered a restart loop and Telegram stopped responding. Rolling back to 2026.4.2 restored normal Telegram replies.

Environment

  • Host: Linux VM
  • Node: v22.22.0
  • npm: 10.9.4
  • Global install path: /home/claw/.npm-global/lib/node_modules/openclaw
  • Config path: ~/.openclaw/openclaw.json
  • Telegram channel enabled

Observed behavior on the broken upgrade

  • systemd user service openclaw-gateway.service repeatedly restarted
  • Logs first showed config read failure due to missing module: Cannot find module 'grammy'
  • Logs also showed many bundled plugin / manifest inconsistencies during the same upgrade attempt
  • During rollback / reinstall there were transient missing dist chunk errors, which suggests package replacement left the install in a mixed state during upgrade
  • Even when the gateway came up, Telegram plugin load still failed until rollback completed

Key log snippets

  • Config invalid -> Cannot find module 'grammy' (Require stack included dist/allowed-updates-.js and later dist/sticker-cache-.js)
  • [plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module 'grammy'
  • openclaw-gateway.service restart counter kept increasing

Version interaction observed

  • Local broken version after upgrade: 2026.4.7-1
  • npm registry version at the time checked: 2026.4.5
  • Config had lastTouchedVersion 2026.4.5
  • Rolling back to 2026.4.2 restored service stability and Telegram replies

Recovery steps that worked

  1. Remove stale npm temp dir left by failed replacement under ~/.npm-global/lib/node_modules/.openclaw-*
  2. Install [email protected] globally
  3. Let postinstall-bundled-plugins complete, including grammy
  4. Restart openclaw-gateway.service

Result after rollback

  • openclaw 2026.4.2 started successfully
  • grammy was present in node_modules
  • Logs showed: [telegram] [default] starting provider (...)
  • Telegram replies were normal again

Expected behavior

  • Upgrading should not leave global installs in a mixed state
  • Telegram bundled dependency resolution should remain valid after upgrade
  • Gateway should fail atomically or roll back cleanly instead of entering a long restart loop

Possible area to inspect

  • Packaging / publish integrity for 2026.4.7-1
  • postinstall-bundled-plugins and bundled Telegram dependency installation
  • upgrade path compatibility when config lastTouchedVersion is newer than the running binary

I can provide fuller journal excerpts if needed.

Error Message

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

Root Cause

After upgrading a working Telegram setup, OpenClaw on Linux ended up with a broken global install on version 2026.4.7-1. The gateway entered a restart loop and Telegram stopped responding. Rolling back to 2026.4.2 restored normal Telegram replies.

Environment

  • Host: Linux VM
  • Node: v22.22.0
  • npm: 10.9.4
  • Global install path: /home/claw/.npm-global/lib/node_modules/openclaw
  • Config path: ~/.openclaw/openclaw.json
  • Telegram channel enabled

Observed behavior on the broken upgrade

  • systemd user service openclaw-gateway.service repeatedly restarted
  • Logs first showed config read failure due to missing module: Cannot find module 'grammy'
  • Logs also showed many bundled plugin / manifest inconsistencies during the same upgrade attempt
  • During rollback / reinstall there were transient missing dist chunk errors, which suggests package replacement left the install in a mixed state during upgrade
  • Even when the gateway came up, Telegram plugin load still failed until rollback completed

Key log snippets

  • Config invalid -> Cannot find module 'grammy' (Require stack included dist/allowed-updates-.js and later dist/sticker-cache-.js)
  • [plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module 'grammy'
  • openclaw-gateway.service restart counter kept increasing

Version interaction observed

  • Local broken version after upgrade: 2026.4.7-1
  • npm registry version at the time checked: 2026.4.5
  • Config had lastTouchedVersion 2026.4.5
  • Rolling back to 2026.4.2 restored service stability and Telegram replies

Recovery steps that worked

  1. Remove stale npm temp dir left by failed replacement under ~/.npm-global/lib/node_modules/.openclaw-*
  2. Install [email protected] globally
  3. Let postinstall-bundled-plugins complete, including grammy
  4. Restart openclaw-gateway.service

Result after rollback

  • openclaw 2026.4.2 started successfully
  • grammy was present in node_modules
  • Logs showed: [telegram] [default] starting provider (...)
  • Telegram replies were normal again

Expected behavior

  • Upgrading should not leave global installs in a mixed state
  • Telegram bundled dependency resolution should remain valid after upgrade
  • Gateway should fail atomically or roll back cleanly instead of entering a long restart loop

Possible area to inspect

  • Packaging / publish integrity for 2026.4.7-1
  • postinstall-bundled-plugins and bundled Telegram dependency installation
  • upgrade path compatibility when config lastTouchedVersion is newer than the running binary

I can provide fuller journal excerpts if needed.

RAW_BUFFERClick to expand / collapse

Summary After upgrading a working Telegram setup, OpenClaw on Linux ended up with a broken global install on version 2026.4.7-1. The gateway entered a restart loop and Telegram stopped responding. Rolling back to 2026.4.2 restored normal Telegram replies.

Environment

  • Host: Linux VM
  • Node: v22.22.0
  • npm: 10.9.4
  • Global install path: /home/claw/.npm-global/lib/node_modules/openclaw
  • Config path: ~/.openclaw/openclaw.json
  • Telegram channel enabled

Observed behavior on the broken upgrade

  • systemd user service openclaw-gateway.service repeatedly restarted
  • Logs first showed config read failure due to missing module: Cannot find module 'grammy'
  • Logs also showed many bundled plugin / manifest inconsistencies during the same upgrade attempt
  • During rollback / reinstall there were transient missing dist chunk errors, which suggests package replacement left the install in a mixed state during upgrade
  • Even when the gateway came up, Telegram plugin load still failed until rollback completed

Key log snippets

  • Config invalid -> Cannot find module 'grammy' (Require stack included dist/allowed-updates-.js and later dist/sticker-cache-.js)
  • [plugins] telegram failed to load from .../dist/extensions/telegram/index.js: Error: Cannot find module 'grammy'
  • openclaw-gateway.service restart counter kept increasing

Version interaction observed

  • Local broken version after upgrade: 2026.4.7-1
  • npm registry version at the time checked: 2026.4.5
  • Config had lastTouchedVersion 2026.4.5
  • Rolling back to 2026.4.2 restored service stability and Telegram replies

Recovery steps that worked

  1. Remove stale npm temp dir left by failed replacement under ~/.npm-global/lib/node_modules/.openclaw-*
  2. Install [email protected] globally
  3. Let postinstall-bundled-plugins complete, including grammy
  4. Restart openclaw-gateway.service

Result after rollback

  • openclaw 2026.4.2 started successfully
  • grammy was present in node_modules
  • Logs showed: [telegram] [default] starting provider (...)
  • Telegram replies were normal again

Expected behavior

  • Upgrading should not leave global installs in a mixed state
  • Telegram bundled dependency resolution should remain valid after upgrade
  • Gateway should fail atomically or roll back cleanly instead of entering a long restart loop

Possible area to inspect

  • Packaging / publish integrity for 2026.4.7-1
  • postinstall-bundled-plugins and bundled Telegram dependency installation
  • upgrade path compatibility when config lastTouchedVersion is newer than the running binary

I can provide fuller journal excerpts if needed.

extent analysis

TL;DR

Rolling back to a previous version of OpenClaw, such as 2026.4.2, may resolve the issue of a broken global install after upgrading.

Guidance

  • Verify that the grammy module is present in the node_modules directory after installing OpenClaw, as its absence was a key error in the broken upgrade.
  • Check the packaging and publish integrity of version 2026.4.7-1, as the mixed state of the install during upgrade suggests potential issues with the release.
  • Inspect the postinstall-bundled-plugins script and the installation of bundled Telegram dependencies to ensure they are correctly resolved after an upgrade.
  • Consider implementing a more robust upgrade path that can handle cases where the config lastTouchedVersion is newer than the running binary, to prevent similar issues in the future.

Example

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

Notes

The provided information suggests that the issue might be specific to the version 2026.4.7-1 of OpenClaw and its interaction with the grammy module and other bundled plugins. Further investigation into the packaging and installation process of this version is recommended.

Recommendation

Apply workaround: Roll back to a previous version of OpenClaw, such as 2026.4.2, as it has been shown to restore service stability and Telegram replies. This is recommended because the exact cause of the issue with version 2026.4.7-1 is not fully understood, and rolling back provides a known stable state.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING