OpenClaw 3.8 更新说明
OpenClaw 3.8 稳定版已经发布。这次改动不算花哨，主要是把几个长期让人头疼的点补齐了：ACP 溯源、官方备份工具、Telegram 重复消息修复，以及一批安全和体验上的收尾工作。
ACP 溯源上线
这次最核心的变化是 ACP（Agent Communication Protocol）溯源机制。之前智能体拿到指令后，常见的问题不是'做不了'，而是'搞不清这条指令是谁发的、有没有权限'。现在每条指令都会带上电子标识，执行前先做身份和权限核验，出了问题也能回溯到具体操作人。
- 身份识别：每条指令自带电子标识，智能体可以区分发送者和入口。
- 权限核验：执行前先检查权限，避免越权动作。
- 责任追溯：出问题时能定位到具体操作和发起人。
openclaw backup 工具
官方把 openclaw backup 做成了单独的备份工具，支持配置备份和完整性校验。这个设计挺实用，尤其是升级前、重置前，不用再靠手工拷文件赌运气。
- 创建备份：
openclaw backup create - 验证备份：
openclaw backup verify - 灵活定制：可以只备份配置，也可以排除工作区数据。
- 完整性校验：备份文件包含 manifest 校验，便于确认数据没被破坏。
升级或重置配置时，系统也会主动提醒先备份一份。
Telegram 渠道优化
Telegram 通知重复推送的问题这版做了源头处理，新增了去重逻辑。对依赖告警渠道的人来说，这类修复比'功能新增'更值钱，至少不会让同一条消息反复刷屏。
安全修复
这次版本包含 12+ 项安全修复，补上了几个潜在漏洞。只要是公网环境在跑的，升级优先级都应该靠前一点。
细节优化
- TalkMode 静默超时：现在可以通过
talk.silenceTimeoutMs调整语音模式的等待时长。 - TUI 终端适配：会自动检测背景色并切换配色，也可以用
OPENCLAW_THEME=light手动指定亮色主题。 - GPT-5.4 能力释放：修正了
openai-codex模式下的上下文窗口限制，设置为 105 万 token + 12.8 万maxoutputtoken。 - Brave 搜索升级：新增 LLM 上下文模式，返回摘要片段和来源元数据。
- 系统兼容优化：修复 Podman + SELinux 兼容问题，Fedora / RHEL 用户不用再手动处理权限。
- Docker 镜像瘦身：清掉开发依赖和构建元数据，镜像体积更小。
升级教程
升级前准备
先停网关，再备份配置，最后清理残留进程。别嫌步骤琐碎，升级失败大多都卡在这些地方。
- 停止网关：
openclaw gateway stop - 备份配置文件：
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw_backup.json - 杀死残留进程：
pkill -f openclaw
如果有记忆文件，比如 MEMORY.md、SOUL.md 之类，也一起备份掉。
一、npm 全局安装
方式 1：升级到最新稳定版
export SHARP_IGNORE_GLOBAL_LIBVIPS=1
sudo npm install -g openclaw@latest --force --no-fund --no-audit
方式 2：升级到指定版本
export SHARP_IGNORE_GLOBAL_LIBVIPS=1
sudo npm install -g [email protected] --force --no-fund --no-audit
二、一键脚本升级
适合用官方脚本装上来的用户：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --upgrade
如果要装指定版本：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --version 2026.2.25
三、Docker 部署升级
# 停止并删除旧容器
docker stop openclaw
docker rm openclaw
# 拉取最新镜像
docker pull openclaw/openclaw:latest
# 或指定版本
docker pull openclaw/openclaw:2026.2.25
# 重新启动容器
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped openclaw/openclaw:latest
四、升级后验证
# 查看版本
openclaw --version
# 修复配置
openclaw doctor --fix
# 重启网关
openclaw gateway start
# 检查状态
openclaw gateway status
注意事项
- 备份配置：升级过程中可能会重置配置，先留一份备份更稳妥。
- Mac 环境：需要设置
SHARP_IGNORE_GLOBAL_LIBVIPS=1，避免依赖报错。 - 强制覆盖：加上
--force，能少碰一些残留问题。 - 刷新 PATH：如果出现
command not found，执行source ~/.zshrc或source ~/.bash_profile。
| 安装方式 | 核心命令 | 适用场景 |
|---|---|---|
| npm 全局 | sudo npm install -g openclaw@latest | 本地部署、开发者 |
| 一键脚本 | install.sh --upgrade | 新手、自动化 |
| Docker | docker pull + 重启 | 多环境、隔离部署 |
