OpenClaw 3.8 更新说明
OpenClaw 3.8 稳定版正式发布。此次更新聚焦用户核心痛点，引入 ACP 溯源机制，上线官方备份工具，修复 Telegram 消息重复问题，并完成多项安全修复与细节优化。
ACP 溯源上线
OpenClaw 3.8 引入 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 + 重启 | 多环境、隔离部署 |
