——
OpenClaw 2026.4.23-beta.6 发布：7大新功能解析与实战配置指南
OpenClaw 最新 beta 版本带来了多项关键更新，让 AI Agent 的图像生成能力更灵活、本地部署更轻量、多平台集成更稳定。本文将逐一解析 7 大核心变化，并提供可直接复制的配置方案。
—
核心亮点速览
本次更新聚焦三大方向：图像生成零门槛化（免 API Key 调用 GPT-Image-2）、本地部署可配置化（嵌入上下文大小可调）、企业级稳定性增强（Agent 超时控制、Windows 兼容修复）。无论你是个人开发者还是团队部署，都能找到实用改进。
—
一、GPT-Image-2 免 API Key 调用：Codex OAuth 集成
功能说明
通过 Codex OAuth 认证，现在可以直接调用 openai/gpt-image-2 进行图像生成和参考图编辑，无需配置 OPENAI_API_KEY。
配置方法
在 claw.config.yaml 中启用 Codex 提供方：
providers:
openai:
type: codex
# 无需 apiKey 字段，通过 OAuth 自动获取令牌
model: openai/gpt-image-2
tools:
image_generate:
enabled: true
# 可选：指定图像质量与格式
quality: high # 可选: standard, high
output_format: png # 可选: png, jpeg, webp
适用场景
- 企业环境：避免 API Key 硬编码，通过 OAuth 统一鉴权
- 快速原型：新用户无需申请 OpenAI API 即可体验图像功能
> 修复 Issue: #70703
—
二、OpenRouter 图像生成支持
功能说明
OpenRouter 现支持 image_generate 工具，所有图像模型均可通过 OPENROUTER_API_KEY 调用。
配置对比
| 提供方 | 认证方式 | 支持模型 |
|——–|———|———|
| OpenAI (Codex) | OAuth | openai/gpt-image-2 |
| OpenRouter | API Key | 所有 OpenRouter 图像模型 |
providers:
openrouter:
apiKey: ${OPENROUTER_API_KEY}
# 自动启用 image_generate 能力
> 修复 Issue: #55066 via #67668，感谢 @notamicrodose
—
三、图像生成参数精细化控制
新增参数
Agent 现在可通过 image_generate 工具传递 OpenAI 专属参数：
| 参数 | 类型 | 说明 |
|——|——|——|
| quality | string | 图像质量：standard 或 high |
| output_format | string | 输出格式：png, jpeg, webp |
| background | string | 背景处理（透明/填充） |
| moderation | string | 内容审核级别 |
| compression | number | 压缩质量 0-100 |
| user | string | 用户标识（用于追踪） |
使用示例
// 在 Agent 工具调用中
const result = await tools.image_generate({
prompt: " futuristic cityscape at sunset",
quality: "high",
output_format: "png",
background: "transparent",
compression: 95
});
> PR: #70503，感谢 @ottodeng
—
四、Agent 超时控制：按需延长生成任务
问题背景
图像、视频、音乐、TTS 等生成任务耗时差异大，固定超时导致长任务失败。
解决方案
新增 按调用超时 timeoutMs 参数：
tools:
image_generate:
defaultTimeoutMs: 30000 # 默认 30 秒
video_generate:
defaultTimeoutMs: 120000 # 默认 2 分钟
在 Agent 调用时动态覆盖：
// 长视频生成任务延长至 5 分钟
await tools.video_generate({
prompt: "cinematic drone footage of mountains",
timeoutMs: 300000 // 覆盖默认超时
});
—
五、本地嵌入上下文大小可调
功能说明
memorySearch.local.contextSize 现可配置，默认 4096 tokens，适配资源受限主机。
配置示例
memory:
search:
local:
contextSize: 2048 # 降低至 2048，减少内存占用
# 或提升至 8192，提高检索精度
性能对比
| contextSize | 内存占用 | 适用场景 |
|————-|———|———|
| 2048 | ~500MB | 边缘设备、Docker 容器 |
| 4096（默认） | ~1GB | 标准开发环境 |
| 8192 | ~2GB | 高精度检索需求 |
> 修复 Issue: #70544，感谢 @aalekh-sarvam
—
六、Agent 会话：可选分叉上下文
功能说明
sessions_spawn 原生运行现支持 可选分叉上下文，子 Agent 可继承父会话的完整对话历史。
默认行为 vs 分叉模式
agents:
myAgent:
# 默认：干净隔离会话（推荐用于生产）
sessions_spawn:
forkContext: false
# 需要上下文继承时启用
# forkContext: true
使用场景
| 模式 | 适用情况 |
|——|———|
| forkContext: false（默认） | 独立任务、安全隔离、避免上下文污染 |
| forkContext: true | 多轮协作、需要历史记忆、复杂工作流 |
—
七、关键 Bug 修复与稳定性提升
| 修复项 | 影响范围 | 说明 |
|——–|———|——|
| Codex 用户输入路由 | 所有 Codex 用户 | 原生 request_user_input 正确返回发起对话 |
| Windows npm 安装兼容 | Windows 开发者 | 自动解析 codex.cmd shim，无需手动 .exe |
| Slack 群组消息优化 | Slack 集成用户 | MPIM 群组 DM 正确分类，隐藏内部进度痕迹 |
| WhatsApp 首次启动 | QuickStart 用户 | 运行时依赖分离，安装向导提前可用 |
| 流式传输去重 | 所有流式响应场景 | 避免分块传输后的重复回复 |
> Windows 修复: #70913
> Slack 修复: #70912
> WhatsApp 修复: #70932
—
快速升级指南
通过 npm 升级
npm install -g @openclaw/cli@2026.4.23-beta.6
或通过 Docker
docker pull openclaw/openclaw:2026.4.23-beta.6
验证版本
claw --version
输出: 2026.4.23-beta.6
—
常见问题 FAQ
Q1: 没有 OpenAI API Key，如何启用 GPT-Image-2？
配置 Codex OAuth 提供方即可。在 claw.config.yaml 中删除 apiKey 字段，系统会自动通过 OAuth 流程获取令牌。首次使用时会弹出浏览器授权窗口。
Q2: memorySearch.local.contextSize 应该设置多大？
取决于你的硬件资源：
- 4GB 内存以下：建议 2048
- 8GB 内存标准环境：保持默认 4096
- 16GB 以上 + 高精度需求：可尝试 8192
修改后需重启 Memory Host 服务生效。
Q3: Agent 超时设置是否影响所有工具？
仅影响 生成类工具（image_generate、video_generate、music_generate、tts_generate）。文本对话、搜索等工具保持原有超时策略。
Q4: Windows 上 Codex 模型仍无法启动？
确保：
1. 通过 npm install -g @openclaw/codex 安装
2. 命令行能直接执行 codex --version
3. 若使用 nvm，检查全局路径包含 npm 目录
Q5: 如何查看 Codex 自动选择日志？
启用结构化调试日志后，查看 Gateway 日志：
claw logs gateway --level debug | grep "harness_selection"
—
总结与下一步
OpenClaw 2026.4.23-beta.6 的核心价值在于降低图像生成门槛（OAuth 免 Key）、提升本地部署灵活性（可配置嵌入上下文）、增强生产稳定性（精细化超时与多平台修复）。
推荐行动：
1. 立即升级 并测试 GPT-Image-2 的 Codex 集成
2. 根据硬件资源调整 memorySearch.local.contextSize
3. 为长耗时生成任务配置 timeoutMs 参数
—
相关阅读
- OpenClaw 官方文档 — 完整配置参考
- Codex OAuth 设置指南 — 企业级鉴权配置
- Memory Host 性能调优 — 深入理解嵌入参数
- Agent 工具开发手册 — 自定义工具超时控制
—
参考来源
