OpenClaw更新操作
前言
对于OpenClaw的资深用户而言,每一次版本迭代都伴随大量功能增强与结构优化。在享受这些升级红利的同时,更新过程本身也可能带来预料之外的配置挑战。本文旨在系统梳理我们实战中遇到的典型更新问题及其解决方案,助你构建一个更高效、更稳定的升级工作流。
一、OpenClaw核心更新指南
从系统稳定性和环境纯净度角度评估,全新安装往往是规避依赖冲突最彻底的方案。此方法会触发默认的新手引导流程,资深用户可以通过追加 --no-onboard 参数跳过此步骤。
整个安装进程耗时取决于网络与系统环境,请确保其完整执行,勿中断。
curl -fsSL https://openclaw.ai/install.sh | bash --no-onboard
若更新后出现运行异常,首要步骤是调用内置诊断工具进行自检与修复。该命令能自动识别并处理多数常见的环境与配置故障。
openclaw doctor --fix
关键版本 26.3.31 配置变更
此版本引入了一项重要的配置语法收紧:在 openclaw.json 的 agents 配置块中,任一智能体(agent)的tools字段内,allow 与 alsoAllow 两项不得共存。遗留的并存配置将直接导致系统报错并中断启动。修正方案是二者择一保留。此前部分用户反馈的飞书消息发送失败问题,多源于此配置冲突。
agents.list.6.tools: agent tools cannot set both allow and alsoAllow in the same scope (merge alsoAllow into allow, or remove allow and use profile + alsoAllow)
二、飞书插件同步更新
请注意,OpenClaw核心升级后,必须同步更新对应的飞书插件版本。核心与插件之间的版本错位是导致功能不协同或接口调失败的常见原因。
匹配核心 26.3.31 的插件更新
为确保与上述核心版本兼容,请执行以下命令更新飞书插件至指定版本:
npx -y @larksuite/openclaw-lark@2026.4.1 update
以上是本次版本更新的核心操作清单。接下来,分享一则轻松的札记。