月度归档：2026年06月

OpenClaw 2026.5.31-beta.1 发布：5大核心改进与 Skill Workshop 新功能详解

——

OpenClaw 2026.5.31-beta.1 发布：5大核心改进与 Skill Workshop 新功能详解

一句话总结：本次更新让 AI Agent 运行更稳定、消息触达更可靠，并推出了全新的 Skill Workshop 技能开发框架，大幅降低自定义工具的开发门槛。

如果你正在使用 OpenClaw 构建自动化工作流，或计划为团队开发定制化 AI 技能，这篇文章将帮你快速掌握版本核心价值与落地方法。

—

一、AI Agent 稳定性全面升级

1.1 中断恢复与资源清理机制

过往版本中，Agent 在执行长任务时若遇到工具调用中断、会话过期或媒体传输失败，容易出现状态僵死。本次更新针对以下场景做了系统性修复：

| 场景 | 改进内容 | 相关 Issue |
|:—|:—|:—|
| 工具调用中断 | 更干净的运行时恢复 | #88129, #88136 |
| 会话绑定过期 | 自动清理 stale session | #88141 |
| 数据压缩切换 | 平滑的 compaction handoff | #88162 |
| 媒体重试 | 可控的 delivery retry 机制 | #88182 |

这些改进意味着你的 Agent 可以在容器重启、网络抖动等异常后自动恢复，无需人工介入。

1.2 请求超时与生命周期管控

新版本为 Provider 和插件请求增加了多层边界保护：

典型配置示例（config.yaml）
runtime:
  timers:
    oauth_lifetime: 3600s        # OAuth 令牌有效期
    device_code_timeout: 600s    # 设备码授权超时
  retries:
    media_download: 3            # 媒体下载重试次数
    content_polling: 30s         # 生成内容轮询间隔
  probes:
    local_service: 5s            # 本地服务健康检查

通过这些配置，可以确保任何外部依赖不会无限期阻塞 Agent 运行。

—

二、多平台消息通道稳定性增强

2.1 覆盖平台清单

本次优化覆盖 9 大主流通讯平台：

即时通讯：Telegram、WhatsApp、iMessage、Slack、Discord、Microsoft Teams、Google Chat
视频会议：Google Meet、iOS realtime Talk

2.2 关键改进点

对于需要高可靠消息触达的业务场景（如客服告警、交易通知），建议升级到本版本并启用通道健康检查：

检查通道状态
openclaw channel health --platform telegram,whatsapp

输出示例
telegram: ✅ healthy (latency: 45ms)
whatsapp: ⚠️ degraded (queue: 12 msgs, retrying...)

—

三、Skill Workshop：技能开发新范式

3.1 什么是 Skill Workshop？

Skill Workshop 是 OpenClaw 推出的受控技能开发框架，解决以往技能开发中的三大痛点：

1. 版本混乱 — 多人协作时技能版本冲突
2. 审核缺失 — 生产环境技能未经评审直接上线
3. 回滚困难 — 问题技能无法快速恢复

3.2 核心功能详解

#### 提案驱动的开发流程

1. 创建技能提案
openclaw skill propose --name "data_analyzer" --description "CSV数据分析工具"

2. 提交支持文件（代码、配置、依赖）
openclaw skill attach data_analyzer \
  --file ./src/analyzer.py \
  --file ./config/schema.json \
  --hash sha256:abc123...

3. 发起审核（CLI 或 Gateway）
openclaw skill review data_analyzer --action submit

4. 管理员审批（支持 apply / reject / quarantine）
openclaw skill review data_analyzer --action apply --by @admin

#### 版本化提案元数据

每个提案包含结构化前置信息：

.openclaw/proposals/data_analyzer/v1.2.0.yml
proposal:
  id: data_analyzer-20250601
  version: 1.2.0
  date: 2026-05-31T14:30:00Z
  author: @shakkernerd
  status: pending_revision  # pending | approved | rejected | quarantined
  
  # 自动生成的回滚元数据
  rollback:
    previous: 1.1.3
    snapshot: sha256:def456...

#### Agent 工具集成

通过 skill_workshop 工具，Agent 可直接参与技能生命周期：

// Agent 调用示例
const result = await agent.tools.skill_workshop({
  action: "list_proposals",      // 查看待审提案
  filter: "status:pending"
});

// 或自动应用已批准的提案
await agent.tools.skill_workshop({
  action: "apply",
  proposal_id: "data_analyzer-20250601"
});

3.3 完整开发指南

官方已发布 Skill Workshop 专项文档，涵盖：

受控技能创建规范
CLI 与 Gateway 双模式操作
Agent 工具行为配置
审批策略与文件扫描
故障恢复流程

—

四、插件生态扩展：Tokenjuice 与 GitHub Copilot

4.1 官方插件外部化

两个核心运行时正式拆分为独立插件，便于按需安装和版本管理：

| 插件 | 用途 | 安装命令 |
|:—|:—|:—|
| @openclaw/tokenjuice | 令牌管理与成本优化 | npm install @openclaw/tokenjuice |
| @openclaw/copilot | GitHub Copilot Agent 运行时 | npm install @openclaw/copilot |

4.2 ClawHub 发布支持

两个插件已上架 ClawHub 插件市场，支持：

通过 CLI 安装
openclaw plugin install @openclaw/tokenjuice --version latest

查看插件元数据
openclaw plugin info @openclaw/copilot
输出：OAuth 配置、LLM 核心依赖、设备码流程等

—

五、Workboard 与多 Agent 编排

5.1 新增编排原语

Workboard 模块新增多 Agent 规划与运行追踪能力：

workboard 配置示例
orchestration:
  planning:
    mode: multi_agent           # 单 Agent / 多 Agent / 分层
    coordination: shared_state  # 状态共享策略
  
  tracking:
    run_id: "{{ .Run.ID }}"
    agents:
      - name: researcher
        role: data_collection
      - name: analyst
        role: insight_generation
        depends_on: [researcher]

5.2 典型应用场景

复杂报告生成：Researcher Agent 收集数据 → Analyst Agent 生成洞察 → Reviewer Agent 质量检查
客服工单分级：Intent Agent 识别意图 → Priority Agent 评估紧急度 → Route Agent 分配坐席

—

六、其他重要更新

—

常见问题 FAQ

Q1: Skill Workshop 与旧版技能开发有什么区别？

旧版技能直接修改文件系统，无版本控制和审核流程。Skill Workshop 引入提案-审核-发布三段式流程，所有变更需经评审后方可生效，支持原子化回滚，适合团队协作和生产环境。

Q2: 如何迁移现有技能到 Skill Workshop？

1. 导出现有技能
openclaw skill export --name my_skill --output ./backup

2. 创建提案并导入
openclaw skill propose --name my_skill --import ./backup
按提示补充元数据和审核人

3. 提交审核
openclaw skill review my_skill --action submit

Q3: Telegram/WhatsApp 通道优化需要额外配置吗？

默认启用，无需修改。如需调整重试策略，可在 channels.yaml 中覆盖：

channels:
  telegram:
    retry:
      max_attempts: 5
      backoff: exponential
  whatsapp:
    queue:
      max_size: 1000
      ttl: 300s

Q4: Tokenjuice 插件能解决什么问题？

Tokenjuice 提供令牌池管理、成本预算控制、用量告警功能，特别适合多团队共享 LLM 配额的场景。安装后通过 openclaw token budget set --monthly 1000USD 即可启用。

Q5: 本次更新是否涉及破坏性变更？

无破坏性变更。所有新功能均为增量添加，旧配置完全兼容。建议升级前执行：

openclaw doctor --check-config
验证配置兼容性

—

总结与下一步

OpenClaw 2026.5.31-beta.1 的核心价值在于稳定性基建与开发体验升级：

1. ✅ Agent 运行更 resilient，异常自动恢复
2. ✅ 消息通道覆盖更广、投递更可靠
3. ✅ Skill Workshop 降低自定义工具开发门槛
4. ✅ 插件生态规范化，便于扩展

建议行动：

立即下载并测试 Skill Workshop
阅读完整更新日志了解细节
关注 OpenClaw 文档获取最新教程

—

参考来源

OpenClaw v2026.5.31-beta.3 发布：7大核心改进与 Skill Workshop 新功能详解

——

OpenClaw v2026.5.31-beta.3 发布：7大核心改进与 Skill Workshop 新功能详解

OpenClaw 最新测试版 v2026.5.31-beta.3 已正式发布，本次更新聚焦于 AI Agent 运行稳定性、多通道消息交付可靠性 以及 Skill 开发工作流的标准化。无论你是构建企业级自动化工作流的开发者，还是部署多平台客服机器人的运维工程师，这篇文章将帮你快速定位关键变更，避免升级踩坑。

—

一、Skill Workshop：治理化的 Skill 开发新范式

本次更新最重磅的功能是 Skill Workshop 的完整落地——这是一个面向团队协作的 Skill 生命周期管理平台。

1.1 什么是 Skill Workshop？

传统 Skill 开发中，代码变更直接生效，缺乏审核机制。Skill Workshop 引入了提案驱动的开发模式：

1.2 快速上手：创建你的第一个提案

初始化 Skill 提案
openclaw skill workshop init --name "customer-support-v2" --proposal "add-sentiment-analysis"

添加支持文件（会被扫描和哈希保护）
openclaw skill workshop add-file ./sentiment_model.py --to-proposal "add-sentiment-analysis"

提交审核
openclaw skill workshop submit --proposal "add-sentiment-analysis" --message "集成情感分析模块"

Gateway 管理员审核
openclaw skill workshop review --proposal "add-sentiment-analysis" --action apply

> 关键提示：提案通过前，SecretRef 等敏感配置处于禁用状态，防止未授权访问。

—

二、多通道稳定性：Telegram、WhatsApp、Discord 等 8 大平台全面优化

消息通道的可靠性直接影响用户体验。本次更新针对以下平台进行了深度优化：

即时通讯：Telegram、WhatsApp、iMessage、Slack、Discord、Microsoft Teams、Google Chat
会议系统：Google Meet、iOS realtime Talk

2.1 核心改进点

2.2 Gateway 配置增强

新增 Tailscale Serve 服务名绑定支持，简化内网穿透配置：

gateway.yaml
channels:
  telegram:
    tailscale_serve:
      service_name: "telegram-bot"
      funnel: true
  discord:
    notification_settings:
      on_agent_error: true      # Agent 异常时通知
      on_delivery_retry: true   # 投递重试时通知

—

三、核心插件外置化：Tokenjuice 与 GitHub Copilot

OpenClaw 正逐步将官方功能模块化，本次将两大核心能力转为独立插件：

3.1 @openclaw/tokenjuice

Tokenjuice 是 OpenClaw 的令牌经济与资源调度引擎，现可通过 npm 独立安装：

npm install @openclaw/tokenjuice

外置化带来的优势：

版本独立迭代，不依赖核心发布周期
支持自定义资源策略插件
ClawHub 市场直接分发

3.2 @openclaw/copilot

GitHub Copilot 运行时插件化后，开发者可：

安装 Copilot 插件
openclaw plugin install @openclaw/copilot

配置多模型路由
openclaw copilot config --model "gpt-4o" --fallback "claude-3-5-sonnet"

—

四、运行时稳定性：从”能跑”到”稳跑”

4.1 中断恢复机制

Agent 和 CLI 运行时现在能更优雅地处理：

中断的工具调用：保存中间状态，支持断点续传
压缩交接（compaction handoff）：大状态迁移时不丢失上下文
媒体投递重试：指数退避 + 抖动，避免服务过载

4.2 防悬挂（Anti-Hang）设计

Provider 和插件请求增加了多层边界保护：

// 示例：插件配置中的超时边界
{
  "provider": "openai",
  "request_boundaries": {
    "timer_ms": 30000,           // 硬超时
    "retry_max": 3,              // 最大重试
    "oauth_lifetime_s": 3600,    // OAuth 令牌有效期
    "media_download_timeout_ms": 10000,
    "content_poll_interval_ms": 500
  }
}

—

五、iOS 移动端：推送与会话体验升级

针对 iOS 用户的三大改进：

配置示例：

ios_push.yaml
push_relay:
  hosted: true           # 使用 OpenClaw 托管中继
  apns_topic: "com.yourapp.openclaw"
  
realtime_talk:
  playback_buffer_ms: 50
  websocket:
    guarded_ping: true   # 启用防护 ping
    ping_interval_s: 30

—

六、Workboard：编排原语与 Agent 协调

Workboard 是 OpenClaw 的新概念——一个可视化的 Agent 协作画布。本次更新加入了：

编排原语（Orchestration Primitives）：定义 Agent 间的依赖与触发条件
Agent 协调协议：多 Agent 任务分配与结果聚合

典型应用场景：复杂审批工作流中，多个专项 Agent 并行处理不同维度，Workboard 统一调度。

—

七、CI/CD 与可观测性：失败有界，排查有据

发布流水线增加了多项”防御性”配置：

.github/workflows/openclaw-ci.yml

name: Bounded Diagnostics

  env:
    MAX_LOG_LINES: 10000          # 日志上限
    MAX_RESPONSE_BODY_BYTES: 1048576  # 响应体 1MB 截断
    READINESS_PROBE_TIMEOUT_S: 60
    ARTIFACT_CHECK_RETRIES: 5

核心理念：失败时提供有限但完整的证据，而非无限期挂起。

—

常见问题（FAQ）

Q1: Skill Workshop 是否强制使用？现有 Skill 会受影响吗？

现有 Skill 保持兼容，但新创建 Skill 默认启用 Workshop 工作流。建议团队逐步迁移，以获得审核与回滚保护。

Q2: Tokenjuice 插件化后，原有配置需要修改吗？

v2026.5.31-beta.3 保持向后兼容，自动加载外置插件。建议在下一个主版本发布前，显式安装 @openclaw/tokenjuice 以避免未来 breaking change。

Q3: 多通道优化是否需要手动更新 Gateway 配置？

大部分优化自动生效。若使用 Tailscale Serve 或通知设置，需参考上文配置示例手动启用。

Q4: iOS 推送中继的隐私合规性如何？

托管中继仅传输设备令牌与加密载荷，不存储消息内容。支持自托管中继以满足更高合规要求。

Q5: 如何验证 Agent 中断恢复是否正常工作？

使用 CLI 的 --simulate-interrupt 标志测试：

openclaw agent run --simulate-interrupt --tool "long-running-task"

—

总结与下一步

OpenClaw v2026.5.31-beta.3 的更新围绕 “治理”、“稳定”、“开放” 三个关键词展开：

1. Skill Workshop 让团队协作有章可循
2. 多通道与运行时优化 让生产环境更加可靠
3. 插件外置化 让生态扩展更加灵活

建议行动：

[ ] 在测试环境启用 Skill Workshop，评估工作流适配度
[ ] 检查现有 Gateway 配置，启用 Tailscale Serve 等新特性
[ ] 订阅 OpenClaw 文档获取正式版发布通知

—

OpenClaw 2026.5.31-beta.1 发布：5大核心改进与 Skill Workshop 新功能详解

一、AI Agent 稳定性全面升级

1.1 中断恢复与资源清理机制

1.2 请求超时与生命周期管控

典型配置示例（config.yaml）

二、多平台消息通道稳定性增强

2.1 覆盖平台清单

2.2 关键改进点

检查通道状态

输出示例

telegram: ✅ healthy (latency: 45ms)

whatsapp: ⚠️ degraded (queue: 12 msgs, retrying...)

三、Skill Workshop：技能开发新范式

3.1 什么是 Skill Workshop？

3.2 核心功能详解

1. 创建技能提案

2. 提交支持文件（代码、配置、依赖）

3. 发起审核（CLI 或 Gateway）

4. 管理员审批（支持 apply / reject / quarantine）

.openclaw/proposals/data_analyzer/v1.2.0.yml

3.3 完整开发指南

四、插件生态扩展：Tokenjuice 与 GitHub Copilot

4.1 官方插件外部化

4.2 ClawHub 发布支持

通过 CLI 安装

查看插件元数据

输出：OAuth 配置、LLM 核心依赖、设备码流程等

五、Workboard 与多 Agent 编排

5.1 新增编排原语

workboard 配置示例

5.2 典型应用场景

六、其他重要更新

常见问题 FAQ

Q1: Skill Workshop 与旧版技能开发有什么区别？

Q2: 如何迁移现有技能到 Skill Workshop？

1. 导出现有技能

2. 创建提案并导入

按提示补充元数据和审核人

3. 提交审核

Q3: Telegram/WhatsApp 通道优化需要额外配置吗？

Q4: Tokenjuice 插件能解决什么问题？

Q5: 本次更新是否涉及破坏性变更？

验证配置兼容性

总结与下一步

相关阅读

参考来源

OpenClaw v2026.5.31-beta.3 发布：7大核心改进与 Skill Workshop 新功能详解

一、Skill Workshop：治理化的 Skill 开发新范式

1.1 什么是 Skill Workshop？

1.2 快速上手：创建你的第一个提案

初始化 Skill 提案

添加支持文件（会被扫描和哈希保护）

提交审核

Gateway 管理员审核

二、多通道稳定性：Telegram、WhatsApp、Discord 等 8 大平台全面优化

2.1 核心改进点

2.2 Gateway 配置增强

gateway.yaml

三、核心插件外置化：Tokenjuice 与 GitHub Copilot

3.1 @openclaw/tokenjuice

3.2 @openclaw/copilot

安装 Copilot 插件

配置多模型路由

四、运行时稳定性：从”能跑”到”稳跑”

4.1 中断恢复机制

4.2 防悬挂（Anti-Hang）设计

五、iOS 移动端：推送与会话体验升级

ios_push.yaml

六、Workboard：编排原语与 Agent 协调

七、CI/CD 与可观测性：失败有界，排查有据

.github/workflows/openclaw-ci.yml

常见问题（FAQ）

Q1: Skill Workshop 是否强制使用？现有 Skill 会受影响吗？

Q2: Tokenjuice 插件化后，原有配置需要修改吗？

Q3: 多通道优化是否需要手动更新 Gateway 配置？

Q4: iOS 推送中继的隐私合规性如何？

Q5: 如何验证 Agent 中断恢复是否正常工作？

总结与下一步

相关阅读

参考来源