一句话总结
OpenClaw 2026.4.5 是 2026 年 Q2 最重要的功能更新版本，首次为 AI Agent 内置视频与音乐生成能力，同时带来 12 语言本地化、ComfyUI 深度集成，以及更安全的配置体系重构。
为什么需要关注这次更新？
如果你正在使用 OpenClaw 构建自动化工作流或 AI Agent 应用，本次更新解决了三个核心痛点：
- 配置混乱：清理了遗留的别名配置，统一使用标准路径
- 媒体生成缺失：Agent 终于能直接生成视频、音乐并返回给用户
- 本地化不足：控制面板新增 12 种语言支持，降低团队使用门槛
以下是完整的功能解析与升级实操指南。
—
破坏性变更：配置体系重构（必看）
移除的遗留配置别名
本次更新清理了多个历史遗留的配置别名，统一迁移到标准路径：
• 旧配置路径：talk.voiceId / talk.apiKey；新配置路径：speech.provider.*；说明：语音服务配置
• 旧配置路径：agents..sandbox.perSession；新配置路径：agents..sandbox.enabled；说明：沙箱会话控制
• 旧配置路径：browser.ssrfPolicy.allowPrivateNetwork；新配置路径：browser.security.*；说明：浏览器安全策略
• 旧配置路径：hooks.internal.handlers；新配置路径：hooks.*.enabled；说明：钩子处理器开关
• 旧配置路径：频道/群组 allow 开关；新配置路径：enabled 布尔值；说明：统一启用标识
自动迁移命令
OpenClaw 提供内置迁移工具，无需手动修改配置文件：
检查当前配置兼容性
openclaw doctor
自动修复所有可迁移项
openclaw doctor --fix
查看具体变更预览（不执行）
openclaw doctor --dry-run
> ⚠️ 重要：--fix 会修改配置文件，建议先备份 ~/.openclaw/config.yaml。
—
AI Agent 媒体生成能力全面升级
1. 视频生成工具（video_generate）
Agent 现在可以直接调用视频生成服务，无需外部 API 集成：
配置示例：config.yaml
tools:
video_generate:
provider: "comfy" # 或 "runway", "pika"
default_params:
duration: 5
resolution: "1080p"
使用方式（Agent 技能定义）：
skills:
- name: "create_promo_video"
description: "为产品生成宣传视频"
tools: ["video_generate"]
prompt: |
根据用户描述的产品特点，生成 5 秒的产品展示视频。
要求：科技感风格，包含产品名称字幕。
2. 音乐生成工具（music_generate）
内置支持 Google Lyria 和 MiniMax，同时兼容 ComfyUI 工作流：
tools:
music_generate:
provider: "google" # "minimax" | "comfy"
google:
project_id: "your-gcp-project"
location: "us-central1"
# 可选提示：部分 provider 不支持 durationSeconds 等参数，
# OpenClaw 会自动忽略并发出警告，不会中断请求
异步任务追踪特性：
// Agent 调用后，音乐生成任务进入异步队列
const task = await agent.run("生成一段 30 秒的轻音乐，用于冥想应用");
// 任务状态可通过 message ID 查询
openclaw tasks status
// 输出：pending → processing → completed (音频 URL)
—
ComfyUI 深度集成：工作流即插件
安装与配置
启用 bundled 的 comfy 插件
openclaw plugins install comfy --bundled
连接本地 ComfyUI 或 Comfy Cloud
openclaw config set plugins.comfy.endpoint "http://localhost:8188"
openclaw config set plugins.comfy.api_key "your-api-key"
支持的媒体类型
• 功能：image_generate；工作流节点：标准文生图；说明：支持 prompt 注入
• 功能：video_generate；工作流节点：图生视频/文生视频；说明：可选参考图上传
• 功能：music_generate；工作流节点：音频生成工作流；说明：输出自动下载到存储
实时测试命令
测试 ComfyUI 连接并列出可用工作流
openclaw tools test comfy --list-workflows
执行指定工作流（调试模式）
openclaw tools test comfy --workflow "video_5s_anime" \
--prompt "赛博朋克城市夜景" \
--reference-image ./city.jpg
—
多语言支持：12 种语言本地化
控制面板（Control UI）新增完整本地化，覆盖主要技术市场：
• 语言：简体中文；代码：zh-CN；适用场景：中国大陆团队
• 语言：繁体中文；代码：zh-TW；适用场景：港澳台及海外华人团队
• 语言：日语；代码：ja；适用场景：日本企业客户
• 语言：韩语；代码：ko；适用场景：韩国市场部署
• 语言：德语；代码：de；适用场景：欧洲 DACH 地区
• 语言：西班牙语；代码：es；适用场景：拉美及西班牙
• 语言：法语；代码：fr；适用场景：法国及非洲法语区
• 语言：巴西葡萄牙语；代码：pt-BR；适用场景：巴西市场
• 语言：土耳其语；代码：tr；适用场景：土耳其及中东
• 语言：印尼语；代码：id；适用场景：东南亚市场
• 语言：波兰语；代码：pl；适用场景：东欧市场
• 语言：乌克兰语；代码：uk；适用场景：乌克兰及东欧
切换语言
命令行设置
openclaw config set ui.language "zh-CN"
或通过环境变量
export OPENCLAW_UI_LANGUAGE=zh-CN
—
新 Provider 与集成扩展
新增 AI 服务 Provider
providers:
# 阿里通义千问
qwen:
api_key: "${QWEN_API_KEY}"
model: "qwen-max"
# Fireworks AI（开源模型托管）
fireworks:
api_key: "${FIREWORKS_API_KEY}"
model: "accounts/fireworks/models/llama-v3p1-405b-instruct"
# 阶跃星辰 StepFun
stepfun:
api_key: "${STEPFUN_API_KEY}"
model: "step-1-128k"
Amazon Bedrock 增强
自动推理配置文件发现，简化多区域部署：
providers:
bedrock:
region: "us-east-1" # 自动注入到请求
mantle: true # 启用 Mantle 优化层
# 以下模型无需手动配置端点：
# - Claude 3/3.5/4
# - GPT-OSS
# - Qwen, Kimi, GLM 等
搜索与语音扩展
• 功能：网页搜索；Provider：Ollama Web Search；用途：本地搜索工作流
• 功能：搜索；Provider：MiniMax Search；用途：中文搜索优化
• 功能：语音合成；Provider：MiniMax TTS；用途：中文语音生成
—
执行审批流程：移动端与 Matrix 支持
iOS APNs 推送审批
channels:
ios:
exec_approval:
enabled: true
apns:
team_id: "YOUR_TEAM_ID"
key_id: "YOUR_KEY_ID"
private_key: "${APNS_KEY}"
安全特性：
- 推送仅打开审批模态，不泄露命令详情
- 详情在操作员重新认证后获取
- 审批完成后自动清除通知状态
Matrix 原生审批
channels:
matrix:
exec_approval:
enabled: true
approvers: "@admin:example.com,@ops:example.com" # 账户级审批人
delivery: "dm" # "dm" | "room" | "both"
thread_aware: true # 支持房间线程上下文
—
插件管理增强
强制重装插件
旧方式：需要 --dangerous-code 覆盖（不推荐）
openclaw plugins install my-plugin --dangerous-code
新方式：安全的强制重装
openclaw plugins install my-plugin --force
引导式配置（TUI）
安装插件时自动提示配置项：
$ openclaw plugins install telegram
? Telegram Bot Token: [输入或粘贴]
? 默认频道 ID: [输入]
? 是否启用执行审批? (y/N) y
✓ 配置已保存至 ~/.openclaw/plugins/telegram.yaml
—
频道上下文可见性控制
新增 contextVisibility 配置，精细控制对话历史的使用范围：
channels:
discord:
contextVisibility: "allowlist_quote" # 三种模式
telegram:
contextVisibility: "allowlist" # 仅允许列表内历史
slack:
contextVisibility: "all" # 完整上下文（默认）
• 模式：all；说明：使用所有可用上下文；适用场景：内部团队频道
• 模式：allowlist；说明：仅使用允许的历史来源；适用场景：客户支持场景
• 模式：allowlist_quote；说明：允许列表 + 当前引用消息；适用场景：混合安全需求
—
升级检查清单
1. 备份当前配置
cp ~/.openclaw/config.yaml ~/.openclaw/config.yaml.backup.$(date +%Y%m%d)
2. 升级到最新版本
npm install -g @openclaw/cli@2026.4.5
或
docker pull openclaw/openclaw:2026.4.5
3. 运行配置诊断
openclaw doctor --fix
4. 验证关键功能
openclaw tools test video_generate --dry-run
openclaw tools test music_generate --dry-run
5. 重启服务
openclaw server restart
—
常见问题（FAQ）
Q1: 升级后配置文件报错，如何回滚？
执行 openclaw doctor 查看具体问题。如需回滚，恢复备份配置后降级版本：
cp ~/.openclaw/config.yaml.backup.20250405 ~/.openclaw/config.yaml
npm install -g @openclaw/cli@2026.3.x
Q2: 视频生成功能需要额外付费吗？
OpenClaw 本身不收费，但视频生成依赖底层 Provider（如 ComfyUI、Runway）。ComfyUI 本地部署免费，云服务按 Provider 定价计费。
Q3: 多语言设置后部分界面仍显示英文？
部分第三方插件的界面文本可能未完全翻译。可通过 openclaw plugins list --i18n-status 检查各插件的本地化覆盖率。
Q4: 如何在同一 Agent 中同时使用视频和音乐生成？
skills:
- name: "multimedia_creator"
tools: ["video_generate", "music_generate"]
prompt: |
为用户创建完整的媒体内容：
1. 生成与主题匹配的背景音乐
2. 生成展示视频
3. 将两者合成为最终作品
Q5: Matrix 审批支持多房间吗？
支持。approvers 配置为账户级别（如 @user:server.com），该用户在任何房间中的审批权限均生效。delivery 选项控制审批通知的发送位置。
—
总结与下一步
OpenClaw 2026.4.5 的核心价值在于：
1. 配置现代化 — 清理技术债务，降低长期维护成本
2. 媒体生成原生支持 — Agent 能力边界扩展至视频/音乐领域
3. 全球化就绪 — 12 语言支持助力跨国团队部署
建议行动：
- [ ] 本周内运行
openclaw doctor评估配置状态 - [ ] 在测试环境验证视频/音乐生成工作流
- [ ] 为非英语团队成员启用本地化界面
—
相关阅读
—
参考来源
• 来源：GitHub Release v2026.4.5；链接：https://github.com/openclaw/openclaw/releases/tag/v2026.4.5
• 来源：OpenClaw 官方文档；链接：https://docs.openclaw.io
• 来源：ComfyUI 官方文档；链接：https://docs.comfy.org| Google Lyria 技术文档 | https://deepmind.google/technologies/lyria/ |
