OpenClaw更新操作

前言

对于 OpenClaw 的忠实用户而言，每一次版本迭代都意义非凡。新功能密集、改动幅度大是它的显著特点，这固然令人欣喜，但伴随而来的更新操作也时常会遇到一些预料外的状况。本文旨在系统梳理我们在升级过程中遇到的常见问题与解决方案，帮助您在下次更新时更加顺畅，有效规避不必要的麻烦。

一、OpenClaw 核心更新指南

从实践经验来看，最稳定且能避免依赖冲突的 OpenClaw 更新方法，实际上是执行一次全新的安装。这听起来似乎不够“优雅”，却能从根本上规避诸多因环境残留或配置冲突引发的疑难杂症。请注意，全新安装后系统默认会启动新手指引，若您已是资深用户，建议在安装命令中加入 --no-onboard 参数以跳过此流程。

整个安装过程将自动完成，所需时间依据网络状况而定，请耐心等待脚本执行完毕。

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

若更新后出现启动失败或运行异常，首先不必慌张。OpenClaw 内置了强大的自诊断与修复工具。您可以通过执行下方命令，快速检查并自动修复一系列典型配置问题：

openclaw doctor --fix

v26.3.31 版本重要变更说明

在此版本中，一项关键的配置变更需引起高度重视。位于 openclaw.json 配置文件内，针对 agents 列表中每个智能体的 tools 配置项，此前允许同时设置的 allow 和 alsoAllow 字段，现已不再兼容。如果您的配置文件中仍保留此种写法，系统将会抛出明确的错误提示。修复方法非常简单：您只需选择保留 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 核心之后，务必同步更新其飞书插件。核心与插件之间的版本不匹配，是导致消息推送、指令响应等协作功能失常的常见原因。

适配 v26.3.31 核心的插件更新

为确保与上述核心版本兼容，请运行以下命令更新您的飞书插件至指定版本：

npx -y @larksuite/openclaw-lark@2026.4.1 update

以上便是关于 OpenClaw 更新与故障排查的核心要点。希望这份指南能为您带来帮助。接下来，让我们放松一下，转换话题。

我的龙虾日记