一句话总结
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 | 本地搜索工作流 |
| 搜索 | MiniMax Search | 中文搜索优化 |
| 语音合成 | 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/ |
