OpenClaw 2026.4.5 Telegram 和飞书无法回复问题的修复指南
文章目录
今天手贱升级了一下小龙虾,OpenClaw从老版本升到2026.4.5。升完觉得一切正常,结果打开Telegram发消息——没反应。飞书——也没反应。只有微信还在回我。
诡异。插件明明显示已连接,就是死活不回复。
让元宝帮忙看配置文件,没问题。检查日志,没报错。折腾了半小时,各种重启都没用。
最后想了个办法:装Claude Code,接上智谱API,让AI修AI。全程盯着它操作,生怕这小子一抽风把配置文件删了跑路。
结果还真让它修好了。
下面是完整修复过程,碰到同样问题的朋友可以直接照抄。
问题描述
升级 OpenClaw 后,Telegram 和飞书(Feishu)突然无法回复消息了。
问题原因分析
经过排查,发现有两个主要问题:
1️⃣ 插件配置被禁用
升级后,OpenClaw 配置文件中的 Telegram 和飞书插件被设置为 disabled 状态。
配置文件位置:/root/.openclaw/openclaw.json
问题所在:
"plugins": {
"entries": {
"feishu": {
"enabled": false // ❌ 被禁用了
},
"telegram": {
"enabled": false // ❌ 被禁用了
}
}
}
2️⃣ 插件未加入允许列表
即使将 enabled 改为 true,插件仍然无法加载,因为它们不在 plugins.allow 白名单中。
问题所在:
"plugins": {
"allow": [
"openclaw-weixin",
"browser",
"zai",
"openrouter",
"nvidia",
"qwen"
// ❌ 缺少 "feishu" 和 "telegram"
]
}
3️⃣ 缺少必要的依赖库
Telegram 插件需要 grammy 库才能工作,但这个库在升级过程中丢失了。
错误信息:
Error: Cannot find module 'grammy'
修复步骤
第一步:启用插件
编辑配置文件,将 feishu 和 telegram 的 enabled 改为 true:
# 编辑配置文件
nano /root/.openclaw/openclaw.json
找到以下部分并修改:
"plugins": {
"entries": {
"feishu": {
"enabled": true // ✅ 改为 true
},
"telegram": {
"enabled": true // ✅ 改为 true
}
}
}
第二步:添加插件到允许列表
在同一个配置文件中,找到 "plugins" 下的 "allow" 数组,添加 feishu 和 telegram:
"plugins": {
"allow": [
"feishu", // ✅ 添加这一行
"telegram", // ✅ 添加这一行
"openclaw-weixin",
"browser",
"zai",
"openrouter",
"nvidia",
"qwen"
]
}
第三步:安装缺失的依赖
安装 Telegram 插件需要的 grammy 库:
# 进入 OpenClaw 安装目录
cd /usr/lib/node_modules/openclaw
# 安装缺失的依赖
npm install grammy @grammyjs/runner @grammyjs/transformer-throttler
如果安装过程中出现其他依赖错误,重新安装所有依赖:
# 重新安装所有 OpenClaw 依赖
npm install
第四步:重启服务
# 重启 OpenClaw Gateway 服务
systemctl --user restart openclaw-gateway.service
# 等待几秒钟,然后检查服务状态
sleep 10
systemctl --user status openclaw-gateway.service
第五步:验证修复
查看日志,确认 Telegram 和飞书已正常启动:
# 检查最近的日志
journalctl --user -u openclaw-gateway.service -n 50 --no-pager | grep -E '(telegram|feishu)'
成功的标志:
- 看到
[telegram] starting provider (@你的机器人名) - 看到
feishu_*工具已注册的消息 - 服务状态显示
active (running)
常见问题排查
Q1: 修改配置后服务无法启动
原因:配置文件格式错误(JSON 语法错误)
解决:
- 检查 JSON 格式是否正确(注意逗号、引号)
- 使用 JSON 验证工具检查:
cat /root/.openclaw/openclaw.json | jq .
Q2: Telegram 提示 "Cannot find module 'grammy'"
原因:依赖库未正确安装
解决:
cd /usr/lib/node_modules/openclaw
npm install grammy @grammyjs/runner @grammyjs/transformer-throttler
npm rebuild
Q3: 服务显示运行但仍然无法回复
原因:插件未完全加载
解决:
- 检查
plugins.allow是否包含需要的插件 - 查看完整日志:
journalctl --user -u openclaw-gateway.service -f - 尝试完全重启:
systemctl --user stop openclaw-gateway.service && systemctl --user start openclaw-gateway.service
快速修复命令(一键执行)
如果你熟悉命令行,可以直接复制以下命令:
# 1. 备份配置文件
cp /root/.openclaw/openclaw.json /root/.openclaw/openclaw.json.backup-$(date +%Y%m%d)
# 2. 启用插件并添加到允许列表(使用 jq 工具)
jq '.plugins.entries.feishu.enabled = true | .plugins.entries.telegram.enabled = true | .plugins.allow = ["feishu", "telegram"] + .plugins.allow' /root/.openclaw/openclaw.json > /tmp/openclaw.json.tmp && mv /tmp/openclaw.json.tmp /root/.openclaw/openclaw.json
# 3. 安装依赖
cd /usr/lib/node_modules/openclaw && npm install grammy @grammyjs/runner @grammyjs/transformer-throttler
# 4. 重启服务
systemctl --user restart openclaw-gateway.service
# 5. 检查状态
sleep 10 && systemctl --user status openclaw-gateway.service
总结
这个问题的核心是 OpenClaw 升级后插件配置被重置。解决方法很简单:
- ✅ 在
plugins.entries中启用插件 - ✅ 在
plugins.allow中添加插件 - ✅ 安装缺失的依赖库
- ✅ 重启服务
预防措施:
- 每次升级 OpenClaw 后,检查配置文件中的插件设置
- 保留一份配置文件备份
- 关注升级日志中的警告信息
相关文件位置
| 文件 | 位置 | 说明 |
|---|---|---|
| OpenClaw 配置 | /root/.openclaw/openclaw.json |
主配置文件 |
| 服务日志 | journalctl --user -u openclaw-gateway.service |
systemd 服务日志 |
| OpenClaw 日志 | /tmp/openclaw/openclaw-日期.log |
应用日志 |
| 插件目录 | /usr/lib/node_modules/openclaw/dist/extensions/ |
内置插件位置 |
你觉得这篇文章怎么样?
共有 0 条评论