openclaw - 💡(How to fix) Fix [Bug]: openclaw doctor crashes in 2026.4.21 npm install (missing grammy, then Telegram register crash) [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#70220Fetched 2026-04-23 07:27:37
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
closed ×1commented ×1labeled ×1

After upgrading to [email protected] via npm on macOS, openclaw doctor fails. The first failure was a missing Telegram dependency (grammy). After that dependency got staged, doctor still failed during Telegram plugin registration with a defineProperty crash.

Error Message

Error: Cannot find module 'grammy' Require stack:

  • /opt/homebrew/lib/node_modules/openclaw/dist/extensions/telegram/allowed-updates-BD2bJyzD.js

Steps to reproduce

Steps to reproduce

  1. Install [email protected] with npm i -g openclaw@latest
  2. Run openclaw doctor
  3. Accept OAuth refresh when prompted

Expected behavior

openclaw doctor completes normally.

Actual behavior

Initial error:

Root Cause

After upgrading to [email protected] via npm on macOS, openclaw doctor fails. The first failure was a missing Telegram dependency (grammy). After that dependency got staged, doctor still failed during Telegram plugin registration with a defineProperty crash.

Fix Action

Fix / Workaround

Node / npm Node: v25.9.0 npm: 11.12.1 Additional notes Telegram is enabled in config I rolled back to [email protected] as a workaround The 2026.4.21 changelog mentions bundled plugin runtime dependency repair, but this doctor path still fails

Code Example

Error: Cannot find module 'grammy'
Require stack:
- /opt/homebrew/lib/node_modules/openclaw/dist/extensions/telegram/allowed-updates-BD2bJyzD.js


### Steps to reproduce


### Steps to reproduce
1. Install `[email protected]` with `npm i -g openclaw@latest`
2. Run `openclaw doctor`
3. Accept OAuth refresh when prompted



### Expected behavior

`openclaw doctor` completes normally.

### Actual behavior

Initial error:

---
RAW_BUFFERClick to expand / collapse

Bug type

Regression (worked before, now fails)

Beta release blocker

No

Summary

Bug type

Crash / regression

Summary

After upgrading to [email protected] via npm on macOS, openclaw doctor fails. The first failure was a missing Telegram dependency (grammy). After that dependency got staged, doctor still failed during Telegram plugin registration with a defineProperty crash.

Steps to reproduce

  1. Install [email protected] with npm i -g openclaw@latest
  2. Run openclaw doctor
  3. Accept OAuth refresh when prompted

Expected behavior

openclaw doctor completes normally.

Actual behavior

Initial error:

Error: Cannot find module 'grammy'
Require stack:
- /opt/homebrew/lib/node_modules/openclaw/dist/extensions/telegram/allowed-updates-BD2bJyzD.js


### Steps to reproduce


### Steps to reproduce
1. Install `[email protected]` with `npm i -g openclaw@latest`
2. Run `openclaw doctor`
3. Accept OAuth refresh when prompted



### Expected behavior

`openclaw doctor` completes normally.

### Actual behavior

Initial error:
```text
Error: Cannot find module 'grammy'
Require stack:
- /opt/homebrew/lib/node_modules/openclaw/dist/extensions/telegram/allowed-updates-BD2bJyzD.js

### OpenClaw version

2026.4.21

### Operating system

macOS

### Install method

npm global

### Model

GPT 5.4 OAth

### Provider / routing chain

OATH

### Additional provider/model setup details

_No response_

### Logs, screenshots, and evidence

```shell

Impact and severity

No response

Additional information

Node / npm Node: v25.9.0 npm: 11.12.1 Additional notes Telegram is enabled in config I rolled back to [email protected] as a workaround The 2026.4.21 changelog mentions bundled plugin runtime dependency repair, but this doctor path still fails

Useful command outputs to attach:

openclaw doctor
OPENCLAW_PLUGIN_LOADER_DEBUG_STACKS=1 openclaw plugins list --json
node -v
npm -v
npm ls -g openclaw --depth=0

extent analysis

TL;DR

The most likely fix is to ensure the grammy dependency is properly installed and configured for the openclaw Telegram plugin.

Guidance

  • Verify that grammy is installed by running npm ls -g grammy and install it if necessary using npm i -g grammy.
  • Check the openclaw configuration to ensure that the Telegram plugin is correctly set up and that the grammy dependency is referenced correctly.
  • Run OPENCLAW_PLUGIN_LOADER_DEBUG_STACKS=1 openclaw plugins list --json to debug the plugin loading process and identify any issues with the grammy dependency.
  • Consider rolling back to a previous version of openclaw, such as 2026.4.15, as a temporary workaround if the issue persists.

Example

No code snippet is provided as the issue is related to dependency installation and configuration rather than code implementation.

Notes

The issue may be related to the "bundled plugin runtime dependency repair" mentioned in the 2026.4.21 changelog, which could be causing issues with the grammy dependency. Further investigation is needed to determine the root cause of the issue.

Recommendation

Apply the workaround by rolling back to [email protected] until a fix is available, as this version is known to work correctly.

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

openclaw doctor completes normally.

Still need to ship something?

×6

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

Back to top recommendations

TRENDING