——

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 调用。

配置对比

providers:
  openrouter:
    apiKey: ${OPENROUTER_API_KEY}
    # 自动启用 image_generate 能力

> 修复 Issue: #55066 via #67668，感谢 @notamicrodose

—

三、图像生成参数精细化控制

新增参数

Agent 现在可通过 image_generate 工具传递 OpenAI 专属参数：

使用示例

// 在 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

使用场景

—

七、关键 Bug 修复与稳定性提升

> 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教学小站

OpenClaw 2026.4.23-beta.6 发布：7大新功能解析与实战配置指南

OpenClaw 2026.4.23-beta.6 发布：7大新功能解析与实战配置指南

核心亮点速览

一、GPT-Image-2 免 API Key 调用：Codex OAuth 集成

功能说明

配置方法

适用场景

二、OpenRouter 图像生成支持

功能说明

配置对比

三、图像生成参数精细化控制

新增参数

使用示例

四、Agent 超时控制：按需延长生成任务

问题背景

解决方案

五、本地嵌入上下文大小可调

功能说明

配置示例

性能对比

六、Agent 会话：可选分叉上下文

功能说明

默认行为 vs 分叉模式

使用场景

七、关键 Bug 修复与稳定性提升

快速升级指南

通过 npm 升级

或通过 Docker

验证版本

输出: 2026.4.23-beta.6

常见问题 FAQ

Q1: 没有 OpenAI API Key，如何启用 GPT-Image-2？

Q2: `memorySearch.local.contextSize` 应该设置多大？

Q3: Agent 超时设置是否影响所有工具？

Q4: Windows 上 Codex 模型仍无法启动？

Q5: 如何查看 Codex 自动选择日志？

总结与下一步

相关阅读

参考来源

OpenClaw 2026.4.23-beta.6 发布：7大新功能解析与实战配置指南

核心亮点速览

一、GPT-Image-2 免 API Key 调用：Codex OAuth 集成

功能说明

配置方法

适用场景

二、OpenRouter 图像生成支持

功能说明

配置对比

三、图像生成参数精细化控制

新增参数

使用示例

四、Agent 超时控制：按需延长生成任务

问题背景

解决方案

五、本地嵌入上下文大小可调

功能说明

配置示例

性能对比

六、Agent 会话：可选分叉上下文

功能说明

默认行为 vs 分叉模式

使用场景

七、关键 Bug 修复与稳定性提升

快速升级指南

通过 npm 升级

或通过 Docker

验证版本

输出: 2026.4.23-beta.6

常见问题 FAQ

Q1: 没有 OpenAI API Key，如何启用 GPT-Image-2？

Q2: memorySearch.local.contextSize 应该设置多大？

Q3: Agent 超时设置是否影响所有工具？

Q4: Windows 上 Codex 模型仍无法启动？

Q5: 如何查看 Codex 自动选择日志？

总结与下一步

相关阅读

参考来源

Q2: `memorySearch.local.contextSize` 应该设置多大？