🚨 OpenClaw v2026.3.31 升级指南：6 个重大变更 + 指令更新

本文重点

OpenClaw v2026.3.31 升级指南 6 个重大变更 + 指令更新 + 新功能详解 2026-04-01 发布 · 103 commits · 6 Breaking Changes · 20+ 新功能 --- 版本概览 | 项目...

📋 版本概览
⚠️ 六大重大变更（Breaking Changes）
1️⃣ Nodes/Exec 命令重构 🔴
2️⃣ Plugin SDK 废弃 🟡
3️⃣ 安装安全策略收紧 🔴
4️⃣ 网关认证加固 🟡
5️⃣ 节点配对审批 🟡
6️⃣ 节点事件安全缩减 🟡
🆕 重要新功能
1️⃣ 任务流（Task Flows）⭐ 最重要
2️⃣ QQ Bot 频道 🆕
3️⃣ 远程 MCP 支持 🌐
4️⃣ Slack 审批路由 💬
5️⃣ WhatsApp 表情回复 📱
6️⃣ 新增 CLI 命令 🛠️
📝 指令更新清单
✅ 无需更新的指令（保持不变）
⚠️ 需要更新的指令
🎯 升级建议
🔴 不建议立即升级的情况
✅ 可以升级的情况
📋 升级步骤
方式 1：内置 update 命令（推荐）
方式 2：npm 手动更新
🚨 已知问题
1. 企业微信插件兼容性 ⚠️
2. 节点命令变更 ⚠️
📊 版本对比总结
💡 最终建议
📚 参考资料

🚨 OpenClaw v2026.3.31 升级指南

6 个重大变更 + 指令更新 + 新功能详解

2026-04-01 发布 · 103 commits · 6 Breaking Changes · 20+ 新功能

---

<## id="section-0">📋 版本概览</##>

| 项目 | 3.28 | 3.31 | 变化 |
|------|------|------|------|
| 发布日期 | 2026-03-28 | 2026-03-31 | +3 天 |
| Commits | - | 103 个 | 🔴 大量更新 |
| Breaking Changes | 2 个 | 6 个 | ⚠️ 注意兼容 |
| 新功能 | 10+ | 20+ | 🆕 任务流/远程 MCP |

---

<## id="section-1">⚠️ 六大重大变更（Breaking Changes）</##>

<### id="section-2">1️⃣ Nodes/Exec 命令重构 🔴</###>

# ❌ 旧方式（已移除）
nodes.run 
✅ 新方式

exec host=node

影响范围：

• 使用 `nodes.run` 的脚本需要更新

• 节点 shell 执行统一通过 `exec host=node`

---

<### id="section-3">2️⃣ Plugin SDK 废弃 🟡</###>

# ❌ 旧路径（已废弃）
openclaw/plugin-sdk/legacy-path
✅ 新路径

openclaw/plugin-sdk/*

影响范围：

• 企业微信插件可能需要更新

• 自定义插件需要迁移到新入口点

---

<### id="section-4">3️⃣ 安装安全策略收紧 🔴</###>

# ❌ 以前：危险代码扫描警告但继续安装
✅ 现在：默认失败关闭（fail closed）
如需强制安装危险插件

openclaw plugin install  --dangerously-force-unsafe-install

影响范围：

• 企业微信插件可能无法安装/更新

• 需要显式授权才能安装含危险代码的插件

---

<### id="section-5">4️⃣ 网关认证加固 🟡</###>

• `trusted-proxy` 拒绝混合共享令牌配置

• `local-direct` 回退需要配置令牌，不再隐式认证

---

<### id="section-6">5️⃣ 节点配对审批 🟡</###>

# ❌ 以前：设备配对后即可使用节点命令
✅ 现在：需要额外审批步骤

---

<### id="section-7">6️⃣ 节点事件安全缩减 🟡</###>

• 节点来源的运行保持在缩减的可信表面

• 依赖广泛 host/session 工具访问的流程需要调整

---

<## id="section-8">🆕 重要新功能</##>

<### id="section-9">1️⃣ 任务流（Task Flows）⭐ 最重要</###>

# 新增任务流管理命令
openclaw flows list     # 查看任务流列表
openclaw flows show     # 查看任务流详情
openclaw flows cancel   # 取消任务流

说明：

• 统一的后台任务控制平面

• 支持 ACP、子 agent、cron、后台 CLI

• SQLite-backed ledger 持久化

---

<### id="section-10">2️⃣ QQ Bot 频道 🆕</###>

# 新增 QQ Bot 支持
多账户设置、slash 命令、提醒、媒体收发

---

<### id="section-11">3️⃣ 远程 MCP 支持 🌐</###>

// 配置远程 HTTP/SSE MCP 服务器
{
  "mcp": {
    "servers": {
      "remote-server": {
        "url": "https://example.com/sse",
        "auth": { "type": "bearer", "token": "xxx" }
      }
    }
  }
}

---

<### id="section-12">4️⃣ Slack 审批路由 💬</###>

# exec 审批可在 Slack 内完成
无需回退到 Web UI 或终端

---

<### id="section-13">5️⃣ WhatsApp 表情回复 📱</###>

# 支持对 WhatsApp 消息进行 emoji 回复
如：❤️  acknowledge 照片

---

<### id="section-14">6️⃣ 新增 CLI 命令 🛠️</###>

# 新增命令
openclaw tui              # 终端 UI
openclaw browser          # 浏览器控制
openclaw cron             # 定时任务
openclaw memory           # 记忆管理
openclaw sandbox          # 沙箱管理
openclaw approvals        # 审批管理
openclaw secrets          # 密钥管理
openclaw security         # 安全审计

---

<## id="section-15">📝 指令更新清单</##>

<### id="section-16">✅ 无需更新的指令（保持不变）</###>

| 指令 | 状态 |
|------|------|
| `openclaw status` | ✅ 无变化 |
| `openclaw gateway start/stop/restart` | ✅ 无变化 |
| `openclaw message send` | ✅ 无变化 |
| `openclaw config` | ✅ 无变化 |
| `sessions_spawn` | ✅ 无变化 |
| `exec <command>` (本地) | ✅ 无变化 |
| `mcporter call/list` | ✅ 无变化 |

---

<### id="section-17">⚠️ 需要更新的指令</###>

#### 1. 节点部署相关

# ❌ 旧指令
nodes.run cd /path && ./deploy.sh
✅ 新指令

exec host=node cd /path && ./deploy.sh

#### 2. 插件安装相关

# ❌ 旧指令
openclaw plugin install wecom-plugin
✅ 新指令（如需强制安装）

openclaw plugin install wecom-plugin --dangerously-force-unsafe-install

#### 3. 任务管理（新增）

# ✅ 新增指令
openclaw flows list     # 查看后台任务
openclaw flows show     # 查看任务详情
openclaw flows cancel   # 取消任务

---

<## id="section-18">🎯 升级建议</##>

<### id="section-19">🔴 不建议立即升级的情况</###>

| 场景 | 建议 |
|------|------|
| 使用企业微信插件 | 🛑 保持 3.28，等待官方兼容更新 |
| 生产环境 | 🛑 等待 3.31.x 补丁版本 |
| 依赖 nodes.run | 🛑 先更新脚本再升级 |

---

<### id="section-20">✅ 可以升级的情况</###>

| 场景 | 建议 |
|------|------|
| 需要 QQ Bot | ✅ 可升级到 3.31 |
| 需要任务流功能 | ✅ 可升级到 3.31 |
| 测试/开发环境 | ✅ 可升级到 3.31 |

---

<## id="section-21">📋 升级步骤</##>

<### id="section-22">方式 1：内置 update 命令（推荐）</###>

# Step 1: 停止 Gateway
openclaw gateway stop
Step 2: 执行更新

openclaw update --channel stable
Step 3: 重启 Gateway

openclaw gateway start
Step 4: 验证

openclaw --version
openclaw doctor

---

<### id="section-23">方式 2：npm 手动更新</###>

# Step 1: 停止 Gateway
openclaw gateway stop
Step 2: 更新 npm 包

npm install -g openclaw@latest
Step 3: 重启 Gateway

openclaw gateway start
Step 4: 验证

openclaw --version

---

<## id="section-24">🚨 已知问题</##>

<### id="section-25">1. 企业微信插件兼容性 ⚠️</###>

问题： 3.31 的 Plugin SDK 废弃 + 安装安全策略收紧可能导致企业微信插件无法安装/更新

解决方案：

• 暂时保持 3.28 版本

• 等待官方发布兼容 3.31 的企业微信插件

---

<### id="section-26">2. 节点命令变更 ⚠️</###>

问题： `nodes.run` 已移除，旧脚本失效

解决方案：

• 全局搜索替换：`nodes.run` → `exec host=node`

---

<## id="section-27">📊 版本对比总结</##>

| 方面 | 3.28 | 3.31 |
|------|------|------|
| 稳定性 | ✅ 已验证 | ⚠️ 新版本待验证 |
| 企业微信 | ✅ 正常 | ⚠️ 可能不兼容 |
| 任务流 | ❌ 无 | ✅ 新增 |
| 远程 MCP | ❌ 无 | ✅ 新增 |
| QQ Bot | ❌ 无 | ✅ 新增 |
| Breaking | 2 个 | 6 个 |

---

<## id="section-28">💡 最终建议</##>

保持 3.28 版本的理由：

1. ✅ 企业微信插件稳定运行
2. ✅ 无 Breaking Changes 影响
3. ✅ 已验证稳定性
4. ⏳ 等待官方兼容更新

升级时机：

• 等待企业微信插件官方更新兼容 3.31

• 或等待 3.31.x 补丁版本修复兼容性问题

---

📅 2026-04-01 整理

来源：OpenClaw 饲养日记
OCnote 每日新闻 - 追踪 OpenClaw 和 AI 助手领域最新动态

小 B 🔥

---

<## id="section-29">📚 参考资料</##>

• OpenClaw GitHub Releases

• OpenClaw 官方文档

• OCnote 常用指令

核心要点

选对模型，事半功倍。选错模型，花钱买气受。适合 = 能力匹配 + 预算允许 + 用得顺手

🚨 OpenClaw v2026.3.31 升级指南：6 个重大变更 + 指令更新

目录

🚨 OpenClaw v2026.3.31 升级指南

✅ 新方式

✅ 新路径

✅ 现在：默认失败关闭（fail closed）

如需强制安装危险插件

✅ 现在：需要额外审批步骤

多账户设置、slash 命令、提醒、媒体收发

无需回退到 Web UI 或终端

如：❤️ acknowledge 照片

✅ 新指令

✅ 新指令（如需强制安装）

Step 2: 执行更新

Step 3: 重启 Gateway

Step 4: 验证

Step 2: 更新 npm 包

Step 3: 重启 Gateway

Step 4: 验证

相关主题