ClawdBot 升级 OpenClaw 避坑指南：从踩坑到填坑的完整记录

📌 系列文章说明:本文是 OpenClaw(原 Clawd/Moltbot)系列的技术指南篇,详细记录从 ClawdBot 2026.1.24-3 升级到 OpenClaw 2026.1.30 的完整过程。如果你还不了解这个项目,建议先阅读:

• • 从Clawd到Moltbot再到OpenClaw,一个开源项目的改名之旅 – 了解项目的改名历程

⚠️ 重要提示


本文中所有涉及的目录路径(如 /home/jone/、~/.openclaw/ 等)均为作者实际环境中的路径示例。


在实际操作时,请根据您自己的用户名和安装目录进行相应调整。


例如:如果您的用户名是 alice,则路径应该是 /home/alice/.openclaw/ 或 ~/.openclaw/。

2026年1月30日,ClawdBot 正式更名为 OpenClaw,并发布了 2026.1.30 版本。这不仅仅是一次简单的品牌升级,更是一次架构优化和功能增强的重大更新。

对于已经在使用 ClawdBot 的用户来说,升级是必须的,但也可能会遇到一些问题。本文将详细记录从 ClawdBot 2026.1.24-3 升级到 OpenClaw 2026.1.30 的完整过程,包括:

• • 🛠️ 完整的升级步骤:从安装到配置的每一步
• • ⚠️ 实际遇到的问题:插件配置错误、依赖问题等
• • ✅ 具体的解决方案:每个问题都有详细的解决方法
• • 📚 最佳实践建议:升级前后的注意事项

希望这篇文章能帮助你顺利完成升级!

图1: ClawdBot 到 OpenClaw 的升级迁移过程

ClawdBot 更名为 OpenClaw 后,带来了以下重要变化:

• • 统一的命令行工具:从 clawdbot 命令升级为 openclaw 命令
• • 优化的配置管理:配置文件从 ~/.clawdbot/ 迁移到 ~/.openclaw/
• • 更好的插件系统:插件清单文件从 clawdbot.plugin.json 升级为 openclaw.plugin.json
• • 改进的服务管理:systemd 服务从 clawdbot-gateway.service 升级为 openclaw-gateway.service

• • 操作系统: Linux 5.15.0-30-generic (x64)
• • Node.js 版本: v22.17.0
• • ClawdBot 版本: 2026.1.24-3
• • 已配置的频道: Telegram、Discord、Feishu

使用官方提供的一键安装脚本:

curl -fsSL https://openclaw.ai/install.sh | bash

安装过程会自动完成以下操作:

1. 1. 检测操作系统和 Node.js 环境
2. 2. 下载并安装 OpenClaw 2026.1.30
3. 3. 运行 doctor 工具进行配置迁移
4. 4. 检查并提示潜在的配置问题

安装脚本会自动运行 openclaw doctor,执行以下迁移操作:

- State dir: /home/jone/.clawdbot → /home/jone/.openclaw (legacy path now symlinked)

OpenClaw 会创建一个符号链接,将 ~/.clawdbot 指向 ~/.openclaw,确保向后兼容。

- Migrated legacy config: /home/jone/.clawdbot/clawdbot.json → /home/jone/.openclaw/openclaw.json

配置文件会自动从旧路径复制到新路径,并进行必要的格式转换。

图2: 配置文件和目录结构的迁移流程

升级后,系统报告了以下错误:

Invalid config at /home/jone/.openclaw/openclaw.json: - plugins: plugin: plugin manifest not found: /home/jone/.openclaw/extensions/feishu/openclaw.plugin.json - plugins.entries.feishu: plugin not found: feishu - plugins.allow: plugin not found: feishu - channels.feishu: unknown channel id: feishu

原因分析:

旧版本的 Feishu 插件只有 clawdbot.plugin.json 文件,缺少新版本要求的 openclaw.plugin.json 文件。

解决方案:

# 进入 Feishu 插件目录 cd ~/.openclaw/extensions/feishu # 复制插件清单文件 cp clawdbot.plugin.json openclaw.plugin.json

复制清单文件后,仍然报错:

Error: Cannot find module 'clawdbot/plugin-sdk' Require stack: - /home/jone/.openclaw/extensions/feishu/index.ts

原因分析:

旧版本的 Feishu 插件代码中引用了 clawdbot/plugin-sdk,但新版本的包名已改为 openclaw/plugin-sdk。

解决方案:

由于这是第三方插件的兼容性问题,最简单的方法是:

1. 1. 删除旧版本的 Feishu 插件
2. 2. 使用官方插件安装命令重新安装

# 删除旧插件 rm -rf ~/.openclaw/extensions/feishu # 编辑配置文件,移除 Feishu 相关配置 vi ~/.openclaw/openclaw.json # 删除 plugins.entries.feishu、plugins.allow 中的 feishu、channels.feishu 等配置 # 重新安装 Feishu 插件 openclaw plugins install @m1heng-clawd/feishu

# 停止 ClawdBot gateway 服务 clawdbot gateway stop # 卸载 ClawdBot gateway 服务 clawdbot gateway uninstall # 禁用并删除 systemd 服务文件 systemctl --user disable --now clawdbot-gateway.service systemctl --user disable --now clawdbot-gateway-main.service rm -f ~/.config/systemd/user/clawdbot-gateway*.service

# 安装 OpenClaw gateway 服务 openclaw gateway install # 启动服务(会自动检测端口占用) openclaw gateway

注意: 如果遇到端口占用错误,说明旧的 ClawdBot gateway 仍在运行,需要先停止它。

运行状态检查命令:

openclaw status

成功的输出应该包含:

Overview ┌─────────────────┬──────────────────────────────────────────────────────┐ │ Item │ Value │ ├─────────────────┼──────────────────────────────────────────────────────┤ │ Dashboard │ http://127.0.0.1:18789/ │ │ OS │ linux 5.15.0-30-generic (x64) · node 22.17.0 │ │ Gateway │ local · ws://127.0.0.1:18789 · reachable · auth token│ │ Gateway service │ systemd installed · enabled · running │ │ Agents │ 1 · sessions 9 · default main active │ └─────────────────┴──────────────────────────────────────────────────────┘ Channels ┌──────────┬─────────┬────────┬────────────────────────────────────────┐ │ Channel │ Enabled │ State │ Detail │ ├──────────┼─────────┼────────┼────────────────────────────────────────┤ │ Telegram │ ON │ OK │ token config · accounts 1/1 │ │ Discord │ ON │ OK │ token config · accounts 1/1 │ └──────────┴─────────┴────────┴────────────────────────────────────────┘

OpenClaw 提供了 Web 控制面板,可以通过以下命令获取访问地址:

openclaw dashboard

对于远程服务器,可以使用 SSH 隧道:

# 在本地电脑执行 ssh -N -L 18789:127.0.0.1:18789 user@your-server-ip # 然后在浏览器访问 http://localhost:18789/

图3: OpenClaw Web 控制面板界面

openclaw plugins list

openclaw plugins install <plugin-name>

openclaw plugins doctor

OpenClaw 内置了安全审计功能:

# 快速审计 openclaw security audit # 深度审计 openclaw security audit --deep

常见的安全建议:

1. 1. Gateway 认证: 如果通过反向代理暴露控制面板,务必配置 gateway.auth
2. 2. 可信代理: 配置 gateway.trustedProxies 以正确处理代理头
3. 3. 插件白名单: 设置 plugins.allow 明确允许加载的插件

图4: 升级过程中常见问题的排除方案

问题: 运行任何 openclaw 命令都提示配置无效

解决方案:

# 运行 doctor 工具诊断 openclaw doctor # 自动修复配置问题 openclaw doctor --fix

问题: 启动 gateway 时提示端口 18789 已被占用

解决方案:

# 检查占用端口的进程 lsof -i :18789 # 停止旧的 gateway 服务 clawdbot gateway stop # 或 systemctl --user stop clawdbot-gateway.service

问题: 插件状态显示为 error

解决方案:

1. 1. 检查插件清单文件是否存在 openclaw.plugin.json
2. 2. 检查插件代码是否使用了正确的 SDK 包名
3. 3. 重新安装插件:

# 删除旧插件 rm -rf ~/.openclaw/extensions/<plugin-name> # 重新安装 openclaw plugins install <plugin-name>

问题: 升级后找不到之前的对话历史

解决方案:

Session openclaw 数据会自动迁移,但路径仍然指向旧位置:

Session store (main): /home/jone/.clawdbot/agents/main/sessions/sessions.json

由于 ~/.clawdbot 是 ~/.openclaw 的符号链接,数据实际上已经在新位置,无需手动迁移。

1. 1. 备份配置文件:cp -r ~/.clawdbot ~/.clawdbot.backup
2. 2. 记录当前配置:clawdbot status > clawdbot-status-before-upgrade.txt
3. 3. 导出插件列表:clawdbot plugins list > clawdbot-plugins.txt

1. 1. 验证所有频道状态:openclaw status –deep
2. 2. 测试插件功能:openclaw plugins list
   openclaw plugins doctor
3. 3. 检查日志:openclaw logs –follow

1. 1. 启用内存插件:openclaw plugins install @openclaw/memory-lancedb
2. 2. 配置心跳间隔:
   根据使用频率调整 heartbeat 配置,默认为 30 分钟
3. 3. 优化 Session 管理:
   定期清理不活跃的 session,避免占用过多内存

从 ClawdBot 升级到 OpenClaw 的过程总体比较顺利,官方提供的自动迁移工具能够处理大部分配置转换工作。主要的挑战在于第三方插件的兼容性问题,需要重新安装或更新插件。

希望这篇文章能帮助你顺利完成从 ClawdBot 到 OpenClaw 的升级!如果在升级过程中遇到问题,欢迎加入我们的交流群讨论。

想和大家一起讨论 OpenClaw(原 ClawdBot/Moltbot)的使用心得?欢迎加入我们的 OpenClaw 学习交流群!

在群里你可以:

• • 🤝 与其他用户交流经验
• • 💡 分享你的使用技巧和创意
• • 🐛 遇到问题时获得帮助
• • 📢 第一时间了解项目动态

入群方式:关注公众号「齐昂AI」,回复「OpenClaw」获取入群方式。

• • 2026最强个人AI助理来了！ClawdBot完整安装教程
• • 火遍外网,狂揽60K+的开源AI助手接入Discord
• • ClawdBot 接入飞书保姆级教程，小白也能打造 7×24 小时 AI 助手
• • 从Clawd到Moltbot再到OpenClaw,一个开源项目的改名之旅

• • 官方文档: https://docs.openclaw.ai
• • GitHub 仓库: https://github.com/openclaw/openclaw
• • 插件开发指南: https://docs.openclaw.ai/plugin
• • 故障排除指南: https://docs.openclaw.ai/troubleshooting
• • 常见问题 FAQ: https://docs.openclaw.ai/faq

以上，既然看到这里了，如果觉得不错，随手分享、收藏、评论三连吧，如果想第一时间收到推送，也可以给我个关注～感谢你的阅读，我们下次见。