——
OpenClaw v2026.5.10-beta.1 发布：5 大核心功能升级与 Telegram/Discord 自动化实战
OpenClaw 作为新一代 AI Agent 编排平台，在 2026.5.10-beta.1 版本中带来了多项生产级功能强化。本文将解析 5 个最值得开发者关注的核心更新，涵盖 Telegram 自动化测试、Discord 实时语音诊断、私有 Skill 安全安装 等场景，并提供可直接落地的配置方案。
—
一、Telegram 自动化测试：从 PR 证据到场景构建
1.1 PR 证据自动化采集
新版本为 QA/Mantis 模块引入了完整的 Telegram 直播测试流水线，核心能力包括：
| 功能组件 | 技术实现 | 价值 |
|———|———|——|
| 凭证租赁 | Convex-leased credentials | 动态获取测试账号，隔离生产环境 |
| 会话捕获 | Crabbox transcript capture | 自动记录完整对话文本 |
| 可视化预览 | Motion GIF previews | 生成动态演示图，嵌入 PR 评论 |
典型工作流配置：
openclaw.config.yaml
qa:
mantis:
telegram:
evidence:
enabled: true
credentialProvider: "convex"
captureModes: ["transcript", "screenshot", "gif"]
prComment:
inline: true
template: "evidence-v2"
1.2 桌面端场景构建器
针对需要 原生 Telegram Desktop 验证的场景，新版本支持一键租赁 Crabbox 虚拟环境：
启动 Telegram 桌面测试场景
openclaw qa mantis telegram-desktop --lease \
--install-native \
--gateway-config ./tg-gateway.yaml \
--record-artifacts vnc,mp4
该命令会自动：
1. 租赁 Crabbox 实例
2. 安装原生 Telegram Desktop
3. 配置 OpenClaw Telegram Gateway（使用租赁的 Bot 凭证）
4. 录制 VNC 截图与视频证据
> 适用场景：验证桌面端特定渲染问题、测试原生通知行为、复现客户端兼容性问题。
—
二、Discord 实时语音：诊断能力全面升级
2.1 语音会话健康监测
Discord/voice 模块新增实时诊断矩阵，覆盖 4 类关键指标：
// 语音诊断事件监听示例
const { VoiceDiagnostics } = require('@openclaw/discord-voice');
const diagnostics = new VoiceDiagnostics({
speakerTurns: true, // 说话者轮换检测
playbackResets: true, // 播放重置追踪
bargeInDetection: true, // 插话识别
audioCutoff: true // 音频截断分析
});
diagnostics.on('anomaly', (event) => {
console.log([${event.type}] ${event.description}: ${event.metrics});
});
2.2 解码器优化：纯 JS 方案默认化
为避免非语音专用通道的编译耗时，测试环境和源码安装现默认使用 opusscript 纯 JS 解码器：
强制使用纯 JS 解码器（推荐用于 CI/CD）
OPENCLAW_DISCORD_VOICE_DECODER=opusscript npm install
生产语音高性能通道启用原生解码
OPENCLAW_DISCORD_VOICE_DECODER=@discordjs/opus npm install \
--build-from-source
—
三、Talk 实时语音：动态指令注入
3.1 运行时风格控制
新增的 talk.realtime.instructions 接口允许操作员在保持 OpenClaw 内置 agent-consult 指导 的前提下，追加实时语音风格指令：
实时语音配置片段
talk:
realtime:
instructions:
# 用户自定义风格（追加）
userAppend: |
使用简洁的技术说明风格，避免冗长问候。
遇到代码问题时，先给出关键行号，再解释原理。
# OpenClaw 内置指导（保留，不可覆盖）
agentConsult: preserved
关键设计：#79081 的合并确保了 系统级指导 与 用户级风格 的层级隔离，防止操作员意外破坏核心对话策略。
—
四、Gateway Skills：私有安全安装通道
4.1 受控的归档上传机制
针对企业内网或合规场景，新增 opt-in 私有 Skill 安装路径，通过 skills.install.allowUploadedArchives 显式控制：
gateway.config.yaml（服务端）
skills:
install:
allowUploadedArchives: true # 必须显式启用
allowedSources:
- "internal-s3://skill-archives/"
- "file:///opt/openclaw/staged-skills/"
maxSize: "50MB"
scanPolicy: "clamav+static-analysis"
客户端上传安装（需 Gateway 授权）
openclaw skills install ./custom-skill.zip \
--source upload \
--gateway https://gateway.company.internal \
--verify-signature
安全设计要点：
- 默认关闭，需运营人员显式开启代码安装面
- 支持 zip 归档的预扫描与签名验证
- 审计日志记录完整安装链条
—
五、依赖升级与稳定性修复
5.1 核心依赖版本刷新
| 包名 | 旧版本 | 新版本 | 关键改进 |
|—–|——–|——–|———|
| @agentclientprotocol/claude-agent-acp | – | 0.33.1 | ACPX 协议兼容 |
| @openai/codex | – | 0.14.0 | Codex 工具链集成 |
| baileys | – | 7.0.0-rc10 | WhatsApp 协议更新 |
| @google/genai | – | 2.0.1 | Gemini 多模态增强 |
| openai | – | 6.37.0 | Realtime API 稳定 |
| aws-sdk | – | 3.1045.0 | 新区域支持 |
| kysely | 0.28.x | 0.29.0 | 查询构建器优化 |
5.2 关键 Bug 修复
LLM 空闲看门狗（#80106）
修复前：流建立前挂起无检测
修复后：provider stream setup 阶段即激活 watchdog
agents:
llm:
idleWatchdog:
enabled: true
preStreamTimeout: "30s" # 新增：流建立阶段超时
postStreamTimeout: "120s"
Cron 自清理隔离（#80019）
- 允许孤立自清理任务检查自身历史记录
- 同时保持其他 Cron 任务和变更操作的阻塞隔离
配置持久化（#79856）
修复前：显式设置为默认值会被丢弃
openclaw config set log.level info # 若 info 为默认值，实际未保存
修复后：显式值始终持久化，无论是否等于运行时默认
openclaw config set log.level info # ✅ 确认写入
—
常见问题 FAQ
Q1: 如何快速启用 Telegram PR 证据自动化？
需要三步配置：1) 在 Convex 控制台创建凭证池；2) 在 openclaw.config.yaml 中配置 qa.mantis.telegram.evidence；3) 确保 CI 环境有 OPENCLAW_CONVEX_TOKEN。详见 OpenClaw QA 文档。
Q2: Discord 语音诊断对性能有影响吗？
诊断模块采用采样模式，默认仅采集 5% 的会话指标。生产环境可通过 diagnostics.samplingRate 调整，或完全关闭非关键指标。
Q3: 私有 Skill 安装是否支持 GitHub Actions？
支持。在 Workflow 中使用 openclaw skills install 配合 --source upload 和 --gateway 参数，需提前将 Gateway 凭证存入 Repository Secrets。
Q4: Codex 动态工具配置为何被移除？
#80106 后，Codex 应用服务器固定拥有 workspace、edit、patch、exec、process、plan 工具，OpenClaw 集成工具保持可用。此举消除了工具权限的模糊边界，提升安全性。
Q5: 升级后 Cron 任务行为有变化吗？
仅影响孤立自清理任务。其他 Cron 任务的隔离策略不变。若依赖历史记录查询，建议检查 cron.isolation.selfCleanup 配置。
—
总结与下一步
OpenClaw v2026.5.10-beta.1 的核心价值在于：测试自动化闭环、语音可靠性提升、企业安全合规。建议开发者：
1. 立即体验：在测试环境启用 Telegram 证据自动化
2. 评估升级：检查现有 Discord 语音通道的解码器配置
3. 安全审计：若需私有 Skill 安装，制定 allowUploadedArchives 的启用策略
—
相关阅读
—
参考来源
