🔥 OpenClaw 2026.3.13 重磅更新：修复与优化齐飞，迎来全新体验OpenClaw 2026.3.13

**紧急修复版本！** OpenClaw 2026.3.13 带来 60+ 项修复与优化，重点解决之前版本中的多个关键问题，同时新增多项实用功能！

📋 版本概览

项目	信息
版本号	2026.3.13
Git Tag	v2026.3.13-1
发布类型	紧急修复版本（Recovery Release）
发布原因	恢复损坏的 v2026.3.13 tag/release 路径
npm 版本	2026.3.13（不是 v2026.3.13-1）
发布日期	2026年3月14日

⚠️ 说明：由于 GitHub immutable releases 不允许在发布后重复使用 v2026.3.13，因此使用 v2026.3.13-1 作为恢复版本。npm 包版本仍然是 2026.3.13，-1 后缀仅用于 Git tag 和 GitHub Release。

🎯 本次更新重点

一、核心修复（Critical Fixes）

1.1 压缩模块修复

问题：压缩后的会话 token 计数不准确

修复：使用完整的会话 token 数量进行压缩后的完整性检查

# 配置压缩后 token 检查
agents:
  defaults:
    compaction:
      # 确保压缩后 token 数量准确
      postCompactionCheck: true

1.2 Telegram 安全修复

问题：线程媒体传输策略未正确应用到 SSRF 检查

修复：将线程媒体传输策略正确集成到 SSRF 安全检查中

# Telegram 媒体安全配置
channels:
  telegram:
    media:
      # 启用 SSRF 保护
      ssrfProtection: true

1.3 Discord 网关元数据获取

问题：Discord 网关元数据获取失败导致连接不稳定

修复：增强错误处理和重试机制

二、Agent 引擎优化

2.1 思考块处理优化

问题：Anthropic 思考块在会话重放时被错误注入

修复：在重放时正确丢弃 Anthropic 思考块

// 配置思考块处理
agents:
  defaults:
    # 丢弃重放时的思考块
    dropThinkingOnReplay: true

2.2 会话重置提示优化

问题：会话重置提示触发 Azure 内容过滤器

修复：优化提示措辞，避免触发内容过滤

# 优化后的会话重置提示
agents:
  defaults:
    resetPrompt: "让我们开始一个新的会话。"

2.3 记忆文件注入优化

问题：在大小写不敏感的文件挂载上，记忆文件被注入两次

修复：避免在大小写不敏感挂载上重复注入记忆文件

2.4 用户兼容覆盖保留

问题：非原生 openai-completions 的用户显式兼容覆盖未生效

修复：正确保留用户的显式兼容覆盖设置

# 保持用户自定义的兼容设置
models:
  providers:
    openai-completions:
      userCompatOverrides:
        # 用户自定义的兼容配置会被保留
        enabled: true

三、平台与客户端更新

3.1 Android 客户端

聊天设置 UI 重新设计

全新设计的聊天设置界面
使用 Google Code Scanner 替换原有二维码扫描器
修复 HttpURLConnection 内存泄漏问题

# Android 构建注意
# 需要 Google Play Services Code Scanner 库
dependencies {
    implementation 'com.google.android.gms:code-scanner:16.0.0'
}

3.2 iOS 客户端

新增： onboarding 欢迎页面

全新的首次启动欢迎动画
改进的引导流程

3.3 macOS 优化

执行批准设置

// ~/.openclaw/exec-approvals.json
{
  "macos": {
    "respectSystemSettings": true,
    "promptForApproval": true
  }
}

PortGuard 优化

问题：PortGuard 误杀 Docker Desktop（远程模式）

修复：在远程模式下正确识别 Docker Desktop 进程

# 配置 PortGuard
security:
  portGuard:
    # 不杀死 Docker Desktop
    excludeDockerDesktop: true

四、Slack 深度集成

4.1 交互式回复功能

新增 Slack 交互式回复支持：

channels:
  slack:
    # 启用交互式回复
    interactiveReplies:
      enabled: true
      # 回复选项
      options:
        - label: "👍 确认"
          value: "confirm"
        - label: "👎 拒绝"
          value: "reject"

使用示例：

// 在 Slack 中使用交互式回复
await channel.send({
  text: "请确认您的操作",
  response_action: "immediate",
  attachments: [{
    text: "选择操作",
    callback_id: "confirm_action",
    actions: [
      {
        name: "confirm",
        text: "确认",
        type: "button",
        value: "confirm"
      },
      {
        name: "reject",
        text: "拒绝",
        type: "button",
        value: "reject"
      }
    ]
  }]
});

五、Docker 优化

5.1 时区支持

新增 OPENCLAW_TZ 环境变量支持：

# 设置时区
docker run -e OPENCLAW_TZ=Asia/Shanghai openclaw:latest

# 或在 docker-compose 中
environment:
  - OPENCLAW_TZ=Asia/Shanghai

5.2 构建安全加固

修复：防止 Docker 构建上下文中 Gateway token 泄露

# 构建安全最佳实践
# 1. 使用 .dockerignore 排除敏感文件
# 2. 不要在构建时传递 token
# 3. 使用多阶段构建

5.3 apt-get 升级

所有 Dockerfile 添加 apt-get upgrade，确保安全补丁生效：

RUN apt-get update && apt-get upgrade -y && \
    apt-get clean && rm -rf /var/lib/apt/lists/*

六、UI/控制台改进

6.1 移动端导航优化

移动端导航抽屉优化
主题变体改进
聊天上下文提示图标尺寸修复

6.2 聊天历史优化

问题：仪表板聊天历史加载风暴

修复：优化加载逻辑，减少不必要的请求

6.3 超大回复渲染

问题：超长聊天回复难以阅读

修复：保持超大聊天回复的可读性

/* UI 样式优化 */
.chat-message {
  max-width: 100%;
  word-wrap: break-word;
  overflow-x: visible;
}

6.4 滚动体验优化

问题：滚动药丸按钮的 chat-new-messages 类丢失

修复：恢复正确的类名，确保滚动时正确显示新消息提示

七、安全修复

7.1 Docker 安全

问题：Docker 构建上下文中 Gateway token 可能泄露

修复：

强化 .dockerignore
安全的环境变量处理
多阶段构建优化

7.2 飞书安全

问题：文件上传时非 ASCII 文件名处理不当

修复：正确保留非 ASCII 文件名

# 飞书配置
channels:
  feishu:
    # 保留非 ASCII 文件名
    preserveNonAsciiFilenames: true

八、模型与 Provider 优化

8.1 默认模型更新

旧默认模型	新默认模型
openai-codex/gpt-5.3-codex	openai-codex/gpt-5.4

8.2 Gemini 模型规范化

修复：将 Gemini 模型 ID 规范化应用到 google-vertex provider

models:
  providers:
    google-vertex:
      # 自动规范化模型 ID
      normalizeModelIds: true

8.3 Ollama 优化

问题：原生推理-only 输出暴露

修复：隐藏 Ollama 原生推理-only 输出

models:
  providers:
    ollama:
      # 隐藏推理-only 输出
      hideReasoningOnlyOutput: true

九、配置系统改进

9.1 Config Schema 修复

问题：agents.list[] 验证 schema 缺少 params 字段

修复：添加缺失的 params 字段到验证 schema

agents:
  list:
    - id: "my-agent"
      model: "gpt-4"
      # 现在支持 params 配置
      params:
        temperature: 0.7
        maxTokens: 2000

9.2 启动崩溃修复

问题：Anthropic 启动时崩溃

修复：修复导致启动崩溃的配置问题

9.3 Web Fetch 配置恢复

问题：Firecrawl 配置在运行时丢失

修复：恢复 Web fetch Firecrawl 配置到运行时 zod schema

十、工作流与 Cron 优化

10.1 Cron 死锁修复

问题：隔离 Cron 嵌套车道死锁

修复：防止孤立 Cron 嵌套车道死锁

cron:
  # 防止嵌套死锁
  preventNestedDeadlock: true

10.2 更新器刷新优化

问题：服务重装时更新器刷新失败

修复：保护更新器服务刷新，防止缺失的 invocation cwd 问题

🔧 关键操作命令

环境配置

# 查看版本
openclaw --version

# 检查更新
openclaw update check

# 更新 OpenClaw
openclaw update install

# 重启 Gateway
openclaw gateway restart

Docker 相关

# 构建带时区的镜像
docker build --build-arg OPENCLAW_TZ=Asia/Shanghai -t openclaw:custom .

# 运行带时区的容器
docker run -d -e OPENCLAW_TZ=Asia/Shanghai openclaw:latest

Agent 管理

# 列出所有 Agent
openclaw agents list

# 查看 Agent 详情
openclaw agents get <agent-id>

# 重置 Agent 会话
openclaw agents reset <agent-id>

Cron 任务

# 列出 Cron 任务
openclaw cron list

# 添加新任务
openclaw cron add --schedule "0 9 * * *" --message "每日提醒"

# 运行任务
openclaw cron run <job-id>

配置管理

# 查看当前配置
openclaw config show

# 设置配置项
openclaw config set agents.defaults.compaction.postCompactionCheck true

# 验证配置
openclaw config validate

🐛 修复的 Bug 汇总

类别	修复数量	关键修复
Agent 引擎	15+	思考块处理、会话重置、记忆文件注入
平台客户端	10+	Android/iOS/macOS 多项修复
UI/控制台	8+	渲染、滚动、导航优化
安全	5+	Docker token 泄露、飞书文件名
配置	6+	Schema 验证、启动崩溃
网络	4+	Discord 元数据、Telegram 媒体
Cron	3+	死锁、更新器刷新

👥 新贡献者

本次版本有 19 位新贡献者 首次贡献代码：

@jrrcdev - 默认模型更新
@Kaneki-x - Android HttpURLConnection 修复
@cheapestinference - 用户兼容覆盖
@xingsy97 - Config 测试覆盖
@atian8179 - Config schema 修复
@keepitmello - 压缩摘要人设保持
@moshehbenavraham - 跨 Agent 子 Agent 启动
@keelanfh - Brave 成本文档修复
@Cafexss - Slack probe 优化
@Astro-Han - UI 滚动修复
@eengad - Android 发布说明
@jacobtomlinson - Docker apt-get 升级
@fabiaodemianyang - 飞书文件名修复
@sliekens - macOS 执行批准
@teslamint - PortGuard Docker 优化
@yunweibang - 飞书重复回复防护

感谢所有贡献者的辛勤付出！ 🎉

📚 参考资料

官方资源

📝 升级建议

**升级步骤**：

备份当前配置

openclaw config export > config-backup.yaml

更新 OpenClaw

npm update openclaw
# 或
openclaw update install

重启 Gateway 服务
```
openclaw gateway restart
```
验证所有功能正常
```
openclaw doctor
```

📊 总结

OpenClaw 2026.3.13 是一个重要的修复版本，主要特点：

✅ 60+ 项修复：涵盖 Agent 引擎、平台客户端、UI、安全等多个领域
✅ 新功能：Docker 时区支持、Slack 交互式回复、默认模型更新
✅ 安全性提升：修复 Docker token 泄露、飞书文件名处理等问题
✅ 稳定性增强：多项崩溃和死锁问题得到解决

强烈建议所有用户升级到此版本！

本文基于 OpenClaw v2026.3.13-1 版本编写

感谢 19 位新贡献者和所有社区成员的付出！

🔥 OpenClaw 2026.3.13 重磅更新：修复与优化齐飞，迎来全新体验