前言2026 年 3 月 9 日OpenClaw 创始人 Peter Steinberger 官宣了 v2026.3.7-beta.1 版本包含 89 项代码提交、200 多个 Bug 修复、GPT-5.4 原生支持等重大更新。本文完整记录了在阿里云 ECS 服务器上将 OpenClaw 从 2026.2.24 升级到 2026.3.8最新正式版的全过程包括遇到的所有坑和解决方案希望能为同样需要升级的朋友提供参考。一、环境背景项目配置服务器阿里云 ECS操作系统AliOSCentOS 系物理内存1.8G 4G SwapOpenClaw 旧版本2026.2.24 (df9a474)OpenClaw 新版本2026.3.8安装方式npm 全局安装非 Docker安装路径/usr/local/bin/openclaw → /usr/lib/node_modules/openclawAI 模型dashscope/qwen3.5-plus云端 API前端渠道飞书自建 Agent多多助理已安装 SkillSearXNG 搜索、TuShare 金融数据二、新版本有什么值得升级的2.1 与我的环境直接相关的改进* 飞书 Webhook 兼容性修复 — 我的 Agent 对接的就是飞书这个修复能提升稳定性* 上下文压缩截断丢失修复 — 对话一长 token 容易丢关键信息的问题修了* SQLite 锁冲突导致内存搜索卡顿修复 — 我部署了 SearXNG 搜索 Skill这个修复改善搜索时的卡顿* 模型降级与重试机制优化 — 模型限流或过载时自动切换备选模型不再直接报错* 安全层面升级 — 依赖库安全更新 沙盒逃逸防范加强2.2 其他重要更新* GPT-5.4 和 Gemini 3.1 Flash 原生支持* 全新 ContextEngine 插件接口 — 上下文管理可插拔支持 RAG 和自定义压缩策略* 容器化部署优化 — 新增OPENCLAW_EXTENSIONS和OPENCLAW_VARIANTslim支持* ACP 持久化频道绑定 — Discord/Telegram 绑定重启后自动恢复* Perplexity Search API 升级 — 支持语音、区域和时间过滤器2.3 安全注意事项上海科技大学的安全评估论文指出 OpenClaw 整体安全通过率只有 58.9%在意图误解与不安全假设维度通过率为 0%。升级后建议* 不要给 Agent 过大的文件系统权限* 涉及删除、修改等操作时让 Agent 先确认再执行三、升级前准备3.1 确认当前安装方式首先需要确认 OpenClaw 是怎么安装的这决定了升级方式which openclaw如果返回 /usr/local/bin/openclaw或类似路径 → npm 全局安装使用本文的方法升级如果返回 Docker 相关路径 → Docker 安装使用 docker pull 升级不在本文范围内如何判断 一个简单的方法运行 docker pull openclaw/openclaw:latest 如果提示docker: command not found 那就说明不是 Docker 安装的。3.2 确认当前版本openclaw --version# 输出2026.2.243.3 检查服务器资源# 查看内存和 swap free -h# 查看 swap 是否启用 swapon --show重要提示 如果物理内存不足 4G强烈建议确保 Swap 已启用且不小于 2G。后续 npm 安装可能会比较吃内存。如果没有 Swap先创建一个sudo dd if/dev/zero of/swapfile bs1M count2048sudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfile四、升级步骤4.1 停止 Gateway 服务openclaw gateway stop预期输出 OpenClaw 2026.2.24 (df9a474) — ... Stopped systemd service: openclaw-gateway.service4.2 备份当前配置cp -r ~/.openclaw ~/.openclaw-backup-$(date %Y%m%d)这一步非常重要备份了你的所有配置、Skill、扩展等万一升级出问题可以快速回滚。4.3 配置 Git HTTPS避免 SSH 权限问题npm 安装过程中部分依赖需要从 GitHub 拉取代码默认使用 SSH 协议。如果服务器没有配置 GitHub SSH 密钥会报错gitgithub.com: Permission denied (publickey).fatal: Could not read from remote repository.解决办法 让 Git 自动将 SSH 地址转为 HTTPSgit config --global url.https://github.com/.insteadOf ssh://gitgithub.com/git config --global url.https://github.com/.insteadOf gitgithub.com:4.4 清理残留文件如果之前有安装失败的历史需要先清理干净rm -rf /usr/lib/node_modules/openclaw rm -rf /usr/lib/node_modules/.openclaw-*不用担心你的配置和 Skill 数据都在~/.openclaw目录下已备份删除node_modules里的文件只是删除程序本身不影响配置。4.5 安装新版本关键步骤npm install -g openclawlatest --ignore-scripts为什么要加 --ignore-scripts 新版 OpenClaw 依赖 node-llama-cpp 安装时会尝试从源码编译 llama.cpp。这个编译过程非常吃内存在低配服务器如 1.8G 内存上会被 OOM Killer 杀掉报错c: fatal error: Killed signal terminated program cc1plus如果你使用的是云端 API 模型如 dashscope/qwen3.5-plus、OpenAI API 等根本不需要本地 llama.cpp所以可以安全跳过这个编译步骤。--ignore-scripts会跳过所有 postinstall 脚本包括 llama.cpp 编译和 build-info 生成。预期输出npm warn deprecated node-domexception1.0.0: Use your platforms native DOMException insteadadded 671 packages in 1m129 packages are looking for fundingrun npm fund for details看到added XXX packages就说明安装成功了。中间的 npm warn deprecated 警告可以忽略这是 npm 生态中常见的依赖过时提示。4.6 手动执行必要的 rebuildcd /usr/lib/node_modules/openclawnpm rebuild --ignore-scripts 2/dev/null || true4.7 验证安装版本# 查看 npm 全局安装的版本 npm list -g openclaw # 或者直接看 package.json cat /usr/lib/node_modules/openclaw/package.json | grep version | head -1预期输出/usr/lib └── openclaw2026.3.8 version: 2026.3.8,已知问题 由于使用了 --ignore-scripts openclaw --version命令可能仍然显示旧版本号2026.2.24这只是 build-info 文件没有被 postinstall 脚本更新导致的显示问题不影响实际运行。以 package.json 中的版本号为准。4.8 启动 Gateway 服务openclaw gateway start预期输出 OpenClaw 2026.2.24 (df9a474) — ... Restarted systemd service: openclaw-gateway.service注意区分两个启动命令openclaw gateway start— 以 systemd 后台服务 方式运行关掉终端不影响推荐使用openclaw gateway— 在 前台 运行关掉终端会停止服务仅适合调试时使用4.9 验证服务运行状态# 确认进程在后台运行 ps aux | grep openclaw预期看到类似输出root 170821 31.1 23.2 12143816 444968 ? Ssl 15:17 0:24 openclaw-gateway4.10 飞书端测试在飞书中向多多助理发送消息确认以下功能正常飞书消息收发正常SearXNG 搜索 Skill 正常TuShare 金融数据查询正常定时任务正常五、踩坑记录与解决方案坑 1docker command not found现象 执行 docker pull openclaw/openclaw:latest报-bash: docker: command not found原因 OpenClaw 不是通过 Docker 安装的而是 npm 全局安装解决 使用 which openclaw确认安装方式改用 npm install -g 升级坑 2GitHub SSH Permission denied现象npm error gitgithub.com: Permission denied (publickey).npm error fatal: Could not read from remote repository.原因 npm 安装依赖时需要通过 SSH 访问 GitHub但服务器没有配置 GitHub SSH 密钥解决git config --global url.https://github.com/.insteadOf ssh://gitgithub.com/ git config --global url.https://github.com/.insteadOf gitgithub.com:坑 3ENOTEMPTY 目录不为空现象npm error ENOTEMPTY: directory not empty, rename /usr/lib/node_modules/openclaw原因 上次安装被 kill 后留下了不干净的临时文件解决rm -rf /usr/lib/node_modules/openclawrm -rf /usr/lib/node_modules/.openclaw-*坑 4node-llama-cpp 编译被 OOM Killer 杀掉现象c: fatal error: Killed signal terminated program cc1plus compilation terminated.原因node-llama-cpp 在 postinstall 阶段尝试从源码编译 llama.cpp编译 C 大文件时内存不足被系统 OOM Killer 强制终止解决 使用--ignore-scripts跳过编译。如果使用云端 API 模型完全不需要本地 llama.cppnpm install -g openclawlatest --ignore-scripts坑 5Gateway 启动后飞书无响应现象 多多助理最初回复了一条消息之后就不响应了原因 升级后首次启动时 WebSocket 连接可能不稳定解决 重启 Gateway 即可恢复openclaw gateway stop openclaw gateway start六、完整命令速查如果你的环境和我类似npm 安装、低配服务器、云端 API 模型以下是最精简的升级命令序列# 1. 停止服务openclaw gateway stop# 2. 备份配置cp -r ~/.openclaw ~/.openclaw-backup-$(date %Y%m%d)# 3. 配置 Git HTTPSgit config --global url.https://github.com/.insteadOf ssh://gitgithub.com/ git config --global url.https://github.com/.insteadOf gitgithub.com:# 4. 清理旧文件rm -rf /usr/lib/node_modules/openclawrm -rf /usr/lib/node_modules/.openclaw-*# 5. 安装新版跳过 llama.cpp 编译npm install -g openclawlatest --ignore-scripts# 6. rebuildcd /usr/lib/node_modules/openclawnpm rebuild --ignore-scripts 2/dev/null || true# 7. 验证版本npm list -g openclaw# 8. 启动服务openclaw gateway start# 9. 确认运行ps aux | grep openclaw七、回滚方案如果升级后出现严重问题可以快速回滚到旧版本# 停止新版openclaw gateway stop# 恢复旧版配置rm -rf ~/.openclaw cp -r ~/.openclaw-backup-$(date %Y%m%d) ~/.openclaw# 安装旧版npm install -g openclaw2026.2.24 --ignore-scripts# 启动旧版openclaw gateway start八、后续优化建议关注 feishu 插件重复加载警告启动日志中有 plugins.entries.feishu: duplicate plugin id detected 提示不影响使用但后续版本可能需要调整配置测试新功能ContextEngine 插件接口、模型降级重试等新功能值得探索安全加固参考安全评估论文的建议限制 Agent 的文件系统权限下次升级如果服务器内存升级到 4G可以不加 --ignore-scripts 直接安装让 build-info 正常生成作者海风 环境阿里云 ECS OpenClaw 2026.3.8 飞书 日期2026年3月11日